AuthorizationstringheaderRequired Bearer API key for programmatic World access.
Example: Bearer nos_sk_...
Get Events in Trend
Page through the event evidence behind one recent Event Trend bucket.
Parameters
query & pathidstringrequiredpathTrend result ID returned by Event Trend.
Example: tr_4a45c76c941f482e
bucketdaterequiredqueryBucket start date returned by Event Trend.
Example: 2026-06-01
groupstringqueryOptional group value to inspect.
Example: negative
limitintegerqueryPage size, up to 200.
Example: 50
cursorstringqueryOpaque next-page cursor.
Example: AAAAAAAAADI
How to use this endpoint
guidanceUse this route immediately after Event Trend to inspect evidence for a bucket or one group. The handle is short-lived; restart the trend request if it expires.
Response body
application/jsonThese are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.
totalintegerEvents in the bucket (and group).
countintegerEvents in this page.
limitintegerPage size applied: 50 unless limit is sent.
eventsobject[]The events in the list format: the V2.0-preview record without its evidence and embedding (provenance, triples, availability, each ticker's why and oai_vector). Fetch Event details for those. Most similar first.
events[].event_idstringStable event identifier.
events[].versionstringEvent record version: "2.0-preview".
events[].eventobjectThe event in its original language: date, language, title, description and points.
events[].event.datedateWorld archive date of the event.
events[].event.languagestringISO 639-1 code of the event's original language.
events[].event.titlestringHeadline, in the original language.
events[].event.descriptionstringShort narrative, in the original language.
events[].event.pointsstring[]Key facts of the event, one sentence each.
events[].englishobjectThe event in English: title, description and points, as in Event details.
events[].coverageobjecttotal_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details.
events[].locationsobject[]Places of the event, its own place first, then places named in it, as in Event details.
events[].signalsobjectSentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details.
events[].tickersobject[]Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false.
events[].has_tickersbooleanWhether tickers is non-empty.
events[].entitiesobjectNamed entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details.
events[].ontologiesobject[]Classifications of the event, most probable first, as in Event details.
events[]._scorenumberSimilarity to the trend's query.
events[]._semantic_scorenumberThe same similarity.
events[]._search_datedateArchive date of the event.
events[]._retrievalstringevent_trend.
next_cursorstring | nullOpaque cursor for the next page; null at the end.
Responses and errors
HTTP200Request succeeded. The response body is shown in the panel on the right.
400
invalid_request — The date, filter, cursor, identifier, or request combination is invalid.401
api_key_required — No API key was sent. Send it as Authorization: Bearer <key> or the api-key header.401
invalid_api_key — The API key is invalid or has been revoked.403
access_denied — The requested archive date is outside the caller's World tier.404
not_found — The requested date, entity, ticker, or event does not exist in the accessible index.410
cursor_expired — The cursor was minted against a replaced index build. Restart pagination from the first page.429
rate_limited — The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.501
backend_not_configured — The World backend is not configured for this deployment.503
api_key_auth_unavailable — API key authentication is temporarily unavailable; retry shortly.502
backend_error — The BFF could not obtain a valid response from the World backend.504
backend_timeout — The World backend or an upstream data source timed out.