For all time

Search the dated event archive with metadata, lexical, semantic, or hybrid retrieval.

POST/api/v2.0-preview/search

Authorizations

Bearer

Authorizationstringheader

Required Bearer API key. Programmatic access to the World API needs a key; browsing nosible.world in a browser does not.

Example: Bearer nos_sk_...

Body

application/json

search_typeenumbody

metadata, lexical, semantic, or hybrid.

Example: hybrid

qstringbody

Text query. Used for lexical, semantic, and hybrid retrieval.

Example: oil supply disruption

dateobjectbody

Optional inclusive from/to window; include_live opts into newest slices. Set from explicitly for reproducible public-window queries.

Example: {"from":"2026-07-01","to":"2026-07-20","include_live":true}

filtersobjectbody

Filter DSL over entities, tickers, taxonomies, signals, and geography.

Example: {"gics_sector":"Energy"}

limitintegerbody

Number of events to return.

Example: 20

offsetintegerbody

Number of matching events to skip before returning the page.

Example: 0

vectornumber[]body

Caller-supplied embedding for semantic retrieval. Its length must match the configured HNSW dimension.

Example: [0.012, -0.004, ...]

query_vectornumber[]body

Alias for vector.

Example: [0.012, -0.004, ...]

sortobject[]body

Sort rules such as [{ by: 'total_coverage', desc: true }].

Example: [{"by":"total_coverage","desc":true}]

facetsstring[]body

Field names for which to return facet counts.

Example: ["country","sentiment"]

embedding_modelenumbody

Embedding model for semantic or hybrid retrieval. The supported value is openai.

Example: openai

semantic_filter_modeenumbody

Semantic filter strategy: auto, usearch, or exact.

Example: auto

max_datesintegerbody

Maximum archive dates the planner may visit.

Example: 30

explainbooleanbody

Include retrieval planning details where supported.

Example: false

querystringbody

Alias for q. Use one name consistently in a client; q is the canonical short form.

Example: oil supply disruption

includestring[]body

Projection controls such as event_lite, event_full, or explain. Use event_lite to keep payloads compact.

Example: ["event_lite"]

exact_vector_max_candidatesintegerbody

Maximum metadata-qualified candidates to score exactly when semantic_filter_mode is exact.

Example: 100000

semantic_candidatesintegerbody

Candidate budget for approximate semantic retrieval before hydration and reranking.

Example: 500

How to use this endpoint

guidance

Use global World Search when the question spans dates and you need metadata, lexical, semantic, or hybrid retrieval over event records. Keep the date window explicit in production so results are reproducible.

Response body

application/json

These are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.

schemastring

Response schema name.

totalinteger

Matching events. For semantic and hybrid search this counts the candidates retrieved, at most 100 times limit, not every match in the archive.

countinteger

Events in this page.

limitinteger

Page size applied.

offsetinteger

Events skipped.

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.

events[].event_idstring

Stable event identifier.

events[].versionstring

Event record version: "2.0-preview".

events[].eventobject

The event in its original language: date, language, title, description and points.

events[].event.datedate

World archive date of the event.

events[].event.languagestring

ISO 639-1 code of the event's original language.

events[].event.titlestring

Headline, in the original language.

events[].event.descriptionstring

Short narrative, in the original language.

events[].event.pointsstring[]

Key facts of the event, one sentence each.

events[].englishobject

The event in English: title, description and points, as in Event details.

events[].coverageobject

total_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[].signalsobject

Sentiment, 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_tickersboolean

Whether tickers is non-empty.

events[].entitiesobject

Named 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[]._scorenumber

Overall retrieval score.

events[]._lexical_scorenumber

Lexical component of the score (lexical and hybrid search).

events[]._semantic_scorenumber

Semantic component of the score (semantic and hybrid search).

events[]._retrievalstring

Retrieval path that found the event.

events[]._search_datedate

Archive date the record was read from.

facetsobject

Counts for the fields requested in facets; empty when none were requested.

query_took_msinteger

Total time in milliseconds.

embedding_msinteger

Time spent embedding the query.

search_msinteger

Time spent searching.

date_windowobject

from, to, include_live and archive_cutoff of the search.

search_typestring

Retrieval mode used.

errorsobject[]

Non-fatal stage errors; empty when none.

Responses and errors

HTTP

200Request succeeded. The response body is shown in the panel on the right.

400invalid_request — The date, filter, cursor, identifier, or request combination is invalid.

401api_key_required — No API key was sent. Send it as Authorization: Bearer <key> or the api-key header.

401invalid_api_key — The API key is invalid or has been revoked.

403access_denied — The requested archive date is outside the caller's World tier.

404not_found — The requested date, entity, ticker, or event does not exist in the accessible index.

410cursor_expired — The cursor was minted against a replaced index build. Restart pagination from the first page.

429rate_limited — The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.

501backend_not_configured — The World backend is not configured for this deployment.

503api_key_auth_unavailable — API key authentication is temporarily unavailable; retry shortly.

502backend_error — The BFF could not obtain a valid response from the World backend.

504backend_timeout — The World backend or an upstream data source timed out.