Skip to content
unzoi docs

GET /doc/{id}

GET https://api.unzoi.com/doc/{id}

One article's full metadata.

Names, structured locations and dates, quotations, amounts, related media, links and alternate URLs. Equivalent to the `get_article` MCP tool.

  • id — Path parameter.

Search responses carry a bounded subset of an article's metadata, so a page of results stays a reasonable size even when one article contains fifty quotations. This endpoint returns everything.

The id is whatever a search result gave you. It begins with the article's collection timestamp (YYYYMMDDHHMMSS), which is how the sharded index routes a lookup to exactly one shard — so this is a cheap request regardless of how large the archive is.

Response

Everything an Article carries, plus:

Field Type Description
authors string[]
collected_at string
countries string[]
id string
image string
language string
locations string[]
organizations string[]
persons string[]
published_at string 14-digit YYYYMMDDHHMMSS.
publisher_country string
signals Signals
source string
source_type string
story_id string Pass back as the `story_id` filter to expand this story.
title string
tone number
topics string[]
url string
word_count integer
amounts object[]
amp_url string
date_mentions object[]
links string[]
location_details object[]
mobile_url string
names string[]
quotes object[]
related_images string[]
social_videos string[]

What the extra fields are for

  • quotes — extracted quotations with the verb that introduced them. Useful for "who said what" without fetching and parsing the article yourself, and filterable in search via quote_verb.
  • location_details — the same locations as the search response, but structured: kind (country, region, city), coordinates, and a canonical identifier you can filter on with location_id.
  • date_mentions — dates mentioned in the text, with precision. Distinct from published_at: an article published today can be about a date next year.
  • amounts — numeric amounts with the object they describe ("20000 combat soldiers"). Filterable via amount_object.
  • amp_url, mobile_url, links — alternate and outbound URLs, for a fetcher that needs a lighter page or wants to follow the article's own citations.

Example

curl -s "https://api.unzoi.com/doc/20260826073000-a1b2c3" -H "x-api-key: $UNZOI_KEY"

An id that does not exist returns 404. Article bodies are never returned by any endpoint — the index holds metadata and derived signals, and url is where the text lives.