04 / API

API documentation

From your first key and API call to change streams and MCP.

Getting started

Create an account by email and confirm your email address.
Issue a new key in My account. The new key is shown only once immediately after issue, so store it securely.
Run the command below to list sources. Preserve the attribution in the response.

First request

curl 'https://api.ntriq.co.kr/std/v1/sources' \
  -H "X-YAP-Key: $NTRIQ_API_KEY"

When calling from code, set a User-Agent header yourself with Python's standard urllib (for example your-app/1.0). Without it the request is blocked with a 403. requests, httpx and curl work as they are.

Public and authenticated APIs

Gateway routes verified in OpenAPI are shown alongside concrete calls from the integration contract. Individual standard API paths are not separately defined in the current gateway OpenAPI.

OpenAPI route	Call from integration contract	Access
`/public/{path}`	`GET /public/v1/catalog · GET /public/v1/stats`	No key · metadata and counts
`/std/{path}`	`GET /std/v1/sources · GET /std/v1/sources/{slug} · GET /std/v1/health`	Key required · L0 trial available
`/std/{path}`	`GET /std/v1/changes`	Key required · trial responses up to 20 records
`/std/{path}`	`GET /std/v1/things · GET /std/v1/things/{id}`	Key required · paid L1 and above
`/mcp`	`POST /mcp`	Bearer key · tool-specific tiers
`/lawink/{path}`	`POST /lawink/api/v1/citations/verify`	Key required · paid citation verification

Authentication

Customer APIs accept X-YAP-Key or Authorization: Bearer. Do not use X-API-Key. Route authenticated browser requests through your server. The public catalog and specifications need no key.

What a plan buys

L0 Standardised source: The public source as published, with schema, encoding and date formats aligned.
L1 Normalised and joined: Duplicates removed, addresses and legal entities joined, agency codes unified, history linked.
L2 Verdicts and summaries: Classification, scores and summaries, handed over together with the grounds for them.
L3 Dedicated pipeline: Refinement shaped to your schema, with your own fields and your own refresh cycle.

See the limits per plan

Response attribution

Display meta.attribution from data responses unchanged in your interface. Check each source’s attribution_text and license terms.

Change streams and cursors

Set since to an ISO 8601 timestamp. URL-encode next_cursor from the response as cursor for the next page, keeping since and filters unchanged. Stop when next_cursor is absent or results are empty. Trial keys allow a maximum limit of 20.

Change streams and cursors

curl 'https://api.ntriq.co.kr/std/v1/changes?since=2026-09-01T00%3A00%3A00Z&limit=5' \
  -H "Authorization: Bearer $NTRIQ_API_KEY"

Connect with MCPIn preparation

This is still in preparation. We will announce the release date in these docs.

Configure the /mcp URL and Bearer key in a Streamable HTTP client. Start with initialize. Trials support L0 tools and public source search.

14 MCP tools

Six standard tools and eight source-research tools, checked against the gateway registry. Source-research calls also require a key.

Tool	Purpose	Access
`list_sources`	Source list	Key required · L0 trial available
`get_source`	Source details	Key required · L0 trial available
`std_health`	Standard-layer collection status	Key required · L0 trial available
`get_changes`	Change stream	Key required · trial responses up to 20 records
`search_things`	Standard record search	Key required · paid L1 and above
`get_thing`	Single standard record	Key required · paid L1 and above
`wikipedia_search`	Wikipedia	Source research · trial key accepted
`pubmed_search`	PubMed	Source research · trial key accepted
`semantic_scholar_search`	Semantic Scholar	Source research · trial key accepted
`gdelt_search`	GDELT	Source research · trial key accepted
`hackernews_search`	Hacker News	Source research · trial key accepted
`npm_package`	npm	Source research · trial key accepted
`pypi_package`	PyPI	Source research · trial key accepted
`crt_sh`	crt.sh	Source research · trial key accepted

MCP initialize request

curl 'https://api.ntriq.co.kr/mcp' \
  -H "Authorization: Bearer $NTRIQ_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"ntriq-example","version":"1.0.0"}}}'

Send notifications/initialized after the initialization response. If the server returns Mcp-Session-Id, retain it in subsequent request headers along with the negotiated MCP-Protocol-Version.

Interactive API reference OpenAPI specification llms.txt

API playground

Explore the catalog without a key, or use a customer key to query sources and recent changes.

Request

Start with the source catalog. No key required.

JSON response

Inspect your first response

Run a request to see its response here. Inspect the fields and attribution.

Legal citation verification

A paid API for checking legal citations in documents, served through the /lawink/api/v1/citations/verify gateway route. Confirm the input format and service scope during onboarding. Full verdicts and custom fields are excluded from public samples.