Look up one news article

View as Markdown

Resolves news detail by slug, external ID, URL, or bounded title candidate signals. Use the numeric item route for an id; any id query is rejected. Canonical redirects are preserved.

Authentication

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Query parameters

slugstringOptionalformat: "^[a-z0-9_-]+$"<=255 characters

Exact news article slug (URL-friendly identifier). Mutually exclusive with id, externalId, url, and title.

externalIdstringOptional

External ID or RSS GUID for ingestion-key lookup. Mutually exclusive with id, slug, url, and title.

urlstringOptional

Original article URL to resolve via strict host+path or domain-only match. Mutually exclusive with id, slug, and externalId. May pair with title and publication to narrow candidate recovery after an exact URL miss. Pair with urlMatchMode to disambiguate.

titlestringOptional

Candidate lookup signal: article title. Mutually exclusive with id, slug, and externalId. Combine with publication, urlDomain, or url for bounded candidate search.

publicationstringOptional

Publication qualifier (e.g., ‘TechCrunch’, ‘Forbes’). Narrows a title candidate search. Not an identifier on its own.

urlDomainstringOptional

Candidate lookup URL domain qualifier (host only, no path). Narrows a title candidate search. Not an identifier on its own.

urlMatchModestringOptional

URL match mode qualifier: ‘hostPath’ (strict host + path match, default) or ‘domain’ (host-only match). Narrows url and urlDomain matching. Not an identifier on its own.

Response

OK
coreobject
Canonical news owner for list and core semantics
entityMentionResolvedlist of objects

Resolved entity mentions — read-only display projections. News mutations attach entities only via flat entityJoinId values, never these nested objects.

personMentionResolvedlist of objects

Resolved person mentions — read-only display projections. News mutations attach people only via flat personId/personSlug values, never these nested objects.

contentstring or nullOptional
externalIdstring or nullOptional
linkedContentstring or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error