AuthorizationstringrequiredheaderRequired Bearer API key. Programmatic access to the World API needs a key; browsing nosible.world in a browser does not.
Example: Bearer nos_sk_...
For a date range
Retrieve bounded semantic results grouped by date, with an optional live overlay for the newest slices.
Explanation
Use this endpoint when a semantic definition must be evaluated independently across dates. Request the factor projection and set date.include_live=true when the newest active slices should be included.
Request
Response
Response body
application/jsonThese are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.
schemastringStable grouped semantic search response contract identifier.
Example: nosible_world_factor_search_v1
group_bystringGrouping dimension; currently date.
Example: date
eventsobject[]Flat matched event rows; join them to groups by date.
Example: [{ date, event_id, score, vector_scores, sentiment }]
groupsobject[]One summary per scanned date, including matches, candidates, truncation, and eligible denominators.
Example: [{ date, matched_count, candidate_count, truncated, eligible }]
date_windowobjectRequested window, live-slice decision, and archive cutoff.
Example: { "from": "2026-09-15", "to": "2026-09-17", "include_live": true, "archive_cutoff": "2026-09-15" }
statsobjectAggregate date, candidate, match, and truncation counters.
Example: { "dates_requested": 3, "dates_scanned": 3, "matched_events": 412, "truncated": true }
Responses and errors
HTTP200Request succeeded. The body is shown in the response example.
400
invalid_request — The grouped request is invalid or omits required date, vector, or projection fields.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.422
validation_error — A body field has the wrong type or form, such as a limit sent as a string; the message names it.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.503
api_key_metering_unavailable — API key usage metering is temporarily unavailable, so the request was not served; wait for the Retry-After header (30 seconds) and retry.502
backend_error — The World backend could not be reached or did not return a valid response; retry shortly.504
backend_timeout — The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.422
grouped_response_too_large — The request exceeds the bounded grouped response budget; shorten the window or raise the score floor.422
archive_date_gap — The window includes days the archive has no data for; the message names them and the days either side. Missing days are never shown as zero activity: choose a window that avoids them.503
grouped_search_busy — The grouped-search worker pool is full; retry after backoff.