aVenture APINews

Get news detail

View as Markdown
Returns full news article detail by id, slug, externalId, strict URL, or bounded title candidate signals. Ambiguous candidate signals return 409 ProblemDetail.details.newsCandidate; review those ids, update the matching article, and create only when all candidates are distinct and source evidence supports the target. score/threshold are review ranking, not absence proof. Handles canonical redirects for changed slugs.

Authentication

X-Client-Secretstring

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

Query parameters

idintegerOptional
Exact news article id. Mutually exclusive with slug, externalId, url, and title.
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

News detail as canonical JSON, or the same data rendered as compact text/plain.

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
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error