Look Up One News Article
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
Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token
Query parameters
Exact news article slug (URL-friendly identifier). Mutually exclusive with id, externalId, url, and title.
External ID or RSS GUID for ingestion-key lookup. Mutually exclusive with id, slug, url, and title.
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.
Candidate lookup signal: article title. Mutually exclusive with id, slug, and externalId. Combine with publication, urlDomain, or url for bounded candidate search.
Publication qualifier (e.g., ‘TechCrunch’, ‘Forbes’). Narrows a title candidate search. Not an identifier on its own.
Candidate lookup URL domain qualifier (host only, no path). Narrows a title candidate search. Not an identifier on its own.
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 headers
Requests allowed per client IP in the current rate-limit window.
Requests left before the tightest applicable rate-limit bucket rejects.
Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.
Response
Resolved entity mentions — read-only display projections. News mutations attach entities only via flat entityJoinId values, never these nested objects.
Resolved person mentions — read-only display projections. News mutations attach people only via flat personId/personSlug values, never these nested objects.