{ "openapi": "3.0.3", "info": { "title": "NOSIBLE World V2.0 API", "version": "2.0", "description": "Public World V2.0 API contract. Examples illustrate responses and do not require optional fields to be present. Existing API URLs remain supported." }, "servers": [ { "url": "https://nosible.world" } ], "externalDocs": { "url": "https://docs.nosible.com/" }, "paths": { "/api/v2.0/events/{date}": { "get": { "operationId": "v2_0_world_events", "summary": "By day", "description": "List the events in a dated World archive slice with sorting and pagination.\n\nUse Events for a date-scoped snapshot when you want deterministic ordering and pagination rather than relevance ranking.", "tags": [ "EVENT LISTS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-events" }, "x-nosible-reference-pages": [ "v2.0-world-events" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "schema": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" } }, { "name": "include_vector", "in": "query", "required": false, "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "schema": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false } }, { "name": "date", "in": "path", "required": true, "description": "Archive date in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Archive date in YYYY-MM-DD format.", "example": "2026-07-20" } }, { "name": "limit", "in": "query", "required": false, "description": "Page size.", "schema": { "type": "integer", "description": "Page size.", "example": 100 } }, { "name": "sort_by", "in": "query", "required": false, "description": "total_coverage, total_netlocs, or event_id.", "schema": { "type": "string", "description": "total_coverage, total_netlocs, or event_id.", "example": "total_coverage" } }, { "name": "desc", "in": "query", "required": false, "description": "Sort descending when true.", "schema": { "type": "boolean", "description": "Sort descending when true.", "example": true } }, { "name": "offset", "in": "query", "required": false, "description": "Number of events to skip.", "schema": { "type": "integer", "description": "Number of events to skip.", "example": 0 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "total": { "type": "integer", "description": "Events on the date before paging." }, "count": { "type": "integer", "description": "Events in this page." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." } } }, "description": "The events, as lite records unless view=full (About records on Event details lists both). A full record adds provenance, availability, triples, each ticker's why and v2_preview_success." }, "limit": { "type": "integer", "description": "Page size applied: 200 unless limit is sent." }, "offset": { "type": "integer", "description": "Events skipped." }, "sort_by": { "type": "string", "description": "Sort key applied." }, "desc": { "type": "boolean", "description": "Whether the sort is descending." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." } }, "additionalProperties": true }, "example": { "view": "lite", "total": 12236, "count": 200, "events": [ { "event_id": "2026-07-20_en_IN_v1_MJAIGCFp2ss1QAAAAAAAAOdRRENgAAAAAAAAAAAAAAA_pks2XhWt", "version": "2.0-preview", "event": { "date": "2026-07-20", "language": "en", "title": "Youth-Led Cockroach Party Protesters Storm Indian Parliament Amid Police Crackdown", "description": "Over 10,000 supporters of the Cockroach Janta Party stormed India's Parliament in New Delhi, marking a major challenge to Prime Minister Narendra Modi. Police responded with tear gas and baton charges against the youth-led...", "points": [ "Over 10,000 Cockroach Janta Party supporters stormed India's Parliament in New Delhi." ] }, "english": { "date": "2026-07-20", "language": "en", "title": "Youth-Led Cockroach Party Protesters Storm Indian Parliament Amid Police Crackdown", "description": "Over 10,000 supporters of the Cockroach Janta Party stormed India's Parliament in New Delhi, marking a major challenge to Prime Minister Narendra Modi. Police responded with tear gas and baton charges against the youth-led...", "points": [ "Over 10,000 Cockroach Janta Party supporters stormed India's Parliament in New Delhi." ] }, "coverage": { "total_coverage": 4460, "total_netlocs": 3461, "coverage_concentration_index": 0.006438, "first_seen": "2026-07-19T16:37:06+00:00", "last_seen": "2026-07-21T00:26:18+00:00", "most_seen": "2026-07-20T02:28:51+00:00" }, "locations": [ { "continent": "Asia", "region": "South Asia", "country": "India", "lat": 28.6139, "lng": 77.209, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "New Delhi", "entity_type": "GPE", "lat": 28.62137, "lng": 77.2148, "region": "Delhi", "country": "India", "continent": "Asia", "source": "ner" } ], "signals": { "sentiment": "neutral", "sentiment_prob_positive": 0.0005, "sentiment_prob_neutral": 0.7978, "sentiment_prob_negative": 0.2017, "materiality": "medium", "materiality_score": 0.497425, "time_horizon": "intraday", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.0028, "forward_looking_prob_not_forward": 0.9972 }, "tickers": [], "has_tickers": false, "entities": { "PERSON": [ { "name": "Narendra Modi", "mention_count": 2, "confidence": 1 } ], "ORG": [ { "name": "Cockroach Janta Party", "mention_count": 3, "confidence": 0.9648 } ], "GPE": [ { "name": "New Delhi", "mention_count": 2, "confidence": 1 } ] }, "sentiments": { "GPE": [ { "name": "New Delhi", "sentiment_label": "negative", "sentiment_score": -1.2537509199529402 } ], "ORG": [ { "name": "Cockroach Janta Party", "sentiment_label": "neutral", "sentiment_score": -0.7694625113401098 } ], "PERSON": [ { "name": "Narendra Modi", "sentiment_label": "neutral", "sentiment_score": -0.5141746083025903 } ] }, "ontologies": [ { "ontology": "media_frame", "label": "Conflict", "probability": 0.9996 }, { "ontology": "ekman7_emotion", "label": "anger", "probability": 0.9974 } ] }, { "event_id": "2026-07-20_it_US_v1_nIBB4jmKtQpFAAAAAAAAJgAAAAAAAAAAAAAAAAAAAAA_uWyxQPkn", "version": "2.0-preview", "event": { "date": "2026-07-20", "language": "it", "title": "Trump consegna la Coppa del Mondo alla Spagna nonostante le tensioni diplomatiche", "description": "Donald Trump ha presenziato alla cerimonia di premiazione della Coppa del Mondo allo stadio New York/New Jersey, consegnando il trofeo alla nazionale spagnola. L'evento ha visto la partecipazione delle principesse Leonor e Sofia....", "points": [ "Donald Trump ha consegnato la Coppa del Mondo alla nazionale spagnola, segnando un momento di distensione istituzionale." ] }, "english": { "date": "2026-07-20", "language": "it", "title": "Trump Presents World Cup Trophy to Spain Despite Diplomatic Tensions", "description": "Donald Trump attended the World Cup trophy presentation ceremony at the New York/New Jersey stadium, handing the trophy to the Spanish national team. The event was attended by Princesses Leonor and Sofia. Despite previous political...", "points": [ "Donald Trump presented the World Cup trophy to the Spanish national team, marking a moment of institutional détente." ] }, "coverage": { "total_coverage": 2091, "total_netlocs": 831, "coverage_concentration_index": 0.017221, "first_seen": "2026-07-20T05:13:25+00:00", "last_seen": "2026-07-20T18:19:55+00:00", "most_seen": "2026-07-20T16:19:55+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 40.6895, "lng": -74.0447, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "Spain", "entity_type": "GPE", "lat": 40, "lng": -4, "region": null, "country": "Spain", "continent": "Europe", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.8131, "sentiment_prob_neutral": 0.1814, "sentiment_prob_negative": 0.0055, "materiality": "high", "materiality_score": 0.643112, "time_horizon": "intraday", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.0067, "forward_looking_prob_not_forward": 0.9933 }, "tickers": [], "has_tickers": false, "entities": { "PERSON": [ { "name": "Donald Trump", "mention_count": 2, "confidence": 0.9995 } ], "GPE": [ { "name": "Spain", "mention_count": 1, "confidence": 0.9629 } ] }, "sentiments": { "GPE": [ { "name": "Spain", "sentiment_label": "positive", "sentiment_score": 1.4974198612975589 } ], "PERSON": [ { "name": "Donald Trump", "sentiment_label": "positive", "sentiment_score": 1.0455243402390748 } ] }, "ontologies": [ { "ontology": "schema_org_event", "label": "SportsEvent", "probability": 0.9992 }, { "ontology": "media_frame", "label": "Conflict", "probability": 0.999 } ] } ], "limit": 200, "offset": 0, "sort_by": "total_coverage", "desc": true } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/entities/events": { "get": { "operationId": "v2_0_world_entity_events", "summary": "By entity", "description": "Retrieve cursor-paged events that mention one canonical entity across any date window.\n\nIn V2.0, the timeline is driven by Atlas: it lists the events that mention the canonical entity under any of its folded names, and the entity is the one the Atlas API returns. Use this route to build a company or person timeline. Resolve the canonical name first, then page with the opaque cursor; do not infer a cursor from dates or offsets. Store the as_of markers with research results.", "tags": [ "EVENT LISTS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-entity-events" }, "x-nosible-reference-pages": [ "v2.0-world-entity-events" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "schema": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" } }, { "name": "include_vector", "in": "query", "required": false, "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "schema": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false } }, { "name": "type", "in": "query", "required": true, "description": "NER type, or ANY. ANY looks each entity type up under the name it indexes and returns the union of their events, as the entity_any filter does.", "schema": { "type": "string", "description": "NER type, or ANY. ANY looks each entity type up under the name it indexes and returns the union of their events, as the entity_any filter does.", "example": "ORG" } }, { "name": "name", "in": "query", "required": true, "description": "Canonical display name returned by /resolve.", "schema": { "type": "string", "description": "Canonical display name returned by /resolve.", "example": "Nvidia" } }, { "name": "limit", "in": "query", "required": false, "description": "Page size. Defaults to 50, maximum 500.", "schema": { "type": "integer", "description": "Page size. Defaults to 50, maximum 500.", "example": 50 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor returned by the previous response.", "schema": { "type": "string", "description": "Opaque cursor returned by the previous response.", "example": "eyJ2Ijox..." } }, { "name": "from", "in": "query", "required": false, "description": "Inclusive lower date bound in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Inclusive lower date bound in YYYY-MM-DD format.", "example": "2026-01-01" } }, { "name": "to", "in": "query", "required": false, "description": "Inclusive upper date bound in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Inclusive upper date bound in YYYY-MM-DD format.", "example": "2026-07-20" } }, { "name": "order", "in": "query", "required": false, "description": "Event ordering, newest or oldest first.", "schema": { "type": "string", "description": "Event ordering, newest or oldest first.", "example": "desc" } }, { "name": "include_live", "in": "query", "required": false, "description": "Defaults to true. Include published slices after the archive index, including today and yesterday (UTC). Set false for archive-only retrieval. GET uses the query string; POST uses a JSON boolean.", "schema": { "type": "boolean", "description": "Defaults to true. Include published slices after the archive index, including today and yesterday (UTC). Set false for archive-only retrieval. GET uses the query string; POST uses a JSON boolean.", "example": true } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "entity": { "type": "object", "properties": { "type": { "type": "string" }, "name": { "type": "string", "description": "Canonical Atlas name of the entity." }, "normalized": { "type": "string" } }, "additionalProperties": true, "description": "The entity: type, canonical Atlas name and normalized lookup form. Events mentioning it under any of its names are included." }, "total": { "type": "integer", "description": "Events matching the request before paging." }, "count": { "type": "integer", "description": "Events in this page." }, "order": { "type": "string", "description": "Event order: desc (newest first, the default) or asc." }, "date_window": { "type": "object", "properties": { "from": { "type": "string", "format": "date", "description": "First date searched." }, "to": { "type": "string", "format": "date", "description": "Last date searched." }, "index_last_date": { "type": "string" }, "archive_cutoff": { "type": "string" }, "include_live": { "type": "boolean" } }, "additionalProperties": true, "description": "The effective inclusive window searched: from, to, index_last_date (the last date with indexed events), archive_cutoff (the last archive date) and include_live. Entity and ticker timelines with include_live=true default to today (UTC) and accept a window wholly after the archive boundary, such as today alone. Their live_events are records in the same format, constrained by both bounds, marked ephemeral and returned on the first page only, outside archive total and cursor paging. Without include_live the default upper bound is the archived index." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." } } }, "description": "The events, as lite records unless view=full (About records on Event details lists both). A full record adds provenance, availability, triples, each ticker's why and v2_preview_success." }, "next_cursor": { "type": "string", "nullable": true, "description": "Opaque cursor for the next page; send it back unchanged. null when there are no more events." }, "hydration_misses": { "type": "integer", "description": "Events that matched but could not be read; normally 0." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered. Store them with results to reproduce them." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." }, "language": { "type": "array", "items": { "type": "string" }, "description": "Languages the events were filtered to with the language parameter; empty when not filtered." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_entity_events_v1", "view": "lite", "entity": { "type": "ORG", "name": "Nvidia", "normalized": "nvidia" }, "total": 27742, "count": 50, "order": "desc", "date_window": { "from": "2010-01-01", "to": "2026-10-09", "index_last_date": "2026-10-09", "archive_cutoff": "2026-10-09", "include_live": false }, "events": [ { "event_id": "2026-10-09_en_US_v1_fJAk7AAQTDuQEUbwQAAAALXM0AAAIog5QAAAAAAAAAA_fRCCe4Yc", "version": "2.0-preview", "has_tickers": true, "event": { "date": "2026-10-09", "language": "en", "title": "Trump Discloses Millions in Nvidia Trades Before Honoring CEO Huang", "description": "On October 8, 2026, the Trump administration released financial disclosures revealing millions of dollars in Nvidia stock trades. This announcement coincided with President Trump preparing to award CEO Jensen Huang the National Medal of...", "points": [ "The Trump administration disclosed millions of dollars in Nvidia stock trades on October 8, 2026." ] }, "english": { "title": "Trump Discloses Millions in Nvidia Trades Before Honoring CEO Huang", "description": "On October 8, 2026, the Trump administration released financial disclosures revealing millions of dollars in Nvidia stock trades. This announcement coincided with President Trump preparing to award CEO Jensen Huang the National Medal of...", "points": [ "The Trump administration disclosed millions of dollars in Nvidia stock trades on October 8, 2026." ], "date": "2026-10-09", "language": "en" }, "coverage": { "total_coverage": 3, "total_netlocs": 3, "coverage_concentration_index": 0.36, "first_seen": "2026-10-09T06:12:26+00:00", "last_seen": "2026-10-09T15:28:30+00:00", "most_seen": "2026-10-09T15:28:30+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 38.8977, "lng": -77.0365, "source": "llm", "matched_on": "{event.title}+{event.description}" } ], "signals": { "sentiment": "negative", "sentiment_prob_positive": 0.0027, "sentiment_prob_neutral": 0.3477, "sentiment_prob_negative": 0.6496, "materiality": "medium", "materiality_score": 0.5, "time_horizon": "intraday", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.2018, "forward_looking_prob_not_forward": 0.7982 }, "entities": { "PERSON": [ { "name": "Trump", "mention_count": 6, "confidence": 1 } ], "ORG": [ { "name": "Nvidia", "mention_count": 4, "confidence": 0.999 } ] }, "sentiments": { "ORG": [ { "name": "Nvidia", "sentiment_label": "positive", "sentiment_score": 0.26805403899512126 } ], "PERSON": [ { "name": "Trump", "sentiment_label": "neutral", "sentiment_score": 0.150743889862062 } ] }, "tickers": [ { "ticker": "NVDA.US", "companyv5_id": "c5-1b5479ea345b", "name": "NVIDIA Corporation", "website": "https://nvidia.com", "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0", "sector": "Information Technology", "industry": "Semiconductors & Semiconductor Equipment", "country_iso": "US", "exchange": "NASDAQ", "mic": "XNAS", "score": 0.993323 } ], "ontologies": [ { "ontology": "asset_class", "main_class": "Equities", "sub_class": "Public Equities", "probability": 0.9945 }, { "ontology": "iab", "tier_1": "Business and Finance", "tier_2": "Industries", "tier_3": "Technology Industry", "tier_4": "Technology Industry", "probability": 0.9888 } ] }, { "event_id": "2026-10-09_de_DE_v1_gYAUaGxhwMSzoAAAAAAAAOeSQAAACAAAAIgAAAAAAAA_yCPcTUjt", "version": "2.0-preview", "has_tickers": true, "event": { "date": "2026-10-09", "language": "de", "title": "KI-Aktien und deutsche Werte treiben Renditen bei steigenden Zinsen", "description": "Der Aktienmarkt wird von KI-Titeln wie Nvidia sowie deutschen Werten dominiert. Steigende Anleiherenditen in Europa und den USA, neue Konjunkturdaten und Erwartungen an die Geldpolitik der EZB und Fed sorgen für Dynamik. Der Fokus liegt...", "points": [ "KI-Aktien und deutsche Werte treiben die Renditen bei steigenden Zinsen." ] }, "english": { "title": "AI Stocks and German Values Drive Returns in Rising Interest Rates", "description": "The stock market is being driven by AI stocks like Nvidia, as well as German values. Rising bond yields in Europe and the US, new economic data, and expectations regarding the monetary policies of the ECB and the Fed are creating...", "points": [ "AI stocks and German values are driving returns in a rising interest rate environment." ], "date": "2026-10-09", "language": "de" }, "coverage": { "total_coverage": 5, "total_netlocs": 3, "coverage_concentration_index": 0.265306, "first_seen": "2026-10-09T09:24:38.860000+00:00", "last_seen": "2026-10-09T09:35:02+00:00", "most_seen": "2026-10-09T09:24:38.860000+00:00" }, "locations": [ { "continent": "Europe", "region": "Western Europe", "country": "Germany", "lat": 50.1109, "lng": 8.6821, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "US", "entity_type": "GPE", "lat": 39.76, "lng": -98.5, "region": null, "country": "United States", "continent": "North America", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.6095, "sentiment_prob_neutral": 0.3697, "sentiment_prob_negative": 0.0209, "materiality": "medium", "materiality_score": 0.5, "time_horizon": "intraday", "forward_looking": "forward", "forward_looking_prob_forward": 0.5927, "forward_looking_prob_not_forward": 0.4073 }, "entities": { "ORG": [ { "name": "Nvidia", "mention_count": 2, "confidence": 0.998 } ], "GPE": [ { "name": "US", "mention_count": 2, "confidence": 0.9995 } ], "LOC": [ { "name": "Europe", "mention_count": 2, "confidence": 0.9951 } ] }, "sentiments": { "GPE": [ { "name": "US", "sentiment_label": "neutral", "sentiment_score": -0.2744908186562095 } ], "LOC": [ { "name": "Europe", "sentiment_label": "neutral", "sentiment_score": -0.016844886662455316 } ], "ORG": [ { "name": "Nvidia", "sentiment_label": "positive", "sentiment_score": 0.3256439767496005 } ] }, "tickers": [ { "ticker": "RHM.XETRA", "companyv5_id": "c5-4dc9ee1f5cef", "name": "Rheinmetall AG", "website": "https://rheinmetall.com", "wiki_qid": "Q161544", "isin": "DE0007030009", "lei": "5299001OU9CSE29O6S05", "figi": null, "sector": "Industrials", "industry": "Aerospace & Defense", "country_iso": null, "exchange": "XETRA", "mic": null, "score": 0.983107 } ], "ontologies": [ { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9993 }, { "ontology": "media_frame", "label": "Economic Consequences", "probability": 0.9972 } ] } ], "next_cursor": "eyJ2IjoxLCJi...", "hydration_misses": 0, "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "took_ms": 43, "language": [] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.\n\nunknown_entity: The requested entity is not present in the index.", "x-nosible-error-codes": [ "not_found", "unknown_entity" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor belongs to a replaced index build; restart from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/polygon/events": { "post": { "operationId": "v2_0_world_polygon_events", "summary": "By polygon", "description": "Retrieve full World V2.0 event records with a stored location inside a GeoJSON polygon or multipolygon.\n\nAvailable only in V2.0 at /api/v2.0/polygon/events. An event matches when any stored location is inside the GeoJSON Polygon or MultiPolygon; coordinates are [longitude, latitude], outer and hole boundaries count as inside, and a point inside a hole does not. GET uses query parameters with polygon URL-encoded as GeoJSON; POST accepts the same options in JSON, with request bodies capped at 128 KiB. Each page returns full hydrated event records in one events[] array, merging archive results with every published newer slice after the archived index through today (UTC). The V2.0 service publishes yesterday and today as recent slices and checks them automatically when they fall inside the requested dates. The normal World API key/session gate and tier-clamped date floor apply. include_live defaults to true, just as on the entity, ticker and ontology timelines; set it to false for archive-only results. Polygon pages use one events[] list. to defaults to today and cannot be later. The opaque cursor is bound to polygon, effective dates, order, language and archive index build; send it unchanged to avoid gaps or overlaps. Live rows are read from the same pinned source snapshot as their live polygon index, and live membership is refreshed on each page with a date/event_id keyset. A source publish between page requests can change later live membership, so restart from page one when a consistent traversal is needed. An archive republish expires the cursor with 410 cursor_expired. Use order and language to control the unified result set, view=lite (default) or view=full to choose event projection, and include_vector=true when the embedding is needed.", "tags": [ "EVENT LISTS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-polygon-events" }, "x-nosible-reference-pages": [ "v2.0-world-polygon-events" ], "security": [ { "BearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full." }, "polygon": { "type": "object", "properties": { "type": { "type": "string" }, "coordinates": { "type": "array", "items": { "type": "array", "items": { "type": "array", "items": { "type": "number" } } } } }, "additionalProperties": true, "description": "GeoJSON Polygon or MultiPolygon geometry used for the query." }, "total": { "type": "integer", "description": "Matching events in the effective date window before paging." }, "count": { "type": "integer", "description": "Events in this page." }, "limit": { "type": "integer", "description": "Page size applied." }, "order": { "type": "string", "description": "Event order: desc (newest first) or asc (oldest first)." }, "date_window": { "type": "object", "properties": { "from": { "type": "string", "format": "date", "description": "First date in the effective tier-clamped window." }, "to": { "type": "string", "format": "date", "description": "Last date in the effective window; defaults to today (UTC) and never exceeds today." }, "index_last_date": { "type": "string", "format": "date", "description": "Last date included in the current archived index." }, "archive_cutoff": { "type": "string", "format": "date", "description": "Archive cutoff reported by the active World index." }, "include_live": { "type": "boolean", "description": "Effective include_live choice. Defaults to true; false restricts the timeline to the archive." } }, "additionalProperties": true, "description": "Effective date range through today (UTC), the archive boundary, and the effective include_live option." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." } } }, "description": "Unified, fully hydrated V2.0 event records from the archive and any published newer slices in the effective date range, ordered and paged together. Lite by default; view=full returns the complete records." }, "next_cursor": { "type": "string", "nullable": true, "description": "Opaque cursor for the next page; send it unchanged with the same query." }, "hydration_misses": { "type": "integer", "description": "Matching records that could not be read during hydration; normally 0." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string", "description": "Archive index generation used for the page. A later generation expires existing cursors with 410 cursor_expired." }, "archive_cutoff": { "type": "string", "format": "date", "description": "Archive cutoff reported by the active World index." } }, "additionalProperties": true, "description": "Index build and archive cutoff used for the query." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." }, "language": { "type": "array", "items": { "type": "string" }, "description": "Effective language filter; empty when none was sent." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_polygon_events_v1", "view": "lite", "polygon": { "type": "Polygon", "coordinates": [ [ [ -122.5, 37.6 ], [ -122.3, 37.6 ], [ -122.3, 37.8 ], [ -122.5, 37.6 ] ] ] }, "total": 12, "count": 2, "limit": 2, "order": "desc", "date_window": { "from": "2026-10-08", "to": "2026-10-15", "index_last_date": "2026-10-14", "archive_cutoff": "2026-10-14", "include_live": true }, "events": [ { "event_id": "2026-10-15_en_US_v1_ExampleLiveEvent", "version": "2.0-preview", "event": { "date": "2026-10-15", "language": "en", "title": "San Francisco approves a new transit plan", "description": "City leaders approved a transit investment plan after a public hearing.", "points": [ "The plan directs new funding to public transit in San Francisco." ] }, "english": { "date": "2026-10-15", "language": "en", "title": "San Francisco approves a new transit plan", "description": "City leaders approved a transit investment plan after a public hearing.", "points": [ "The plan directs new funding to public transit in San Francisco." ] }, "coverage": { "total_coverage": 18, "total_netlocs": 11, "coverage_concentration_index": 0.12, "first_seen": "2026-10-15T05:20:00+00:00", "last_seen": "2026-10-15T11:10:00+00:00", "most_seen": "2026-10-15T08:00:00+00:00" }, "locations": [ { "continent": "North America", "region": "California", "country": "United States", "lat": 37.77, "lng": -122.42, "source": "llm", "matched_on": "event title and description" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.81, "sentiment_prob_neutral": 0.15, "sentiment_prob_negative": 0.04, "materiality": "medium", "materiality_score": 0.61, "time_horizon": "weeks", "forward_looking": "forward", "forward_looking_prob_forward": 0.74, "forward_looking_prob_not_forward": 0.26 }, "tickers": [], "has_tickers": false, "entities": { "GPE": [ { "name": "San Francisco", "mention_count": 2, "confidence": 0.99 } ] }, "sentiments": {}, "ontologies": [ { "ontology": "media_frame", "label": "Economic Consequences", "probability": 0.82 } ] }, { "event_id": "2026-10-14_en_US_v1_ExampleArchiveEvent", "version": "2.0-preview", "event": { "date": "2026-10-14", "language": "en", "title": "Bay Area transit agencies coordinate service", "description": "Regional agencies announced coordinated service changes for commuters.", "points": [ "The agencies will coordinate Bay Area commuter service changes." ] }, "english": { "date": "2026-10-14", "language": "en", "title": "Bay Area transit agencies coordinate service", "description": "Regional agencies announced coordinated service changes for commuters.", "points": [ "The agencies will coordinate Bay Area commuter service changes." ] }, "coverage": { "total_coverage": 9, "total_netlocs": 7, "coverage_concentration_index": 0.18, "first_seen": "2026-10-14T04:15:00+00:00", "last_seen": "2026-10-14T12:32:00+00:00", "most_seen": "2026-10-14T07:05:00+00:00" }, "locations": [ { "continent": "North America", "region": "California", "country": "United States", "lat": 37.76, "lng": -122.43, "source": "ner", "matched_on": "San Francisco" } ], "signals": { "sentiment": "neutral", "sentiment_prob_positive": 0.14, "sentiment_prob_neutral": 0.79, "sentiment_prob_negative": 0.07, "materiality": "low", "materiality_score": 0.32, "time_horizon": "days", "forward_looking": "forward", "forward_looking_prob_forward": 0.55, "forward_looking_prob_not_forward": 0.45 }, "tickers": [], "has_tickers": false, "entities": { "GPE": [ { "name": "San Francisco", "mention_count": 1, "confidence": 0.98 } ] }, "sentiments": {}, "ontologies": [] } ], "next_cursor": "eyJ2Ijox...", "hydration_misses": 0, "as_of": { "index_build": "inv-20261015-012000", "archive_cutoff": "2026-10-14" }, "took_ms": 18, "language": [ "en" ] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "408": { "description": "request_timeout: The JSON body did not finish uploading within 10 seconds.", "x-nosible-error-codes": [ "request_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "413": { "description": "payload_too_large: The POST body is larger than 128 KiB.", "x-nosible-error-codes": [ "payload_too_large" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "415": { "description": "unsupported_media_type: POST requires Content-Type: application/json.", "x-nosible-error-codes": [ "unsupported_media_type" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "view": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" }, "include_vector": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false }, "polygon": { "type": "object", "additionalProperties": true, "description": "GeoJSON Polygon or MultiPolygon geometry. Coordinates are [longitude, latitude]; do not wrap it in a Feature. POST bodies are limited to 128 KiB.", "example": { "type": "Polygon", "coordinates": [ [ [ -122.5, 37.6 ], [ -122.3, 37.6 ], [ -122.3, 37.8 ], [ -122.5, 37.6 ] ] ] } }, "from": { "type": "string", "format": "date", "description": "Inclusive YYYY-MM-DD date window. Published newer slices through today are included automatically; the front door clamps the lower bound to the API key's tier window. to cannot be later than today (UTC).", "example": "2026-10-08" }, "to": { "type": "string", "format": "date", "description": "Inclusive YYYY-MM-DD date window. Published newer slices through today are included automatically; the front door clamps the lower bound to the API key's tier window. to cannot be later than today (UTC).", "example": "2026-10-08" }, "as_of": { "type": "string", "format": "date", "description": "Alias for to. Send as_of or to; if both are sent, their values must match.", "example": "2026-10-14" }, "limit": { "type": "integer", "description": "Page size across the unified archive and published newer slices. Defaults to 50 and is capped at 500.", "example": 50 }, "cursor": { "type": "string", "description": "Opaque next_cursor from the previous page. Send it unchanged with the same polygon and filters.", "example": "eyJ2Ijox..." }, "order": { "type": "string", "description": "Event order: desc (newest first, default) or asc (oldest first).", "example": "desc" }, "include": { "type": "string", "description": "Record projection: event_lite, lite, event_full, or full.", "example": "event_lite" }, "language": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "Optional language code or list of language codes.", "example": [ "en" ] }, "include_live": { "type": "boolean", "description": "Defaults to true. Include published slices after the archive index, including today and yesterday (UTC). Set false for archive-only retrieval. GET uses the query string; POST uses a JSON boolean.", "example": true } }, "additionalProperties": true, "required": [ "polygon" ] }, "examples": { "v2_0_world_polygon_events": { "summary": "By polygon", "value": { "polygon": { "type": "Polygon", "coordinates": [ [ [ -122.5, 37.6 ], [ -122.3, 37.6 ], [ -122.3, 37.8 ], [ -122.5, 37.6 ] ] ] }, "from": "2026-10-08", "to": "2026-10-15", "limit": 2, "order": "desc", "language": [ "en" ], "view": "lite" } } } } } } } }, "/api/v2.0/tickers/{symbol}/events": { "get": { "operationId": "v2_0_world_ticker_events", "summary": "By ticker", "description": "Retrieve the event timeline for a ticker or alternate security identifier.\n\nIn V2.0, ticker events are the events whose tickers include the symbol. Events link to a ticker through the Atlas graph, so this is not the same list as the issuer entity's events. Use this route when the security identifier is the natural key for your model. Prefer the canonical symbol from Resolve; id_type lets you query by ISIN, FIGI, LEI, or Wikidata QID when that is what your security master contains.", "tags": [ "EVENT LISTS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-ticker-events" }, "x-nosible-reference-pages": [ "v2.0-world-ticker-events" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "schema": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" } }, { "name": "include_vector", "in": "query", "required": false, "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "schema": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false } }, { "name": "symbol", "in": "path", "required": true, "description": "Canonical symbol returned by Resolve, for example NVDA.", "schema": { "type": "string", "description": "Canonical symbol returned by Resolve, for example NVDA.", "example": "NVDA.US" } }, { "name": "id_type", "in": "query", "required": false, "description": "symbol, isin, figi, lei, or qid.", "schema": { "type": "string", "description": "symbol, isin, figi, lei, or qid.", "example": "symbol" } }, { "name": "limit", "in": "query", "required": false, "description": "Page size. Use a bounded page size for predictable payloads.", "schema": { "type": "integer", "description": "Page size. Use a bounded page size for predictable payloads.", "example": 50 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string", "description": "Opaque cursor returned by the previous page.", "example": "eyJ2Ijox..." } }, { "name": "order", "in": "query", "required": false, "description": "Event ordering, newest or oldest first.", "schema": { "type": "string", "description": "Event ordering, newest or oldest first.", "example": "desc" } }, { "name": "include_live", "in": "query", "required": false, "description": "Defaults to true. Include published slices after the archive index, including today and yesterday (UTC). Set false for archive-only retrieval. GET uses the query string; POST uses a JSON boolean.", "schema": { "type": "boolean", "description": "Defaults to true. Include published slices after the archive index, including today and yesterday (UTC). Set false for archive-only retrieval. GET uses the query string; POST uses a JSON boolean.", "example": true } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "ticker": { "type": "object", "properties": { "symbol": { "type": "string", "description": "Symbol with its exchange suffix, such as NVDA.US." }, "id_type": { "type": "string" }, "normalized": { "type": "string" } }, "additionalProperties": true, "description": "The ticker: symbol, id_type and normalized lookup form. Its events are the events whose tickers include it." }, "total": { "type": "integer", "description": "Events matching the request before paging." }, "count": { "type": "integer", "description": "Events in this page." }, "order": { "type": "string", "description": "Event order: desc (newest first, the default) or asc." }, "date_window": { "type": "object", "properties": { "from": { "type": "string", "format": "date", "description": "First date searched." }, "to": { "type": "string", "format": "date", "description": "Last date searched." }, "index_last_date": { "type": "string" }, "archive_cutoff": { "type": "string" }, "include_live": { "type": "boolean" } }, "additionalProperties": true, "description": "The effective inclusive window searched: from, to, index_last_date (the last date with indexed events), archive_cutoff (the last archive date) and include_live. Entity and ticker timelines with include_live=true default to today (UTC) and accept a window wholly after the archive boundary, such as today alone. Their live_events are records in the same format, constrained by both bounds, marked ephemeral and returned on the first page only, outside archive total and cursor paging. Without include_live the default upper bound is the archived index." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." } } }, "description": "The events, as lite records unless view=full (About records on Event details lists both). A full record adds provenance, availability, triples, each ticker's why and v2_preview_success." }, "next_cursor": { "type": "string", "nullable": true, "description": "Opaque cursor for the next page; send it back unchanged. null when there are no more events." }, "hydration_misses": { "type": "integer", "description": "Events that matched but could not be read; normally 0." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered. Store them with results to reproduce them." }, "language": { "type": "array", "items": { "type": "string" }, "description": "Languages the events were filtered to with the language parameter; empty when not filtered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_ticker_events_v1", "view": "lite", "ticker": { "symbol": "NVDA.US", "id_type": "symbol", "normalized": "nvda.us" }, "total": 31828, "count": 50, "order": "desc", "date_window": { "from": "2010-01-01", "to": "2026-10-09", "index_last_date": "2026-10-09", "archive_cutoff": "2026-10-09", "include_live": false }, "events": [ { "event_id": "2026-10-09_en_US_v1_fJAk7AAQTDuQEUbwQAAAALXM0AAAIog5QAAAAAAAAAA_fRCCe4Yc", "version": "2.0-preview", "has_tickers": true, "event": { "date": "2026-10-09", "language": "en", "title": "Trump Discloses Millions in Nvidia Trades Before Honoring CEO Huang", "description": "On October 8, 2026, the Trump administration released financial disclosures revealing millions of dollars in Nvidia stock trades. This announcement coincided with President Trump preparing to award CEO Jensen Huang the National Medal of...", "points": [ "The Trump administration disclosed millions of dollars in Nvidia stock trades on October 8, 2026." ] }, "english": { "title": "Trump Discloses Millions in Nvidia Trades Before Honoring CEO Huang", "description": "On October 8, 2026, the Trump administration released financial disclosures revealing millions of dollars in Nvidia stock trades. This announcement coincided with President Trump preparing to award CEO Jensen Huang the National Medal of...", "points": [ "The Trump administration disclosed millions of dollars in Nvidia stock trades on October 8, 2026." ], "date": "2026-10-09", "language": "en" }, "coverage": { "total_coverage": 3, "total_netlocs": 3, "coverage_concentration_index": 0.36, "first_seen": "2026-10-09T06:12:26+00:00", "last_seen": "2026-10-09T15:28:30+00:00", "most_seen": "2026-10-09T15:28:30+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 38.8977, "lng": -77.0365, "source": "llm", "matched_on": "{event.title}+{event.description}" } ], "signals": { "sentiment": "negative", "sentiment_prob_positive": 0.0027, "sentiment_prob_neutral": 0.3477, "sentiment_prob_negative": 0.6496, "materiality": "medium", "materiality_score": 0.5, "time_horizon": "intraday", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.2018, "forward_looking_prob_not_forward": 0.7982 }, "entities": { "PERSON": [ { "name": "Trump", "mention_count": 6, "confidence": 1 } ], "ORG": [ { "name": "Nvidia", "mention_count": 4, "confidence": 0.999 } ] }, "sentiments": { "ORG": [ { "name": "Nvidia", "sentiment_label": "positive", "sentiment_score": 0.26805403899512126 } ], "PERSON": [ { "name": "Trump", "sentiment_label": "neutral", "sentiment_score": 0.150743889862062 } ] }, "tickers": [ { "ticker": "NVDA.US", "companyv5_id": "c5-1b5479ea345b", "name": "NVIDIA Corporation", "website": "https://nvidia.com", "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0", "sector": "Information Technology", "industry": "Semiconductors & Semiconductor Equipment", "country_iso": "US", "exchange": "NASDAQ", "mic": "XNAS", "score": 0.993323 } ], "ontologies": [ { "ontology": "asset_class", "main_class": "Equities", "sub_class": "Public Equities", "probability": 0.9945 }, { "ontology": "iab", "tier_1": "Business and Finance", "tier_2": "Industries", "tier_3": "Technology Industry", "tier_4": "Technology Industry", "probability": 0.9888 } ] }, { "event_id": "2026-10-09_de_DE_v1_gYAUaGxhwMSzoAAAAAAAAOeSQAAACAAAAIgAAAAAAAA_yCPcTUjt", "version": "2.0-preview", "has_tickers": true, "event": { "date": "2026-10-09", "language": "de", "title": "KI-Aktien und deutsche Werte treiben Renditen bei steigenden Zinsen", "description": "Der Aktienmarkt wird von KI-Titeln wie Nvidia sowie deutschen Werten dominiert. Steigende Anleiherenditen in Europa und den USA, neue Konjunkturdaten und Erwartungen an die Geldpolitik der EZB und Fed sorgen für Dynamik. Der Fokus liegt...", "points": [ "KI-Aktien und deutsche Werte treiben die Renditen bei steigenden Zinsen." ] }, "english": { "title": "AI Stocks and German Values Drive Returns in Rising Interest Rates", "description": "The stock market is being driven by AI stocks like Nvidia, as well as German values. Rising bond yields in Europe and the US, new economic data, and expectations regarding the monetary policies of the ECB and the Fed are creating...", "points": [ "AI stocks and German values are driving returns in a rising interest rate environment." ], "date": "2026-10-09", "language": "de" }, "coverage": { "total_coverage": 5, "total_netlocs": 3, "coverage_concentration_index": 0.265306, "first_seen": "2026-10-09T09:24:38.860000+00:00", "last_seen": "2026-10-09T09:35:02+00:00", "most_seen": "2026-10-09T09:24:38.860000+00:00" }, "locations": [ { "continent": "Europe", "region": "Western Europe", "country": "Germany", "lat": 50.1109, "lng": 8.6821, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "US", "entity_type": "GPE", "lat": 39.76, "lng": -98.5, "region": null, "country": "United States", "continent": "North America", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.6095, "sentiment_prob_neutral": 0.3697, "sentiment_prob_negative": 0.0209, "materiality": "medium", "materiality_score": 0.5, "time_horizon": "intraday", "forward_looking": "forward", "forward_looking_prob_forward": 0.5927, "forward_looking_prob_not_forward": 0.4073 }, "entities": { "ORG": [ { "name": "Nvidia", "mention_count": 2, "confidence": 0.998 } ], "GPE": [ { "name": "US", "mention_count": 2, "confidence": 0.9995 } ], "LOC": [ { "name": "Europe", "mention_count": 2, "confidence": 0.9951 } ] }, "sentiments": { "GPE": [ { "name": "US", "sentiment_label": "neutral", "sentiment_score": -0.2744908186562095 } ], "LOC": [ { "name": "Europe", "sentiment_label": "neutral", "sentiment_score": -0.016844886662455316 } ], "ORG": [ { "name": "Nvidia", "sentiment_label": "positive", "sentiment_score": 0.3256439767496005 } ] }, "tickers": [ { "ticker": "RHM.XETRA", "companyv5_id": "c5-4dc9ee1f5cef", "name": "Rheinmetall AG", "website": "https://rheinmetall.com", "wiki_qid": "Q161544", "isin": "DE0007030009", "lei": "5299001OU9CSE29O6S05", "figi": null, "sector": "Industrials", "industry": "Aerospace & Defense", "country_iso": null, "exchange": "XETRA", "mic": null, "score": 0.983107 } ], "ontologies": [ { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9993 }, { "ontology": "media_frame", "label": "Economic Consequences", "probability": 0.9972 } ] } ], "next_cursor": "eyJ2IjoxLCJi...", "hydration_misses": 0, "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "language": [], "took_ms": 16 } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.\n\nunknown_ticker: The requested symbol or identifier does not resolve to an indexed security.", "x-nosible-error-codes": [ "not_found", "unknown_ticker" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor belongs to a replaced index build; restart from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/ontology/events": { "get": { "operationId": "v2_0_world_ontology_events", "summary": "By ontology", "description": "Retrieve events classified into one ontology field and value, including ranked top-three matches.\n\nUse ontology retrieval to turn a taxonomy class into a clean event universe. Select the class with either field=gics_sector&value=Energy or ontology=gics&level=sector&value=Energy. Directory levels are local names such as sector or tier_1, and are not necessarily the indexed filter field names; copy a hierarchy node's events_url to use the correct pair. Choose top1 for precision; choose top3 when recall matters and you are comfortable with parent/child class overlap. include_live defaults to true, as on the entity, ticker and polygon timelines. Both top1 and top3 include today and yesterday within the requested UTC dates; set include_live=false for archive-only retrieval.", "tags": [ "EVENT LISTS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-ontology-events" }, "x-nosible-reference-pages": [ "v2.0-world-ontology-events" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "schema": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" } }, { "name": "include_vector", "in": "query", "required": false, "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "schema": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false } }, { "name": "field", "in": "query", "required": false, "description": "Indexed ontology field, such as gics_sector. Supply field, or supply both ontology and level instead.", "schema": { "type": "string", "description": "Indexed ontology field, such as gics_sector. Supply field, or supply both ontology and level instead.", "example": "gics_sector" } }, { "name": "value", "in": "query", "required": true, "description": "Ontology class to retrieve.", "schema": { "type": "string", "description": "Ontology class to retrieve.", "example": "Energy" } }, { "name": "match", "in": "query", "required": false, "description": "top1 precision match or top3 recall match.", "schema": { "type": "string", "description": "top1 precision match or top3 recall match.", "example": "top3" } }, { "name": "from", "in": "query", "required": false, "description": "Inclusive lower date bound in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Inclusive lower date bound in YYYY-MM-DD format.", "example": "2026-01-01" } }, { "name": "to", "in": "query", "required": false, "description": "Inclusive upper date bound in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Inclusive upper date bound in YYYY-MM-DD format.", "example": "2026-07-20" } }, { "name": "limit", "in": "query", "required": false, "description": "Page size.", "schema": { "type": "integer", "description": "Page size.", "example": 100 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque cursor returned by the previous page.", "schema": { "type": "string", "description": "Opaque cursor returned by the previous page.", "example": "eyJ2Ijox..." } }, { "name": "order", "in": "query", "required": false, "description": "Event ordering, newest or oldest first.", "schema": { "type": "string", "description": "Event ordering, newest or oldest first.", "example": "desc" } }, { "name": "ontology", "in": "query", "required": false, "description": "Ontology id or slug from the directory, such as gics. Required with level when field is omitted.", "schema": { "type": "string", "description": "Ontology id or slug from the directory, such as gics. Required with level when field is omitted.", "example": "gics" } }, { "name": "level", "in": "query", "required": false, "description": "Local level name returned by the directory, such as sector for GICS or tier_1 for IAB. Required with ontology when field is omitted.", "schema": { "type": "string", "description": "Local level name returned by the directory, such as sector for GICS or tier_1 for IAB. Required with ontology when field is omitted.", "example": "sector" } }, { "name": "include_live", "in": "query", "required": false, "description": "Defaults to true. Include published slices after the archive index, including today and yesterday (UTC). Set false for archive-only retrieval. GET uses the query string; POST uses a JSON boolean.", "schema": { "type": "boolean", "description": "Defaults to true. Include published slices after the archive index, including today and yesterday (UTC). Set false for archive-only retrieval. GET uses the query string; POST uses a JSON boolean.", "example": true } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "classification": { "type": "object", "properties": { "field": { "type": "string", "description": "Taxonomy field, such as gics_sector." }, "value": { "type": "string", "description": "Class value." }, "match": { "type": "string", "description": "top1 (the event's most probable class) or top3 (any of its three most probable)." }, "ontology": {}, "level": {} }, "additionalProperties": true, "description": "The class requested: field, value and match (top1 or top3), and ontology and level when the request names them instead of field." }, "total": { "type": "integer", "description": "Events matching the request before paging." }, "count": { "type": "integer", "description": "Events in this page." }, "order": { "type": "string", "description": "Event order: desc (newest first, the default) or asc." }, "date_window": { "type": "object", "properties": { "from": { "type": "string", "format": "date", "description": "First date searched." }, "to": { "type": "string", "format": "date", "description": "Last date searched." }, "index_last_date": { "type": "string" }, "archive_cutoff": { "type": "string" }, "include_live": { "type": "boolean" } }, "additionalProperties": true, "description": "The effective inclusive window searched: from, to, index_last_date (the last date with indexed events), archive_cutoff (the last archive date) and include_live. Entity and ticker timelines with include_live=true default to today (UTC) and accept a window wholly after the archive boundary, such as today alone. Their live_events are records in the same format, constrained by both bounds, marked ephemeral and returned on the first page only, outside archive total and cursor paging. Without include_live the default upper bound is the archived index." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." } } }, "description": "The events, as lite records unless view=full (About records on Event details lists both). A full record adds provenance, availability, triples, each ticker's why and v2_preview_success." }, "next_cursor": { "type": "string", "nullable": true, "description": "Opaque cursor for the next page; send it back unchanged. null when there are no more events." }, "hydration_misses": { "type": "integer", "description": "Events that matched but could not be read; normally 0." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered. Store them with results to reproduce them." }, "language": { "type": "array", "items": { "type": "string" }, "description": "Languages the events were filtered to with the language parameter; empty when not filtered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_ontology_events_v1", "view": "lite", "classification": { "field": "gics_sector", "value": "Energy", "match": "top3", "ontology": null, "level": null }, "total": 169244, "count": 50, "order": "desc", "date_window": { "from": "2010-01-01", "to": "2026-10-09", "index_last_date": "2026-10-09", "archive_cutoff": "2026-10-09", "include_live": false }, "events": [ { "event_id": "2026-10-09_en_US_v1_EYAQTFMQSioLohBAoAAAAAAAAAAAAAAAAaAAAAAAAAA_Yoqa9kP8", "version": "2.0-preview", "has_tickers": false, "event": { "date": "2026-10-09", "language": "en", "title": "Maryland Governor Declares Emergency Over Record Diesel Prices", "description": "Governor Wes Moore declared a state of emergency in Maryland as diesel fuel prices surged 76.2 percent over the last year, hitting $6.467 per gallon. The executive order temporarily allows agricultural and forestry vehicles to use dyed...", "points": [ "Governor Wes Moore declared a state of emergency in Maryland due to record diesel prices." ] }, "english": { "title": "Maryland Governor Declares Emergency Over Record Diesel Prices", "description": "Governor Wes Moore declared a state of emergency in Maryland as diesel fuel prices surged 76.2 percent over the last year, hitting $6.467 per gallon. The executive order temporarily allows agricultural and forestry vehicles to use dyed...", "points": [ "Governor Wes Moore declared a state of emergency in Maryland due to record diesel prices." ], "date": "2026-10-09", "language": "en" }, "coverage": { "total_coverage": 4, "total_netlocs": 3, "coverage_concentration_index": 0.28, "first_seen": "2026-10-09T20:24:31+00:00", "last_seen": "2026-10-09T23:58:08+00:00", "most_seen": "2026-10-09T20:24:31+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 39.0458, "lng": -76.6413, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "Maryland", "entity_type": "GPE", "lat": 39.00039, "lng": -76.74997, "region": "Maryland", "country": "United States", "continent": "North America", "source": "ner" } ], "signals": { "sentiment": "negative", "sentiment_prob_positive": 0.0012, "sentiment_prob_neutral": 0.0036, "sentiment_prob_negative": 0.9952, "materiality": "medium", "materiality_score": 0.466, "time_horizon": "days", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.0293, "forward_looking_prob_not_forward": 0.9707 }, "entities": { "PERSON": [ { "name": "Wes Moore", "mention_count": 2, "confidence": 0.9951 } ], "GPE": [ { "name": "Maryland", "mention_count": 6, "confidence": 1 } ] }, "sentiments": { "GPE": [ { "name": "Maryland", "sentiment_label": "neutral", "sentiment_score": -0.18828650455426943 } ], "PERSON": [ { "name": "Wes Moore", "sentiment_label": "neutral", "sentiment_score": 0.20465159881391337 } ] }, "tickers": [], "ontologies": [ { "ontology": "media_frame", "label": "Economic Consequences", "probability": 0.9985 }, { "ontology": "iab", "tier_1": "Business and Finance", "tier_2": "Economy", "tier_3": "Gasoline Prices", "tier_4": "Gasoline Prices", "probability": 0.9934 } ] }, { "event_id": "2026-10-09_fa_GB_v1_gYAUaGsQSioLoAAAAAAAAAAAAAAAAAAAAaAAAAAAAAA_V7vZ8YYP", "version": "2.0-preview", "has_tickers": false, "event": { "date": "2026-10-09", "language": "fa", "title": "کاهش جزئی قیمت نفت برنت در بازار جهانی روز جمعه", "description": "قیمت نفت برنت در بازار جهانی روز جمعه هفدهم مهر ماه نسبت به روز گذشته کاهش یافت. هر بشکه از ۱۰۴.۴۱۹ دلار به حدود ۱۰۳.۰۰۴ دلار رسید. این نوسان منفی نشان‌دهنده تغییرات لحظه‌ای در تقاضا و عرضه نفت است که بر شاخص‌های انرژی تأثیر گذاشت.", "points": [ "قیمت نفت برنت در بازار جهانی روز جمعه ۱۷ مهر ماه کاهش یافت." ] }, "english": { "title": "Slight Decrease in Brent Crude Oil Prices in the Global Market on Friday", "description": "Brent crude oil prices in the global market decreased on Friday, October 17th, compared to the previous day. The price per barrel fell from approximately $104.419 to around $103.004. This negative fluctuation indicates immediate changes...", "points": [ "Brent crude oil prices in the global market decreased on Friday, October 17th." ], "date": "2026-10-09", "language": "fa" }, "coverage": { "total_coverage": 4, "total_netlocs": 4, "coverage_concentration_index": 0.277778, "first_seen": "2026-10-09T09:44:39+00:00", "last_seen": "2026-10-09T10:24:22+00:00", "most_seen": "2026-10-09T09:44:39+00:00" }, "locations": [ { "continent": "Europe", "region": "Western Europe", "country": "United Kingdom", "lat": 51.5074, "lng": -0.1278, "source": "llm", "matched_on": "{event.title}+{event.description}" } ], "signals": { "sentiment": "negative", "sentiment_prob_positive": 0.0382, "sentiment_prob_neutral": 0.1941, "sentiment_prob_negative": 0.7677, "materiality": "medium", "materiality_score": 0.595333, "time_horizon": "intraday", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.0293, "forward_looking_prob_not_forward": 0.9707 }, "entities": { "PRODUCT": [ { "name": "Brent", "mention_count": 4, "confidence": 0.8433 } ] }, "sentiments": { "PRODUCT": [ { "name": "Brent", "sentiment_label": "neutral", "sentiment_score": -0.55992011798881 } ] }, "tickers": [], "ontologies": [ { "ontology": "iptc_media_topics", "level_1": "economy, business and finance", "level_2": "market and exchange", "level_3": "commodities market", "probability": 0.9987 }, { "ontology": "plover", "context": "economic", "probability": 0.998 } ] } ], "next_cursor": "eyJ2IjoxLCJi...", "hydration_misses": 0, "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "language": [], "took_ms": 26 } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.\n\nunknown_ontology_value: The field/value combination is valid but the requested class has no indexed match; check the schema or resolve the class again.", "x-nosible-error-codes": [ "not_found", "unknown_ontology_value" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor belongs to a replaced index build; restart from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.\n\ncursor_filter_mismatch: The cursor was created for a different ontology field, value, or match mode.", "x-nosible-error-codes": [ "validation_error", "cursor_filter_mismatch" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "x-nosible-parameter-alternatives": [ [ "field", "value" ], [ "ontology", "level", "value" ] ] } }, "/api/v2.0/search/{date}/semantic": { "post": { "operationId": "v2_0_world_semantic_search", "summary": "For a day", "description": "Find semantically related events inside one dated World archive slice.\n\nUse semantic search for concept-level recall when exact keywords are too brittle. Keep the query focused and compare similarity scores across a consistent date and limit. The route returns the same lite event records used by day search, plus explicit HNSW score metadata. It takes query (required), limit, embedding_model, semantic_candidates, view, include_vector and include, and nothing else: filters, sort, facets and offset are a 422 validation_error. For those, POST /api/v2.0/search with search_type semantic and a one-day date window.", "tags": [ "EVENT SEARCH" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-semantic-search" }, "x-nosible-reference-pages": [ "v2.0-world-semantic-search" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "date", "in": "path", "required": true, "description": "Archive date in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Archive date in YYYY-MM-DD format.", "example": "2026-07-20" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "total": { "type": "integer", "description": "Events of the day at or above the 0.20 similarity floor among the semantic_candidates nearest to the query (5,000 unless sent): the same for any limit." }, "total_exact": { "type": "boolean", "description": "true when total counts every event of the day above the floor. false when the candidate budget filled with the last candidate still above the floor, so more may exist: send a larger semantic_candidates." }, "count": { "type": "integer", "description": "Events in this response." }, "limit": { "type": "integer", "description": "Result cap applied: 50 unless limit is sent." }, "offset": { "type": "integer", "description": "Always 0." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." }, "_score": { "type": "number", "description": "Rank-derived score, 1 / (rank + 1)." }, "_hnsw_distance": { "type": "number", "description": "Distance in the day's vector index; lower is closer." }, "_cosine_similarity": { "type": "number", "description": "Cosine similarity to the query; higher is closer." } } }, "description": "The events, as lite records unless view=full (About records on Event details lists both). A full record adds provenance, availability, triples, each ticker's why and v2_preview_success." }, "facets": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Always empty on this route." }, "query_took_ms": { "type": "integer", "description": "Total time in milliseconds." }, "embedding_ms": { "type": "integer", "description": "Time spent embedding the query." }, "search_ms": { "type": "integer", "description": "Time spent searching the day's index." }, "embedding_model": { "type": "string", "description": "Embedding model requested." }, "models_used": { "type": "array", "items": { "type": "string" }, "description": "Embedding models used." }, "per_index_k": { "type": "integer", "description": "Candidates requested from the day's index: the candidate budget." }, "min_cosine_similarity": { "type": "number", "description": "Similarity floor applied." }, "matched_tokens": { "type": "array", "items": { "type": "string" }, "description": "The query, echoed." }, "errors": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Non-fatal errors; empty when none." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." }, "total_capped_at": { "type": "integer", "description": "Only when total_exact is false: the candidate budget that capped total." } }, "additionalProperties": true }, "example": { "view": "lite", "total": 705, "total_exact": true, "count": 50, "limit": 50, "offset": 0, "events": [ { "event_id": "2026-07-20_en_JP_v1_NQA5mXKS5x7MUUbwQAAAABDCQAAAInpsKAEpoAAAAAA_ehrkVV2W", "version": "2.0-preview", "event": { "date": "2026-07-20", "language": "en", "title": "Nvidia and Japan Launch $2.4B Physical AI Factory for Global Robot Revolution", "description": "Jensen Huang secured major deals in Tokyo to establish a $2.4 billion AI factory, shifting focus from cloud models to embedded machine intelligence. This partnership aims to accelerate Japan's industrial robotics strategy and achieve...", "points": [ "Nvidia and Japan launched a $2.4 billion Physical AI factory initiative." ] }, "english": { "date": "2026-07-20", "language": "en", "title": "Nvidia and Japan Launch $2.4B Physical AI Factory for Global Robot Revolution", "description": "Jensen Huang secured major deals in Tokyo to establish a $2.4 billion AI factory, shifting focus from cloud models to embedded machine intelligence. This partnership aims to accelerate Japan's industrial robotics strategy and achieve...", "points": [ "Nvidia and Japan launched a $2.4 billion Physical AI factory initiative." ] }, "coverage": { "total_coverage": 20, "total_netlocs": 20, "coverage_concentration_index": 0.258503, "first_seen": "2026-07-19T21:28:02+00:00", "last_seen": "2026-07-20T15:22:30+00:00", "most_seen": "2026-07-19T21:28:02+00:00" }, "locations": [ { "continent": "Asia", "region": "East Asia", "country": "Japan", "lat": 35.6895, "lng": 139.6917, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "Tokyo", "entity_type": "GPE", "lat": 35.6895, "lng": 139.69171, "region": "Tokyo", "country": "Japan", "continent": "Asia", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.9996, "sentiment_prob_neutral": 0.0003, "sentiment_prob_negative": 0, "materiality": "medium", "materiality_score": 0.470755, "time_horizon": "years", "forward_looking": "forward", "forward_looking_prob_forward": 0.9579, "forward_looking_prob_not_forward": 0.0421 }, "tickers": [ { "ticker": "NVDA.US", "companyv5_id": "c5-1b5479ea345b", "name": "NVIDIA Corporation", "website": "https://nvidia.com", "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0", "sector": "Information Technology", "industry": "Semiconductors & Semiconductor Equipment", "country_iso": "US", "exchange": "NASDAQ", "mic": "XNAS", "score": 0.994437 } ], "has_tickers": true, "entities": { "PERSON": [ { "name": "Jensen Huang", "mention_count": 2, "confidence": 0.9844 } ], "ORG": [ { "name": "Nvidia", "mention_count": 4, "confidence": 1 } ], "GPE": [ { "name": "Tokyo", "mention_count": 2, "confidence": 1 } ] }, "sentiments": { "GPE": [ { "name": "Tokyo", "sentiment_label": "positive", "sentiment_score": 0.616806789445836 } ], "ORG": [ { "name": "Nvidia", "sentiment_label": "positive", "sentiment_score": 0.9791651801380185 } ], "PERSON": [ { "name": "Jensen Huang", "sentiment_label": "positive", "sentiment_score": 0.5031386906714336 } ] }, "ontologies": [ { "ontology": "plover", "context": "technology", "probability": 0.9999 }, { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9988 } ], "_score": 0.05882352963089943, "_hnsw_distance": 0.5715935230255127, "_cosine_similarity": 0.4284064769744873 }, { "event_id": "2026-07-20_en_US_v1_NYAUbHOS5x7MUTavnIgAABDCQAAAIsSVuAAAAAAAAAA_EcwnN6mq", "version": "2.0-preview", "event": { "date": "2026-07-20", "language": "en", "title": "Microsoft Deploys AMD Helios AI Systems to Expand Azure Infrastructure", "description": "Microsoft and AMD have announced an expanded partnership to deploy the new Helios AI rack-scale system and next-generation EPYC processors on Azure. This strategic move aims to bolster high-performance computing and artificial...", "points": [ "Microsoft and AMD announced an expanded partnership to deploy Helios AI systems on Azure." ] }, "english": { "date": "2026-07-20", "language": "en", "title": "Microsoft Deploys AMD Helios AI Systems to Expand Azure Infrastructure", "description": "Microsoft and AMD have announced an expanded partnership to deploy the new Helios AI rack-scale system and next-generation EPYC processors on Azure. This strategic move aims to bolster high-performance computing and artificial...", "points": [ "Microsoft and AMD announced an expanded partnership to deploy Helios AI systems on Azure." ] }, "coverage": { "total_coverage": 97, "total_netlocs": 73, "coverage_concentration_index": 0.052743, "first_seen": "2026-07-20T05:00:00+00:00", "last_seen": "2026-07-21T04:33:00+00:00", "most_seen": "2026-07-20T13:00:00+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 37.7749, "lng": -122.4194, "source": "llm", "matched_on": "{event.title}+{event.description}" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.9999, "sentiment_prob_neutral": 0.0001, "sentiment_prob_negative": 0, "materiality": "high", "materiality_score": 0.811903, "time_horizon": "months", "forward_looking": "forward", "forward_looking_prob_forward": 0.9149, "forward_looking_prob_not_forward": 0.0851 }, "tickers": [ { "ticker": "MSFT.US", "companyv5_id": "c5-37834c8f281e", "name": "Microsoft Corporation", "website": "https://microsoft.com", "wiki_qid": "Q2283", "isin": "US5949181045", "lei": "INR2EJN1ERAN0W5ZP974", "figi": "BBG000BPH459", "sector": "Information Technology", "industry": "Software", "country_iso": "US", "exchange": "NASDAQ", "mic": "XNAS", "score": 0.999559 } ], "has_tickers": true, "entities": { "ORG": [ { "name": "Microsoft", "mention_count": 9, "confidence": 1 } ], "PRODUCT": [ { "name": "Azure", "mention_count": 11, "confidence": 0.7051 } ] }, "sentiments": { "ORG": [ { "name": "Microsoft", "sentiment_label": "positive", "sentiment_score": 0.4958537597833049 } ], "PRODUCT": [ { "name": "Azure", "sentiment_label": "positive", "sentiment_score": 0.2825303772195621 } ] }, "ontologies": [ { "ontology": "plover", "context": "technology", "probability": 0.9964 }, { "ontology": "nosible", "category": "Business Operations", "event": "Major Partnership Announced", "subcategory": "Sales Efforts", "probability": 0.996 } ], "_score": 0.043478261679410934, "_hnsw_distance": 0.5872632265090942, "_cosine_similarity": 0.41273677349090576 } ], "facets": {}, "query_took_ms": 800, "embedding_ms": 653, "search_ms": 58, "embedding_model": "openai", "models_used": [ "openai" ], "per_index_k": 5000, "min_cosine_similarity": 0.20000000298023224, "matched_tokens": [ "AI chip supply constraints" ], "errors": [] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "view": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" }, "include_vector": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false }, "query": { "type": "string", "description": "Natural-language semantic query. Required: a request without it is a 422 validation_error.", "example": "AI chip supply constraints" }, "limit": { "type": "integer", "description": "Maximum events to return.", "example": 20 }, "embedding_model": { "type": "string", "description": "Embedding model. The supported value is openai.", "example": "openai" }, "include": { "type": "array", "items": { "type": "string" }, "description": "Optional. [\"event_full\"] returns complete records, as view=full does.", "example": [ "event_full" ] }, "semantic_candidates": { "type": "integer", "description": "Candidate budget: the nearest events of the day retrieved from its vector index; total counts those at or above the 0.20 similarity floor. Defaults to 5,000, at most 10,000. It never changes with limit.", "example": 5000 } }, "additionalProperties": true, "required": [ "query" ] }, "examples": { "v2_0_world_semantic_search": { "summary": "For a day", "value": { "query": "AI chip supply constraints" } } } } } } } }, "/api/v2.0/search": { "post": { "operationId": "v2_0_world_search", "summary": "Search events (all time or grouped by date)", "description": "Search the dated event archive with metadata, lexical, semantic, or hybrid retrieval.\n\nUse 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.\n\nfilters keeps only the events that match it: the search, its total and its facets all count those events and no others. It is a JSON object, and an event must satisfy every key of it. A key is a field name, one of and, or and not, or one of the geographic shapes bbox and geo_radius. Search Schema (GET /api/v2.0/search/schema) lists every field with its type (string, number, boolean, date or string_set), its aliases (countries for country, orgs for entity_org, tickers for ticker) and the operators each type takes; fetch it rather than copying a list from here.\n\nA field's condition takes one of three forms. A bare value is equality: {\"sentiment\": \"negative\"}. An array means any of its values: {\"sentiment\": [\"positive\", \"neutral\"]}. An object applies operators, and every operator in it must hold: {\"total_coverage\": {\"gte\": 50, \"lt\": 500}}. A condition is never null (to find events without a value, send {\"missing\": true}), and an operator object is never empty.\n\nStrings are compared exactly on a string field, so write a value as the event carries it: {\"gics_sector\": \"Energy\"} matches and \"energy\" does not (the Ontology directory and a search's facets list the values). contains and prefix ignore case. A string_set field (entity_gpe, entity_loc, entity_org, entity_person, entity_product, ticker, isin, figi, lei, wiki_qid and the *_top3 classification fields) holds several values per event, and every operator on it ignores case and extra spaces. entity_any, also entities, is every entity_* field at once. V1.2's city, required_ontology_below_floor, entity_event, entity_fac, entity_language, entity_law, entity_norp and entity_work_of_art are not fields of V2.0: filtering on one is a 422.\n\nA date is a string in YYYY-MM-DD form, such as \"2026-09-30\": in a condition on the date field (the event's archive date) and in the request's own date window ({\"from\", \"to\", \"include_live\"}). The window chooses which archive days are searched; filters then apply to those days, so a request can carry both. A timestamp, a date without its leading zeros (\"2026-9-1\") and any other form is a 422 validation_error.\n\nWorld Search and date-grouped search answer a filter they cannot read with a 422 validation_error whose message names the path of the problem: an unknown field (with the closest known name), an operator the field's type does not take, a value of the wrong type, a null, an empty and, or or not, a between or bbox written backwards. Event Trend reads and checks the same syntax.\n\nFor a date range\n\nRetrieve bounded semantic results grouped by date, with an optional live overlay for the newest slices.\n\nUse date-grouped search to build a daily time series from one or more anchors over a window of up to 120 days. An anchor is a vector you send (vectors) or a plain-language text the server embeds for you (vector_texts): send up to 64 of either, and vector_aggregate sets how an event's similarities to several of them combine into its score. score_vectors and score_vector_texts add vectors that are only measured, never searched with: each matched event reports its similarity to each of them, so one request can score the same events for a topic and for a direction within it, such as \"shortages are easing\" and \"shortages are worsening\". Each event is a record in the requested view (lite unless view=full) with its group date and scores; groups summarise each day with denominators. include=[\"factor_columns_v1\"] returns the events as columns instead of records. A window that includes days with no data is answered for the days it has, with the others in missing_dates. limit, offset, sort and facets do not apply to a grouped search: per_date_limit is its retrieval budget. The filters are the World Search filter syntax, set out on For all time.\n\nfilters keeps only the events that match it: the search, its total and its facets all count those events and no others. It is a JSON object, and an event must satisfy every key of it. A key is a field name, one of and, or and not, or one of the geographic shapes bbox and geo_radius. Search Schema (GET /api/v2.0/search/schema) lists every field with its type (string, number, boolean, date or string_set), its aliases (countries for country, orgs for entity_org, tickers for ticker) and the operators each type takes; fetch it rather than copying a list from here.\n\nA field's condition takes one of three forms. A bare value is equality: {\"sentiment\": \"negative\"}. An array means any of its values: {\"sentiment\": [\"positive\", \"neutral\"]}. An object applies operators, and every operator in it must hold: {\"total_coverage\": {\"gte\": 50, \"lt\": 500}}. A condition is never null (to find events without a value, send {\"missing\": true}), and an operator object is never empty.\n\nStrings are compared exactly on a string field, so write a value as the event carries it: {\"gics_sector\": \"Energy\"} matches and \"energy\" does not (the Ontology directory and a search's facets list the values). contains and prefix ignore case. A string_set field (entity_gpe, entity_loc, entity_org, entity_person, entity_product, ticker, isin, figi, lei, wiki_qid and the *_top3 classification fields) holds several values per event, and every operator on it ignores case and extra spaces. entity_any, also entities, is every entity_* field at once. V1.2's city, required_ontology_below_floor, entity_event, entity_fac, entity_language, entity_law, entity_norp and entity_work_of_art are not fields of V2.0: filtering on one is a 422.\n\nA date is a string in YYYY-MM-DD form, such as \"2026-09-30\": in a condition on the date field (the event's archive date) and in the request's own date window ({\"from\", \"to\", \"include_live\"}). The window chooses which archive days are searched; filters then apply to those days, so a request can carry both. A timestamp, a date without its leading zeros (\"2026-9-1\") and any other form is a 422 validation_error.\n\nWorld Search and date-grouped search answer a filter they cannot read with a 422 validation_error whose message names the path of the problem: an unknown field (with the closest known name), an operator the field's type does not take, a value of the wrong type, a null, an empty and, or or not, a between or bbox written backwards. Event Trend reads and checks the same syntax.", "tags": [ "EVENT SEARCH" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-search" }, "x-nosible-reference-pages": [ "v2.0-world-search", "v2.0-world-grouped-search" ], "security": [ { "BearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "total": { "type": "integer", "description": "Events in the result set, the same on every page (limit and offset only choose the slice). Metadata and lexical search: every matching event. Semantic and hybrid search: every event that passes the filters and window and has a cosine similarity of at least 0.20 to the query, in every semantic_filter_mode, when the window and filters admit at most 500,000 archive events; above that, those among the semantic_candidates nearest to the query (5,000 unless sent)." }, "total_exact": { "type": "boolean", "description": "true when total counts every match: every event the window and filters admit was scored. false when the window and filters admit more than 500,000 archive events and the vector index returned its whole candidate budget, so more events above the similarity floor may exist beyond it: narrow the window or filters to count them all, or send a larger semantic_candidates to count further." }, "count": { "type": "integer", "description": "Events in this page." }, "limit": { "type": "integer", "description": "Page size applied." }, "offset": { "type": "integer", "description": "Events skipped." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." }, "_score": { "type": "number", "description": "Overall retrieval score." }, "_lexical_score": { "type": "number", "description": "Lexical component of the score (lexical and hybrid search)." }, "_semantic_score": { "type": "number", "description": "Cosine similarity to the query (semantic and hybrid search); at least 0.20." }, "_retrieval": { "type": "string", "description": "Retrieval path that found the event." }, "_search_date": { "type": "string", "format": "date", "description": "Archive date the record was read from." } } }, "description": "The events, as lite records unless view=full (About records on Event details lists both). A full record adds provenance, availability, triples, each ticker's why and v2_preview_success." }, "facets": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Counts for the fields requested in facets, over the events total counts; empty when none were requested." }, "query_took_ms": { "type": "integer", "description": "Total time in milliseconds." }, "embedding_ms": { "type": "integer", "description": "Time spent embedding the query." }, "search_ms": { "type": "integer", "description": "Time spent searching." }, "date_window": { "type": "object", "properties": { "from": { "type": "string" }, "to": { "type": "string" }, "include_live": { "type": "boolean" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "from, to, include_live and archive_cutoff of the search." }, "missing_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "description": "Days of the window with no data, in date order, as Event Trends lists them; empty when the window has every day. The search covers the days the archive has." }, "search_type": { "type": "string", "description": "Retrieval mode used." }, "errors": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Non-fatal stage errors; empty when none." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." }, "total_capped_at": { "type": "integer", "description": "Only when total_exact is false: the candidate budget that capped total." } }, "additionalProperties": true }, { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "revision": { "type": "integer", "description": "Revision of the response format." }, "search_type": { "type": "string", "description": "semantic." }, "group_by": { "type": "string", "description": "Grouping dimension: date." }, "vector_aggregate": { "type": "string", "description": "How an event's similarities to several anchor vectors combine into its score: max, mean or softmax." }, "per_date_limit": { "type": "integer", "description": "Candidates retrieved per anchor vector and date." }, "min_score": { "type": "number", "description": "Score floor applied." }, "total": { "type": "integer", "description": "Matched events across all dates." }, "candidate_events": { "type": "integer", "description": "Candidates scored across all dates." }, "response_event_limit": { "type": "integer", "description": "Most events one response may carry: 5,000 lite records or 1,000 full ones (fewer with many anchor vectors). Above it the request is a 422 grouped_response_too_large; shorten the window or raise min_score." }, "resolved_vectors": { "type": "array", "items": { "type": "array", "items": { "type": "number" } }, "nullable": true, "description": "The anchor vectors embedded from vector_texts, to send as vectors in later requests; null when vectors were sent." }, "resolved_score_vectors": { "type": "array", "items": { "type": "array", "items": { "type": "number" } }, "nullable": true, "description": "The same for score_vector_texts; null when none were sent." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." }, "date": { "type": "string", "format": "date", "description": "The group (archive date) of the event." }, "score": { "type": "number", "description": "Aggregate score over the anchor vectors." }, "vector_scores": { "type": "array", "items": { "type": "number" }, "description": "Cosine similarity to each anchor vector." }, "score_vector_scores": { "type": "array", "items": { "type": "number" }, "description": "Cosine similarity to each score vector; empty without score vectors." } } }, "description": "Matched events, flat, as records in the requested view with their per-result fields; join them to groups by date." }, "groups": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "date": { "type": "string", "format": "date", "description": "The date." }, "matched_count": { "type": "integer", "description": "Matched events on the date." }, "candidate_count": { "type": "integer", "description": "Candidates scored on the date." }, "candidate_retrieval_hits": { "type": "integer", "description": "Candidates the vector index returned for the date, before deduplication across anchor vectors." }, "truncated": { "type": "boolean", "description": "true when an anchor's candidate budget (per_date_limit) filled with its farthest candidate still at or above min_score, so events above min_score may have been left out: raise per_date_limit. false means no event of the date above min_score was left out (by the index's ranking)." }, "eligible": { "type": "object", "additionalProperties": true, "description": "All events on the date that pass the filters, matched or not: count, total_coverage, total_netlocs, total_materiality and total_sentiment_weight. Use them as denominators." } } }, "description": "One summary per date scanned." }, "date_window": { "type": "object", "properties": { "from": { "type": "string" }, "to": { "type": "string" }, "include_live": { "type": "boolean" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "from, to, include_live and archive_cutoff." }, "missing_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "description": "Days of the window with no data, in date order, as Event Trends lists them; empty when the window has every day. They have no groups: they are not zero activity." }, "stats": { "type": "object", "properties": { "dates_requested": { "type": "number" }, "dates_scanned": { "type": "number" }, "eligible_events": { "type": "number" }, "candidate_retrieval_hits": { "type": "number" }, "candidate_events": { "type": "number" }, "matched_events": { "type": "number" }, "truncated_dates": { "type": "number" }, "truncated": { "type": "boolean" } }, "additionalProperties": true, "description": "Totals over the dates: dates requested and scanned, eligible, candidate and matched events, and truncated_dates and truncated, which count the dates where groups[].truncated is true." }, "timing_ms": { "type": "object", "properties": { "total": { "type": "number" } }, "additionalProperties": true, "description": "Server time in milliseconds." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." } }, "additionalProperties": true } ] }, "examples": { "allTime": { "value": { "schema": "nosible_world_search_response_v1", "view": "lite", "total": 3256, "total_exact": true, "count": 20, "limit": 20, "offset": 0, "events": [ { "event_id": "2026-09-21_en_US_v1_gPExQS0QSioLohBAYAAAARiUqdcABgAAAaDnIAAAAAA_5M9s6V6-", "version": "2.0-preview", "event": { "date": "2026-09-21", "language": "en", "title": "Oil Supply Increases Amid Trump UN General Assembly Diplomacy", "description": "Global oil flows are rising as US President Donald Trump prepares for the United Nations General Assembly. This diplomatic event coincides with shifting energy markets, creating a busy week for international negotiations. The...", "points": [ "Global oil flows are rising as US President Donald Trump prepares for the United Nations General Assembly." ] }, "english": { "date": "2026-09-21", "language": "en", "title": "Oil Supply Increases Amid Trump UN General Assembly Diplomacy", "description": "Global oil flows are rising as US President Donald Trump prepares for the United Nations General Assembly. This diplomatic event coincides with shifting energy markets, creating a busy week for international negotiations. The...", "points": [ "Global oil flows are rising as US President Donald Trump prepares for the United Nations General Assembly." ] }, "coverage": { "total_coverage": 36, "total_netlocs": 4, "coverage_concentration_index": 0.028488, "first_seen": "2026-09-21T03:35:19+00:00", "last_seen": "2026-09-21T07:43:44+00:00", "most_seen": "2026-09-21T04:35:19+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 40.7128, "lng": -74.006, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "US", "entity_type": "GPE", "lat": 39.76, "lng": -98.5, "region": null, "country": "United States", "continent": "North America", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.5307, "sentiment_prob_neutral": 0.4683, "sentiment_prob_negative": 0.001, "materiality": "medium", "materiality_score": 0.59424, "time_horizon": "days", "forward_looking": "forward", "forward_looking_prob_forward": 0.6792, "forward_looking_prob_not_forward": 0.3208 }, "tickers": [], "has_tickers": false, "entities": { "PERSON": [ { "name": "Donald Trump", "mention_count": 2, "confidence": 1 } ], "ORG": [ { "name": "United Nations General Assembly", "mention_count": 2, "confidence": 0.791 } ], "GPE": [ { "name": "US", "mention_count": 2, "confidence": 1 } ] }, "sentiments": { "GPE": [ { "name": "US", "sentiment_label": "positive", "sentiment_score": 0.3424537212425458 } ], "ORG": [ { "name": "United Nations General Assembly", "sentiment_label": "positive", "sentiment_score": 0.9824159513238833 } ], "PERSON": [ { "name": "Donald Trump", "sentiment_label": "positive", "sentiment_score": 0.4864705716179198 } ] }, "ontologies": [ { "ontology": "asset_class", "main_class": "Commodities", "sub_class": "Energy", "probability": 0.9954 }, { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9946 } ], "_score": 2.9367907009614904, "_lexical_score": 7, "_semantic_score": 0.515884192460192, "_retrieval": "global_hnsw_hydrated_cosine", "_search_date": "2026-09-21" }, { "event_id": "2026-09-24_en_SA_v1_MfAUaGsQSioLohBAoAAAARgzudcAAAAAAaAAAAAAAAA_0cxLWw5p", "version": "2.0-preview", "event": { "date": "2026-09-24", "language": "en", "title": "Houthi Missile Attack on Saudi Arabia Sends Oil Prices Surging", "description": "Oil prices jumped approximately four percent to a one-week high following Houthi missile attacks on Saudi Arabia. The strikes revived fears of supply disruptions in the Middle East, pushing diesel costs to record levels. This escalation...", "points": [ "Oil prices surged approximately four percent to a one-week high following Houthi missile attacks on Saudi Arabia." ] }, "english": { "date": "2026-09-24", "language": "en", "title": "Houthi Missile Attack on Saudi Arabia Sends Oil Prices Surging", "description": "Oil prices jumped approximately four percent to a one-week high following Houthi missile attacks on Saudi Arabia. The strikes revived fears of supply disruptions in the Middle East, pushing diesel costs to record levels. This escalation...", "points": [ "Oil prices surged approximately four percent to a one-week high following Houthi missile attacks on Saudi Arabia." ] }, "coverage": { "total_coverage": 151, "total_netlocs": 54, "coverage_concentration_index": 0.026756, "first_seen": "2026-09-24T03:02:27+00:00", "last_seen": "2026-09-24T22:53:00+00:00", "most_seen": "2026-09-24T15:57:57+00:00" }, "locations": [ { "continent": "Asia", "region": "Middle East", "country": "Saudi Arabia", "lat": 23.8859, "lng": 45.0792, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "Saudi Arabia", "entity_type": "GPE", "lat": 25, "lng": 45, "region": null, "country": "Saudi Arabia", "continent": "Asia", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.7283, "sentiment_prob_neutral": 0.0038, "sentiment_prob_negative": 0.2679, "materiality": "high", "materiality_score": 0.889298, "time_horizon": "intraday", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.0076, "forward_looking_prob_not_forward": 0.9924 }, "tickers": [], "has_tickers": false, "entities": { "ORG": [ { "name": "Houthi", "mention_count": 5, "confidence": 1 } ], "GPE": [ { "name": "Saudi Arabia", "mention_count": 5, "confidence": 1 } ], "LOC": [ { "name": "Middle East", "mention_count": 3, "confidence": 0.999 } ], "PRODUCT": [ { "name": "Brent", "mention_count": 1, "confidence": 0.6943 } ] }, "sentiments": { "GPE": [ { "name": "Saudi Arabia", "sentiment_label": "neutral", "sentiment_score": -0.7662446912346574 } ], "LOC": [ { "name": "Middle East", "sentiment_label": "negative", "sentiment_score": -0.9553617139460178 } ], "ORG": [ { "name": "Houthi", "sentiment_label": "neutral", "sentiment_score": -0.7190869668386362 } ], "PRODUCT": [ { "name": "Brent", "sentiment_label": "neutral", "sentiment_score": -0.5649424015062161 } ] }, "ontologies": [ { "ontology": "asset_class", "main_class": "Commodities", "sub_class": "Energy", "probability": 0.996 }, { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9935 } ], "_score": 2.4498445091424097, "_lexical_score": 5.5, "_semantic_score": 0.45163062559230366, "_retrieval": "global_hnsw_hydrated_cosine", "_search_date": "2026-09-24" } ], "facets": {}, "query_took_ms": 385, "embedding_ms": 0, "search_ms": 197, "date_window": { "from": "2026-09-20", "to": "2026-09-26", "include_live": false, "archive_cutoff": "2026-10-09" }, "missing_dates": [], "search_type": "hybrid", "errors": [] } }, "byDate": { "value": { "schema": "nosible_world_factor_search_v1", "view": "lite", "revision": 3, "search_type": "semantic", "group_by": "date", "vector_aggregate": "max", "per_date_limit": 20, "min_score": 0.35, "total": 40, "candidate_events": 40, "response_event_limit": 5000, "resolved_vectors": [ [ -0.0008276162552647293, 0.01946614496409893, -0.007597288116812706, 0.003478276776149869, 0.029839953407645226, -0.021830763667821884, -0.0007971050799824297, 0.035270944237709045, 0.011800206266343594, 0.004828397184610367, 0.007177759427577257, 0.01419533509761095 ] ], "resolved_score_vectors": null, "events": [ { "event_id": "2026-09-20_en_US_v1_NJAIIACS5x7MUUbwQAAQAEJlcAAAInpsKAEp4AAAAAA_rZ6MBbpr", "version": "2.0-preview", "event": { "date": "2026-09-20", "language": "en", "title": "US and China vie for AI dominance, with semiconductor chips as the key battleground.", "description": "The United States and China are engaged in a strategic competition for the future of artificial intelligence, with semiconductor chips serving as a critical battlefield. Reports indicate that demand for AI computing equipment in China...", "points": [ "The United States and China are engaged in strategic competition for AI dominance with semiconductor chips as the key battleground." ] }, "english": { "date": "2026-09-20", "language": "en", "title": "US and China vie for AI dominance, with semiconductor chips as the key battleground.", "description": "The United States and China are engaged in a strategic competition for the future of artificial intelligence, with semiconductor chips serving as a critical battlefield. Reports indicate that demand for AI computing equipment in China...", "points": [ "The United States and China are engaged in strategic competition for AI dominance with semiconductor chips as the key battleground." ] }, "coverage": { "total_coverage": 11, "total_netlocs": 9, "coverage_concentration_index": 0.22146, "first_seen": "2026-09-20T07:43:47+00:00", "last_seen": "2026-09-20T18:48:22+00:00", "most_seen": "2026-09-20T18:48:22+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 38, "lng": -97, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "United States", "entity_type": "GPE", "lat": 39.76, "lng": -98.5, "region": null, "country": "United States", "continent": "North America", "source": "ner" } ], "signals": { "sentiment": "neutral", "sentiment_prob_positive": 0.0197, "sentiment_prob_neutral": 0.9515, "sentiment_prob_negative": 0.0287, "materiality": "medium", "materiality_score": 0.455535, "time_horizon": "years", "forward_looking": "forward", "forward_looking_prob_forward": 0.9466, "forward_looking_prob_not_forward": 0.0534 }, "tickers": [], "has_tickers": false, "entities": { "ORG": [ { "name": "Huawei", "mention_count": 4, "confidence": 0.9995 } ], "GPE": [ { "name": "United States", "mention_count": 2, "confidence": 1 } ], "PERSON": [ { "name": "Donald Trump", "mention_count": 1, "confidence": 1 } ] }, "sentiments": { "GPE": [ { "name": "United States", "sentiment_label": "neutral", "sentiment_score": -0.29855982136894194 } ], "ORG": [ { "name": "Huawei", "sentiment_label": "neutral", "sentiment_score": 0.12253581527777607 } ], "PERSON": [ { "name": "Donald Trump", "sentiment_label": "neutral", "sentiment_score": -0.5040160936008261 } ] }, "ontologies": [ { "ontology": "media_frame", "label": "Conflict", "probability": 0.9997 }, { "ontology": "iab", "tier_1": "Technology & Computing", "tier_2": "Artificial Intelligence", "tier_3": "Artificial Intelligence", "tier_4": "Artificial Intelligence", "probability": 0.996 } ], "date": "2026-09-20", "score": 0.5264115778101044, "vector_scores": [ 0.5264115778101044 ], "score_vector_scores": [] }, { "event_id": "2026-09-21_en_KR_v1_TYAUbHuS5x7MUUbwQAAAABBAUAAAIqMjWAAAAAAAAAA_hifOSy2S", "version": "2.0-preview", "event": { "date": "2026-09-21", "language": "en", "title": "Samsung to Double HBM4 Chip Output in 2027 Amid Surging AI Demand", "description": "Samsung Electronics plans to more than double its production of high-bandwidth memory chips, specifically the HBM4 family, by 2027. This strategic expansion responds to intense global demand for artificial intelligence hardware. The...", "points": [ "Samsung Electronics plans to more than double its HBM4 chip output by 2027 to meet surging AI demand." ] }, "english": { "date": "2026-09-21", "language": "en", "title": "Samsung to Double HBM4 Chip Output in 2027 Amid Surging AI Demand", "description": "Samsung Electronics plans to more than double its production of high-bandwidth memory chips, specifically the HBM4 family, by 2027. This strategic expansion responds to intense global demand for artificial intelligence hardware. The...", "points": [ "Samsung Electronics plans to more than double its HBM4 chip output by 2027 to meet surging AI demand." ] }, "coverage": { "total_coverage": 7, "total_netlocs": 7, "coverage_concentration_index": 0.336504, "first_seen": "2026-09-21T03:09:14+00:00", "last_seen": "2026-09-21T14:26:27+00:00", "most_seen": "2026-09-21T03:09:14+00:00" }, "locations": [ { "continent": "Asia", "region": "East Asia", "country": "South Korea", "lat": 37.5665, "lng": 126.978, "source": "llm", "matched_on": "{event.title}+{event.description}" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.9993, "sentiment_prob_neutral": 0.0007, "sentiment_prob_negative": 0, "materiality": "medium", "materiality_score": 0.487581, "time_horizon": "years", "forward_looking": "forward", "forward_looking_prob_forward": 1, "forward_looking_prob_not_forward": 0 }, "tickers": [ { "ticker": "005930.KO", "companyv5_id": "c5-236e59b6ecb9", "name": "Samsung Electronics Co Ltd", "website": "https://samsung.com", "wiki_qid": "Q20718", "isin": "KR7005930003", "lei": "9884007ER46L6N7EI764", "figi": "BBG001S6K037", "sector": "Information Technology", "industry": "Technology Hardware, Storage & Peripherals", "country_iso": "KR", "exchange": "KO", "mic": "XKRX", "score": 0.965927 } ], "has_tickers": true, "entities": { "ORG": [ { "name": "Samsung", "mention_count": 5, "confidence": 1 } ], "PRODUCT": [ { "name": "HBM4", "mention_count": 5, "confidence": 0.999 } ] }, "sentiments": { "ORG": [ { "name": "Samsung", "sentiment_label": "positive", "sentiment_score": 0.48930721400874483 } ], "PRODUCT": [ { "name": "HBM4", "sentiment_label": "positive", "sentiment_score": 0.2701771970670514 } ] }, "ontologies": [ { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9997 }, { "ontology": "plover", "context": "technology", "probability": 0.999 } ], "date": "2026-09-21", "score": 0.48040262375007725, "vector_scores": [ 0.48040262375007725 ], "score_vector_scores": [] } ], "groups": [ { "date": "2026-09-20", "matched_count": 20, "candidate_count": 20, "candidate_retrieval_hits": 20, "truncated": true, "eligible": { "count": 6920, "total_coverage": 205322, "total_netlocs": 132409, "total_materiality": 3474.7918740808964, "total_sentiment_weight": 3895 } }, { "date": "2026-09-21", "matched_count": 20, "candidate_count": 20, "candidate_retrieval_hits": 20, "truncated": true, "eligible": { "count": 13841, "total_coverage": 380107, "total_netlocs": 248984, "total_materiality": 7045.024449124932, "total_sentiment_weight": 7086 } } ], "date_window": { "from": "2026-09-20", "to": "2026-09-21", "include_live": false, "archive_cutoff": "2026-10-09" }, "missing_dates": [], "stats": { "dates_requested": 2, "dates_scanned": 2, "eligible_events": 20761, "candidate_retrieval_hits": 40, "candidate_events": 40, "matched_events": 40, "truncated_dates": 2, "truncated": true }, "timing_ms": { "total": 697 } } } } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.\n\ninvalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.\n\napi_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.\n\naccess_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.\n\nnot_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.\n\ncursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.\n\nvalidation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.\n\ngrouped_response_too_large: The request exceeds the bounded grouped response budget; shorten the window or raise the score floor.", "x-nosible-error-codes": [ "validation_error", "grouped_response_too_large" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.\n\nrate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.\n\nbackend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.\n\nbackend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.\n\napi_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.\n\ngrouped_search_busy: The grouped-search worker pool is full; retry after backoff.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable", "grouped_search_busy" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.\n\nbackend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "view": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" }, "include_vector": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false }, "search_type": { "type": "string", "description": "metadata, lexical, semantic, or hybrid. Omitted, it is hybrid with q, semantic with vector and metadata otherwise. lexical needs q, and semantic and hybrid need q or vector: sent without them, the request is a 422 validation_error.", "example": "hybrid" }, "q": { "type": "string", "description": "Text query. Used for lexical, semantic, and hybrid retrieval.", "example": "oil supply disruption" }, "date": { "type": "object", "additionalProperties": true, "description": "Optional inclusive window {from, to, include_live}, each date written YYYY-MM-DD; include_live opts into the newest slices. Set from and to explicitly for reproducible queries.", "example": { "from": "2026-07-01", "to": "2026-07-20", "include_live": true } }, "filters": { "type": "object", "additionalProperties": true, "description": "Keeps only the events that match it, in the results, in total and in facets. A JSON object of field conditions, combined with and, or and not, with bbox and geo_radius for places: {\"sentiment\": \"negative\", \"total_coverage\": {\"gte\": 50}}. Filter syntax below lists every operator; Search Schema lists the fields.", "example": { "gics_sector": "Energy" } }, "limit": { "type": "integer", "description": "Number of events to return: 50 unless sent, at most 10,000 (a larger value is capped at 10,000). Page further with offset.", "example": 20 }, "offset": { "type": "integer", "description": "Number of matching events to skip before returning the page.", "example": 0 }, "vector": { "type": "array", "items": { "type": "number" }, "description": "Caller-supplied embedding for semantic retrieval. Its length must match the configured HNSW dimension." }, "query_vector": { "type": "array", "items": { "type": "number" }, "description": "Alias for vector." }, "sort": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Sort rules such as [{ by: 'total_coverage', desc: true }].", "example": [ { "by": "total_coverage", "desc": true } ] }, "facets": { "type": "array", "items": { "type": "string" }, "description": "Field names (or their aliases) to count over the events the search returns: the same events as total, live days included. Counts answer under each field's canonical name.", "example": [ "country", "sentiment" ] }, "embedding_model": { "type": "string", "description": "Embedding model for semantic or hybrid retrieval. The supported value is openai.", "example": "openai" }, "semantic_filter_mode": { "type": "string", "description": "Semantic filter strategy: auto, usearch, or exact.", "example": "auto" }, "max_dates": { "type": "integer", "description": "Maximum archive dates the planner may visit.", "example": 30 }, "explain": { "type": "boolean", "description": "Include retrieval planning details where supported.", "example": false }, "query": { "type": "string", "description": "Alias for q. Use one name consistently in a client; q is the canonical short form.", "example": "oil supply disruption" }, "include": { "type": "array", "items": { "type": "string" }, "description": "[\"explain\"] adds retrieval planning details, as explain=true does.", "example": [ "explain" ] }, "exact_vector_max_candidates": { "type": "integer", "description": "Maximum metadata-qualified candidates to score exactly when semantic_filter_mode is exact.", "example": 100000 }, "semantic_candidates": { "type": "integer", "description": "Candidate budget of semantic and hybrid search when the window and filters admit more than 500,000 archive events (and on each live day's own index with include_live): the nearest events retrieved before the exact rerank; total counts those at or above the 0.20 similarity floor that pass the filters and window. When they admit at most 500,000, every one is scored exactly and the budget does not apply. Defaults to 5,000, at most 50,000. It never changes with limit or offset.", "example": 5000 } }, "additionalProperties": true }, { "type": "object", "properties": { "view": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" }, "include_vector": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false }, "group_by": { "type": "string", "description": "Grouping dimension; currently date.", "example": "date", "enum": [ "date" ] }, "vectors": { "type": "array", "items": { "type": "array", "items": { "type": "number" } }, "description": "Anchor embeddings: 1 to 64 vectors, each exactly 3,072 numbers (text-embedding-3-large, the embedding oai_vector returns). Send vectors or vector_texts, not both; one of them is required." }, "vector_texts": { "type": "array", "items": { "type": "string" }, "description": "Plain-language anchors the server embeds in place of vectors (text-embedding-3-large): 1 to 64 texts, each 1 to 8,192 bytes of UTF-8 once trimmed; a blank or longer text is rejected. The embeddings come back in resolved_vectors, to send as vectors later without embedding again. Send vector_texts or vectors, not both; one of them is required.", "example": [ "AI chip supply constraints" ] }, "vector_aggregate": { "type": "string", "description": "How an event's similarities to several anchors combine into its score: max (the default: its best match), mean (the average) or softmax (an average weighted towards the best matches, between mean and max). With one anchor all three give the same score.", "example": "max" }, "score_vectors": { "type": "array", "items": { "type": "array", "items": { "type": "number" } }, "description": "Vectors to measure, not search with: up to 64, each 3,072 numbers. They widen nothing and change neither score nor which events match; each event's score_vector_scores lists its cosine similarity to each one, in request order. Send score_vectors or score_vector_texts, not both." }, "score_vector_texts": { "type": "array", "items": { "type": "string" }, "description": "Plain-language statements the server embeds in place of score_vectors, under the same limits as vector_texts (up to 64 texts of 8,192 bytes). The embeddings come back in resolved_score_vectors.", "example": [ "chip shortages are easing", "chip shortages are worsening" ] }, "date": { "type": "object", "additionalProperties": true, "description": "Inclusive date window of up to 120 days with data; from and to are both required, written YYYY-MM-DD. Days with no data are listed in missing_dates. Set include_live=true to include the newest live days.", "example": { "from": "2026-09-15", "to": "2026-09-17", "include_live": true } }, "filters": { "type": "object", "additionalProperties": true, "description": "Only events that match it are searched, matched and counted in each group's eligible totals. The World Search filter syntax: field conditions combined with and, or and not, with bbox and geo_radius for places. Filter syntax on For all time lists every operator; Search Schema lists the fields.", "example": { "language": "en" } }, "include": { "type": "array", "items": { "type": "string" }, "description": "Optional. [\"factor_columns_v1\"] returns the events as columns of values instead of records; view does not apply to it. No other value is needed.", "example": [ "factor_columns_v1" ] }, "per_date_limit": { "type": "integer", "description": "Candidates retrieved for each anchor and date: from 1 to 10,000, defaulting to 1,000. Dates × anchors × per_date_limit may not exceed 2,000,000 retrievals, and that product × (anchors + score vectors) may not exceed 50,000,000 exact scores: narrow the window, the anchors, the score vectors or per_date_limit.", "example": 1000 }, "min_score": { "type": "number", "description": "Inclusive floor on an event's score, from -1 to 1; defaults to 0.2.", "example": 0.35 } }, "additionalProperties": true, "required": [ "group_by", "date" ] } ] }, "examples": { "v2_0_world_search": { "summary": "For all time", "value": { "search_type": "hybrid", "q": "oil supply disruption", "date": { "from": "2026-09-20", "to": "2026-09-26" }, "limit": 20 } }, "v2_0_world_grouped_search": { "summary": "For a date range", "value": { "group_by": "date", "vector_texts": [ "AI chip supply constraints" ], "date": { "from": "2026-09-20", "to": "2026-09-21" }, "min_score": 0.35, "per_date_limit": 20 } } } } } } } }, "/api/v2.0/event-trends": { "post": { "operationId": "v2_0_world_event_trends", "summary": "Create Event Trend", "description": "Aggregate semantic event matches into a compact, dense time series on the server.\n\nUse Event Trend for a semantic signal over time without downloading the matching events. Every event of the window whose similarity to the query is at least min_similarity is counted, so a bucket's count matches a search of its days at the same floor, buckets compare across days, weeks and quarters, and a group's count equals the count of the same trend filtered to that group's value. Days without data are listed in missing_dates (for example the archive gap of 2026-09-27 to 2026-10-07, or today before its first events): read a bucket with missing true as no data, not as zero events, and use days and missing_days to compare buckets that do not cover the same number of days. A partial bucket covers only part of its interval: the first can start before from, the last can run past to, and the bucket holding today is still being filled. truncated is true only for a topic that matches a large share of the window, where the search stopped at its ceiling of 250,000 events checked: that bucket's counts are then lower bounds. The trend's id is valid until expires_at, 15 minutes after the trend was last created; creating the same trend again returns the same id and serves it for another 15 minutes.\n\nfilters keeps only the events that match it: the search, its total and its facets all count those events and no others. It is a JSON object, and an event must satisfy every key of it. A key is a field name, one of and, or and not, or one of the geographic shapes bbox and geo_radius. Search Schema (GET /api/v2.0/search/schema) lists every field with its type (string, number, boolean, date or string_set), its aliases (countries for country, orgs for entity_org, tickers for ticker) and the operators each type takes; fetch it rather than copying a list from here.\n\nA field's condition takes one of three forms. A bare value is equality: {\"sentiment\": \"negative\"}. An array means any of its values: {\"sentiment\": [\"positive\", \"neutral\"]}. An object applies operators, and every operator in it must hold: {\"total_coverage\": {\"gte\": 50, \"lt\": 500}}. A condition is never null (to find events without a value, send {\"missing\": true}), and an operator object is never empty.\n\nStrings are compared exactly on a string field, so write a value as the event carries it: {\"gics_sector\": \"Energy\"} matches and \"energy\" does not (the Ontology directory and a search's facets list the values). contains and prefix ignore case. A string_set field (entity_gpe, entity_loc, entity_org, entity_person, entity_product, ticker, isin, figi, lei, wiki_qid and the *_top3 classification fields) holds several values per event, and every operator on it ignores case and extra spaces. entity_any, also entities, is every entity_* field at once. V1.2's city, required_ontology_below_floor, entity_event, entity_fac, entity_language, entity_law, entity_norp and entity_work_of_art are not fields of V2.0: filtering on one is a 422.\n\nA date is a string in YYYY-MM-DD form, such as \"2026-09-30\": in a condition on the date field (the event's archive date) and in the request's own date window ({\"from\", \"to\", \"include_live\"}). The window chooses which archive days are searched; filters then apply to those days, so a request can carry both. A timestamp, a date without its leading zeros (\"2026-9-1\") and any other form is a 422 validation_error.\n\nWorld Search and date-grouped search answer a filter they cannot read with a 422 validation_error whose message names the path of the problem: an unknown field (with the closest known name), an operator the field's type does not take, a value of the wrong type, a null, an empty and, or or not, a between or bbox written backwards. Event Trend reads and checks the same syntax.", "tags": [ "EVENT TRENDS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-event-trends" }, "x-nosible-reference-pages": [ "v2.0-world-event-trends" ], "security": [ { "BearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "description": "Handle for Get Events in Trend, valid until expires_at." }, "expires_at": { "type": "string", "format": "date-time", "description": "When the handle expires (UTC): 15 minutes after the trend was last created. Creating the same trend again returns the same id and moves this 15 minutes on. A trend that includes a day still being filled gets a new id once that day's data changes." }, "approximate": { "type": "boolean", "description": "Always true: the search stops once the least similar candidates it checks no longer reach min_similarity, so an event ranked below all of them would be missed. Checked against an exact search of single days, the counts matched event for event." }, "missing_dates": { "type": "array", "items": { "type": "string", "format": "date" }, "description": "Dates of the window without data, in order. Their buckets count nothing because there is nothing to count." }, "buckets": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "start": { "type": "string", "format": "date", "description": "First day of the bucket's interval (a Monday for week buckets); the first bucket can start before from." }, "event_count": { "type": "integer", "description": "Events of the bucket at or above min_similarity." }, "coverage_sum": { "type": "integer", "description": "Sum of the events' coverage.total_netlocs: the distinct source sites that reported them, as in V1.2." }, "similarity_sum": { "type": "number", "description": "Sum of the events' similarity to the query; divide by event_count for their mean similarity." }, "truncated": { "type": "boolean", "description": "True only when the search stopped at its ceiling (250,000 events checked) before reaching min_similarity for this bucket: its counts are then lower bounds." }, "partial": { "type": "boolean", "description": "True when the bucket covers only part of its interval: it starts before from, runs past to, or holds today (UTC), which is still being filled." }, "days": { "type": "integer", "description": "Days of the bucket inside the window [from, to)." }, "missing_days": { "type": "integer", "description": "Of those days, the ones without data (listed in missing_dates)." }, "missing": { "type": "boolean", "description": "True when none of the bucket's days has data: its zeros mean no data, not no events." }, "groups": { "type": "object", "additionalProperties": true, "description": "With group_by only: event_count, coverage_sum and similarity_sum per group value." } } }, "description": "The time series, one bucket per interval in date order, empty buckets included." } }, "additionalProperties": true }, "example": { "id": "tr_73a9d3a126f65e70", "expires_at": "2026-10-11T07:42:12Z", "approximate": true, "missing_dates": [ "2026-09-27", "2026-09-28", "2026-09-29", "2026-09-30", "2026-10-01", "2026-10-02", "2026-10-03", "2026-10-04", "2026-10-05", "2026-10-06", "2026-10-07" ], "buckets": [ { "start": "2026-09-21", "event_count": 330, "coverage_sum": 12974, "similarity_sum": 133.538548, "truncated": false, "partial": false, "days": 7, "missing_days": 1, "missing": false, "groups": { "negative": { "event_count": 188, "coverage_sum": 9526, "similarity_sum": 77.283284 }, "neutral": { "event_count": 63, "coverage_sum": 1544, "similarity_sum": 24.92245 }, "positive": { "event_count": 79, "coverage_sum": 1904, "similarity_sum": 31.332814 } } }, { "start": "2026-09-28", "event_count": 0, "coverage_sum": 0, "similarity_sum": 0, "truncated": false, "partial": false, "days": 7, "missing_days": 7, "missing": true, "groups": {} }, { "start": "2026-10-05", "event_count": 141, "coverage_sum": 3474, "similarity_sum": 57.019105, "truncated": false, "partial": true, "days": 6, "missing_days": 3, "missing": false, "groups": { "negative": { "event_count": 73, "coverage_sum": 1840, "similarity_sum": 30.602134 }, "neutral": { "event_count": 32, "coverage_sum": 776, "similarity_sum": 12.504895 }, "positive": { "event_count": 36, "coverage_sum": 858, "similarity_sum": 13.912075 } } } ] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "string", "description": "The topic to measure, in any language, up to 8 KB. Events are compared with it by the cosine similarity of their text-embedding-3-large embeddings.", "example": "openai lawsuits" }, "from": { "type": "string", "format": "date", "description": "Inclusive UTC start date, on or after the archive's first day (2010-01-01). A date that is not a calendar date (such as 2026-02-30) is a 422.", "example": "2026-09-21" }, "to": { "type": "string", "format": "date", "description": "Exclusive UTC end date, at most tomorrow (UTC). A trend has at most 12,000 buckets.", "example": "2026-10-11" }, "interval": { "type": "string", "description": "Bucket size: day (the default), week (Monday to Sunday), month or quarter (calendar quarters).", "example": "week" }, "min_similarity": { "type": "number", "description": "Similarity floor from -1 to 1, inclusive; defaults to 0.35. Every event of the window at or above it is counted.", "example": 0.35 }, "filters": { "type": "object", "additionalProperties": true, "description": "Only events that match it are counted. The World Search filter syntax, set out in Filter syntax below, and type-checked in the same way: an unknown field, an operator the field's type does not take, a value of the wrong type or an empty and, or or not is a 422.", "example": {} }, "group_by": { "type": "string", "description": "Split every bucket by one field: sentiment, materiality or time_horizon (the event's signals); country or region (the event's own place, its first location); language (its original language); iptc_topic (its most probable IPTC Media Topic, level 1); gics_sector (its most probable GICS sector); or nosible_category (its most probable NOSIBLE category). Events without a value are grouped as unknown.", "example": "sentiment" } }, "additionalProperties": true, "required": [ "query", "from", "to" ] }, "examples": { "v2_0_world_event_trends": { "summary": "Create Event Trend", "value": { "query": "openai lawsuits", "from": "2026-09-21", "to": "2026-10-11", "interval": "week", "group_by": "sentiment" } } } } } } } }, "/api/v2.0/event-trends/{id}/events": { "get": { "operationId": "v2_0_world_event_trend_events", "summary": "Get Events in Trend", "description": "Page through the event evidence behind one recent Event Trend bucket.\n\nUse this route after Event Trend to read the events behind a bucket or one of its groups, most similar first. The trend's id is valid until its expires_at, 15 minutes after the trend was last created; after that this route answers 404 trend_not_found. Create the trend again to continue: while the data is unchanged it returns the same id.", "tags": [ "EVENT TRENDS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-event-trend-events" }, "x-nosible-reference-pages": [ "v2.0-world-event-trend-events" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "schema": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" } }, { "name": "include_vector", "in": "query", "required": false, "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "schema": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false } }, { "name": "id", "in": "path", "required": true, "description": "The id Event Trend returned, valid until its expires_at.", "schema": { "type": "string", "description": "The id Event Trend returned, valid until its expires_at.", "example": "tr_4a45c76c941f482e" } }, { "name": "bucket", "in": "query", "required": true, "description": "The start of one of the trend's buckets (buckets[].start), a calendar date in YYYY-MM-DD form: required, and a 422 without it or when it is not a date. A date that starts no bucket returns no events.", "schema": { "type": "string", "format": "date", "description": "The start of one of the trend's buckets (buckets[].start), a calendar date in YYYY-MM-DD form: required, and a 422 without it or when it is not a date. A date that starts no bucket returns no events.", "example": "2026-09-21" } }, { "name": "group", "in": "query", "required": false, "description": "One of the bucket's group values (a key of buckets[].groups) to read only that group.", "schema": { "type": "string", "description": "One of the bucket's group values (a key of buckets[].groups) to read only that group.", "example": "negative" } }, { "name": "limit", "in": "query", "required": false, "description": "Page size from 1 to 200 (a 422 outside it); defaults to 50.", "schema": { "type": "integer", "description": "Page size from 1 to 200 (a 422 outside it); defaults to 50.", "example": 50 } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor of the previous page.", "schema": { "type": "string", "description": "next_cursor of the previous page.", "example": "AAAAAAAAADI" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "total": { "type": "integer", "description": "Events in the bucket (and group): its event_count." }, "count": { "type": "integer", "description": "Events in this page." }, "limit": { "type": "integer", "description": "Page size applied: 50 unless limit is sent." }, "events": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." }, "_score": { "type": "number", "description": "Similarity to the trend's query." }, "_semantic_score": { "type": "number", "description": "The same similarity." }, "_search_date": { "type": "string", "format": "date", "description": "Archive date of the event." }, "_retrieval": { "type": "string", "description": "event_trend." } } }, "description": "The events, as lite records unless view=full (About records on Event details lists both). A full record adds provenance, availability, triples, each ticker's why and v2_preview_success. Most similar first." }, "next_cursor": { "type": "string", "nullable": true, "description": "Opaque cursor for the next page; null at the end." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." } }, "additionalProperties": true }, "example": { "view": "lite", "total": 330, "count": 50, "limit": 50, "events": [ { "event_id": "2026-09-24_en_US_v1_VRApFNOS5x7MUSZvIAAAALVsAABIAFOUWAAAAAAAAAA_vQkNv4ZT", "version": "2.0-preview", "event": { "date": "2026-09-24", "language": "en", "title": "OpenAI Sued Over Human Review of ChatGPT User Chats", "description": "A new class action lawsuit alleges OpenAI employs human reviewers to read user conversations with ChatGPT. The complaint cites a report on Project Lily, an internal program where humans analyze chat data to improve the artificial...", "points": [ "The Northern District of California accepted the Vredenburgh v. OpenAI OpCo, LLC class action lawsuit filed on September 16, 2026." ] }, "english": { "date": "2026-09-24", "language": "en", "title": "OpenAI Sued Over Human Review of ChatGPT User Chats", "description": "A new class action lawsuit alleges OpenAI employs human reviewers to read user conversations with ChatGPT. The complaint cites a report on Project Lily, an internal program where humans analyze chat data to improve the artificial...", "points": [ "The Northern District of California accepted the Vredenburgh v. OpenAI OpCo, LLC class action lawsuit filed on September 16, 2026." ] }, "coverage": { "total_coverage": 4, "total_netlocs": 3, "coverage_concentration_index": 0.256516, "first_seen": "2026-09-24T14:36:24+00:00", "last_seen": "2026-09-24T21:00:00+00:00", "most_seen": "2026-09-24T14:36:24+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 37.7749, "lng": -122.4194, "source": "llm", "matched_on": "{event.title}+{event.description}" } ], "signals": { "sentiment": "negative", "sentiment_prob_positive": 0, "sentiment_prob_neutral": 0.0015, "sentiment_prob_negative": 0.9985, "materiality": "medium", "materiality_score": 0.433, "time_horizon": "months", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.0025, "forward_looking_prob_not_forward": 0.9975 }, "tickers": [], "has_tickers": false, "entities": { "ORG": [ { "name": "OpenAI", "mention_count": 7, "confidence": 1 } ], "PRODUCT": [ { "name": "ChatGPT", "mention_count": 5, "confidence": 0.9995 } ] }, "sentiments": { "ORG": [ { "name": "OpenAI", "sentiment_label": "neutral", "sentiment_score": -0.5332983089354261 } ], "PRODUCT": [ { "name": "ChatGPT", "sentiment_label": "neutral", "sentiment_score": -0.02405577826896438 } ] }, "ontologies": [ { "ontology": "iab", "tier_1": "Technology & Computing", "tier_2": "Artificial Intelligence", "tier_3": "Artificial Intelligence", "tier_4": "Artificial Intelligence", "probability": 0.9924 }, { "ontology": "plover", "context": "legal", "probability": 0.9399 } ], "_score": 0.6409986071819773, "_semantic_score": 0.6409986071819773, "_search_date": "2026-09-24", "_retrieval": "event_trend" }, { "event_id": "2026-09-21_en_US_v1_FJA5jWOS5x7MUSZvIAAAALVsAABIAHpsKAAAAAAAAAA_7fMMtNy7", "version": "2.0-preview", "event": { "date": "2026-09-21", "language": "en", "title": "Four AI Giants Sued Over Alleged Illegal Pact to Slow Development", "description": "A civil antitrust lawsuit filed in California accuses Anthropic, OpenAI, SpaceXAI, and Google of conspiring to artificially slow artificial intelligence progress. The complaint alleges the companies coordinated a slowdown strategy...", "points": [ "A civil antitrust lawsuit was filed accusing Anthropic, OpenAI, SpaceXAI, and Google of conspiring to slow AI development." ] }, "english": { "date": "2026-09-21", "language": "en", "title": "Four AI Giants Sued Over Alleged Illegal Pact to Slow Development", "description": "A civil antitrust lawsuit filed in California accuses Anthropic, OpenAI, SpaceXAI, and Google of conspiring to artificially slow artificial intelligence progress. The complaint alleges the companies coordinated a slowdown strategy...", "points": [ "A civil antitrust lawsuit was filed accusing Anthropic, OpenAI, SpaceXAI, and Google of conspiring to slow AI development." ] }, "coverage": { "total_coverage": 89, "total_netlocs": 68, "coverage_concentration_index": 0.050187, "first_seen": "2026-09-20T20:00:12+00:00", "last_seen": "2026-09-21T20:35:00+00:00", "most_seen": "2026-09-21T17:11:08+00:00" }, "locations": [ { "continent": "North America", "region": "North America", "country": "United States", "lat": 37.7749, "lng": -122.4194, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "California", "entity_type": "GPE", "lat": 37.25022, "lng": -119.75126, "region": "California", "country": "United States", "continent": "North America", "source": "ner" } ], "signals": { "sentiment": "negative", "sentiment_prob_positive": 0, "sentiment_prob_neutral": 0.0002, "sentiment_prob_negative": 0.9998, "materiality": "high", "materiality_score": 0.812925, "time_horizon": "months", "forward_looking": "not-forward", "forward_looking_prob_forward": 0.026, "forward_looking_prob_not_forward": 0.974 }, "tickers": [ { "ticker": "GOOG.US", "companyv5_id": "c5-83b08027a342", "name": "Alphabet Inc Class C", "website": "https://abc.xyz", "wiki_qid": null, "isin": "US02079K1079", "lei": "5493006MHB84DD0ZWV18", "figi": "BBG009S3NB30", "sector": "Communication Services", "industry": "Interactive Media & Services", "country_iso": null, "exchange": "NASDAQ", "mic": null, "score": 0.98354 } ], "has_tickers": true, "entities": { "PERSON": [ { "name": "Sam Altman", "mention_count": 1, "confidence": 1 } ], "ORG": [ { "name": "OpenAI", "mention_count": 5, "confidence": 0.9995 } ], "GPE": [ { "name": "California", "mention_count": 2, "confidence": 0.9971 } ], "PRODUCT": [ { "name": "Claude", "mention_count": 1, "confidence": 0.605 } ] }, "sentiments": { "GPE": [ { "name": "California", "sentiment_label": "neutral", "sentiment_score": -0.6502326969984266 } ], "ORG": [ { "name": "OpenAI", "sentiment_label": "neutral", "sentiment_score": -0.0984819136206195 } ], "PERSON": [ { "name": "Sam Altman", "sentiment_label": "neutral", "sentiment_score": 0.018937975795367712 } ], "PRODUCT": [ { "name": "Claude", "sentiment_label": "neutral", "sentiment_score": -0.4207464970098885 } ] }, "ontologies": [ { "ontology": "iab", "tier_1": "Technology & Computing", "tier_2": "Artificial Intelligence", "tier_3": "Artificial Intelligence", "tier_4": "Artificial Intelligence", "probability": 0.9995 }, { "ontology": "media_frame", "label": "Conflict", "probability": 0.9968 } ], "_score": 0.628243291341134, "_semantic_score": 0.628243291341134, "_search_date": "2026-09-21", "_retrieval": "event_trend" } ], "next_cursor": "AAAAAAAAADI" } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/events/{date}/{event_id}": { "get": { "operationId": "v2_0_world_event_detail", "summary": "Event details", "description": "Retrieve one World V2.0 event by identifier: a lite record by default, the complete record with view=full.\n\nFetch event detail after discovery. The detail record is the source of truth for a factual claim: it includes the narrative, classifications, entities, coverage counters, and canonical event identity.", "tags": [ "EVENT DETAILS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-event-detail" }, "x-nosible-reference-pages": [ "v2.0-world-event-detail" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "schema": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" } }, { "name": "include_vector", "in": "query", "required": false, "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "schema": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false } }, { "name": "date", "in": "path", "required": true, "description": "Archive date in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Archive date in YYYY-MM-DD format.", "example": "2026-07-20" } }, { "name": "event_id", "in": "path", "required": true, "description": "Canonical event identifier.", "schema": { "type": "string", "description": "Canonical event identifier.", "example": "2026-07-20_en_JP_v1_NQA5mXKS5x7MUUbwQAAAABDCQAAAInpsKAEpoAAAAAA_ehrkVV2W" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorldEvent" }, "example": { "view": "lite", "event_id": "2026-07-20_en_JP_v1_NQA5mXKS5x7MUUbwQAAAABDCQAAAInpsKAEpoAAAAAA_ehrkVV2W", "version": "2.0-preview", "event": { "date": "2026-07-20", "language": "en", "title": "Nvidia and Japan Launch $2.4B Physical AI Factory for Global Robot Revolution", "description": "Jensen Huang secured major deals in Tokyo to establish a $2.4 billion AI factory, shifting focus from cloud models to embedded machine intelligence. This partnership aims to accelerate Japan's industrial robotics strategy and achieve...", "points": [ "Nvidia and Japan launched a $2.4 billion Physical AI factory initiative.", "Jensen Huang secured major deals in Tokyo to establish the $2.4 billion AI factory." ] }, "english": { "date": "2026-07-20", "language": "en", "title": "Nvidia and Japan Launch $2.4B Physical AI Factory for Global Robot Revolution", "description": "Jensen Huang secured major deals in Tokyo to establish a $2.4 billion AI factory, shifting focus from cloud models to embedded machine intelligence. This partnership aims to accelerate Japan's industrial robotics strategy and achieve...", "points": [ "Nvidia and Japan launched a $2.4 billion Physical AI factory initiative.", "Jensen Huang secured major deals in Tokyo to establish the $2.4 billion AI factory." ] }, "coverage": { "total_coverage": 20, "total_netlocs": 20, "coverage_concentration_index": 0.258503, "first_seen": "2026-07-19T21:28:02+00:00", "last_seen": "2026-07-20T15:22:30+00:00", "most_seen": "2026-07-19T21:28:02+00:00" }, "locations": [ { "continent": "Asia", "region": "East Asia", "country": "Japan", "lat": 35.6895, "lng": 139.6917, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "Tokyo", "entity_type": "GPE", "lat": 35.6895, "lng": 139.69171, "region": "Tokyo", "country": "Japan", "continent": "Asia", "source": "ner" }, { "matched_on": "Japan", "entity_type": "GPE", "lat": 36.13793, "lng": 138.441899, "region": null, "country": "Japan", "continent": "Asia", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.9996, "sentiment_prob_neutral": 0.0003, "sentiment_prob_negative": 0, "materiality": "medium", "materiality_score": 0.470755, "time_horizon": "years", "forward_looking": "forward", "forward_looking_prob_forward": 0.9579, "forward_looking_prob_not_forward": 0.0421 }, "tickers": [ { "ticker": "NVDA.US", "companyv5_id": "c5-1b5479ea345b", "name": "NVIDIA Corporation", "website": "https://nvidia.com", "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0", "sector": "Information Technology", "industry": "Semiconductors & Semiconductor Equipment", "country_iso": "US", "exchange": "NASDAQ", "mic": "XNAS", "score": 0.994437 } ], "has_tickers": true, "entities": { "PERSON": [ { "name": "Jensen Huang", "mention_count": 2, "confidence": 0.9844 } ], "ORG": [ { "name": "Nvidia", "mention_count": 4, "confidence": 1 } ], "GPE": [ { "name": "Tokyo", "mention_count": 2, "confidence": 1 } ] }, "sentiments": { "GPE": [ { "name": "Tokyo", "sentiment_label": "positive", "sentiment_score": 0.616806789445836 } ], "ORG": [ { "name": "Nvidia", "sentiment_label": "positive", "sentiment_score": 0.9791651801380185 } ], "PERSON": [ { "name": "Jensen Huang", "sentiment_label": "positive", "sentiment_score": 0.5031386906714336 } ] }, "ontologies": [ { "ontology": "plover", "context": "technology", "probability": 0.9999 }, { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9988 }, { "ontology": "media_frame", "label": "Economic Consequences", "probability": 0.9987 }, { "ontology": "nosible", "category": "Business Operations", "event": "Major Partnership Announced", "subcategory": "Sales Efforts", "probability": 0.9983 } ] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/events/{date}/{event_id}/similar": { "get": { "operationId": "v2_0_world_event_similar", "summary": "Similar events", "description": "Find semantically similar events to a canonical event.\n\nUse Similar Events to discover historical analogues and story threads. Similarity is a ranking signal, not a claim that two events are causally related. neighbors are computed against the archive-wide HNSW index. thread is reserved for a stored backwards story chain; the current archive stores none, so it is empty.", "tags": [ "EVENT DETAILS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-event-similar" }, "x-nosible-reference-pages": [ "v2.0-world-event-similar" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "schema": { "type": "string", "description": "The record each event is returned as: lite (the default), the event without its evidence, or full, the complete record. Any other value is a 422 validation_error. About records on Event details lists both.", "example": "lite" } }, { "name": "include_vector", "in": "query", "required": false, "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "schema": { "type": "boolean", "description": "true adds each event's embedding, oai_vector (3,072 values, comma-separated), to either view. Defaults to false.", "example": false } }, { "name": "date", "in": "path", "required": true, "description": "Archive date in YYYY-MM-DD format.", "schema": { "type": "string", "format": "date", "description": "Archive date in YYYY-MM-DD format.", "example": "2026-07-20" } }, { "name": "event_id", "in": "path", "required": true, "description": "Canonical event identifier.", "schema": { "type": "string", "description": "Canonical event identifier.", "example": "2026-07-20_en_JP_v1_NQA5mXKS5x7MUUbwQAAAABDCQAAAInpsKAEpoAAAAAA_ehrkVV2W" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum neighbors to return.", "schema": { "type": "integer", "description": "Maximum neighbors to return.", "example": 10 } }, { "name": "include_live", "in": "query", "required": false, "description": "Also search the live days after the archive cutoff. Defaults to false.", "schema": { "type": "boolean", "description": "Also search the live days after the archive cutoff. Defaults to false.", "example": false } }, { "name": "include_thread", "in": "query", "required": false, "description": "Include stored story-thread predecessors (none are stored in the current archive).", "schema": { "type": "boolean", "description": "Include stored story-thread predecessors (none are stored in the current archive).", "example": true } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "event_id": { "type": "string", "description": "The event the neighbours are similar to." }, "date": { "type": "string", "format": "date", "description": "Its date." }, "limit": { "type": "integer", "description": "Neighbour cap applied." }, "floor": { "type": "string", "format": "date", "description": "Earliest date a neighbour may have: the start of the archive your key can read." }, "min_similarity": { "type": "number", "description": "Similarity floor applied." }, "neighbors": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "event_id": { "type": "string", "description": "Stable event identifier." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points.", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each." } } }, "english": { "type": "object", "additionalProperties": true, "description": "The event in English: title, description and points, translated when the original language is not English." }, "coverage": { "type": "object", "additionalProperties": true, "description": "total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Places of the event, its own place first, then places named in it, as in Event details." }, "signals": { "type": "object", "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "additionalProperties": true, "description": "Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details." }, "sentiments": { "type": "object", "additionalProperties": true, "description": "Entity-level sentiment grouped by entity type. Each item has name, sentiment_label (positive, neutral or negative), and sentiment_score, the final Percentage Margin Z-score." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Classifications of the event, most probable first, as in Event details." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." }, "similarity": { "type": "number", "description": "Cosine similarity of the two events' embeddings." }, "retrieval": { "type": "string", "description": "Where the neighbour was found, such as archive_hnsw (the archive's vector index)." } } }, "description": "The most similar events across the archive, most similar first, each a record in the requested view (lite unless view=full) with its similarity and retrieval." }, "thread": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Stored story-chain predecessors, records like neighbors. Always empty in V2.0: its events carry no stored story chain, so use neighbors." }, "errors": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Non-fatal retrieval errors; empty when none." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_similar_events_v1", "view": "lite", "event_id": "2026-07-20_en_JP_v1_NQA5mXKS5x7MUUbwQAAAABDCQAAAInpsKAEpoAAAAAA_ehrkVV2W", "date": "2026-07-20", "limit": 10, "floor": "1996-10-11", "min_similarity": 0.35, "neighbors": [ { "event_id": "2026-07-19_en_JP_v1_NQA5mXIQTC4MsUbwQAAAABDCQAAAInpsKAAAAAAAAAA_BG6cojN0", "version": "2.0-preview", "event": { "date": "2026-07-19", "language": "en", "title": "Nvidia CEO Jensen Huang strengthens Japan AI and semiconductor alliances, focusing on manufacturing and automotive sectors.", "description": "Nvidia CEO Jensen Huang's visit to Japan has solidified significant alliances in AI and semiconductors. Japan aims to secure its own data and develop AI factories, viewing this as crucial for the next industrial revolution. Key...", "points": [ "Jensen Huang strengthened Japan AI and semiconductor alliances during his visit to Japan.", "Jensen Huang visited Tokyo on July 15 and 16." ] }, "english": { "date": "2026-07-19", "language": "en", "title": "Nvidia CEO Jensen Huang strengthens Japan AI and semiconductor alliances, focusing on manufacturing and automotive sectors.", "description": "Nvidia CEO Jensen Huang's visit to Japan has solidified significant alliances in AI and semiconductors. Japan aims to secure its own data and develop AI factories, viewing this as crucial for the next industrial revolution. Key...", "points": [ "Jensen Huang strengthened Japan AI and semiconductor alliances during his visit to Japan.", "Jensen Huang visited Tokyo on July 15 and 16." ] }, "coverage": { "total_coverage": 16, "total_netlocs": 15, "coverage_concentration_index": 0.15, "first_seen": "2026-07-19T01:51:19+00:00", "last_seen": "2026-07-19T22:04:22+00:00", "most_seen": "2026-07-19T21:16:07+00:00" }, "locations": [ { "continent": "Asia", "region": "East Asia", "country": "Japan", "lat": 36.2048, "lng": 138.2529, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "Tokyo", "entity_type": "GPE", "lat": 34.2255804, "lng": 139.2947745273874, "region": null, "country": "Japan", "continent": "Asia", "source": "ner" }, { "matched_on": "Japan", "entity_type": "GPE", "lat": 36.13793, "lng": 138.441899, "region": null, "country": "Japan", "continent": "Asia", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.9998, "sentiment_prob_neutral": 0.0002, "sentiment_prob_negative": 0, "materiality": "high", "materiality_score": 0.6574, "time_horizon": "months", "forward_looking": "forward", "forward_looking_prob_forward": 0.977, "forward_looking_prob_not_forward": 0.023 }, "tickers": [ { "ticker": "NVDA.US", "companyv5_id": "c5-1b5479ea345b", "name": "NVIDIA Corporation", "website": "https://nvidia.com", "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0", "sector": "Information Technology", "industry": "Semiconductors & Semiconductor Equipment", "country_iso": "US", "exchange": "NASDAQ", "mic": "XNAS", "score": 0.979171 } ], "has_tickers": true, "entities": { "PERSON": [ { "name": "Ryosei Akazawa", "mention_count": 1, "confidence": 1 } ], "ORG": [ { "name": "Toyota uses Nvidia chips across much of its stack. Nvidia", "mention_count": 1, "confidence": 1 } ], "GPE": [ { "name": "Tokyo", "mention_count": 2, "confidence": 0.9941 } ], "PRODUCT": [ { "name": "Drive", "mention_count": 2, "confidence": 0.5273 } ] }, "sentiments": { "GPE": [ { "name": "Tokyo", "sentiment_label": "positive", "sentiment_score": 0.7965290275215581 } ], "ORG": [ { "name": "Toyota uses Nvidia chips across much of its stack. Nvidia", "sentiment_label": "positive", "sentiment_score": 0.8012575942618957 } ], "PERSON": [ { "name": "Ryosei Akazawa", "sentiment_label": "neutral", "sentiment_score": 0.16046753003487257 } ], "PRODUCT": [ { "name": "Drive", "sentiment_label": "neutral", "sentiment_score": 0.2515359032052311 } ] }, "ontologies": [ { "ontology": "nosible", "category": "Business Operations", "event": "Major Partnership Announced", "subcategory": "Sales Efforts", "probability": 0.9996 }, { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9994 }, { "ontology": "plover", "context": "technology", "probability": 0.9942 }, { "ontology": "media_frame", "label": "Economic Consequences", "probability": 0.9785 } ], "similarity": 0.794663130578046, "retrieval": "archive_hnsw" }, { "event_id": "2023-12-05_en_JP_v1_fQA5mXSS5x7MUUbwQAAAABDCQAAAInpsKAEpoAAAAAA_VtP6uYea", "version": "2.0-preview", "event": { "date": "2023-12-05", "language": "en", "title": "Nvidia Partners with Japan to Build AI Chip Plants", "description": "Nvidia announced a strategic partnership with Japanese firms and government officials to construct a network of new semiconductor fabrication plants. This initiative aims to leverage Japan's technical expertise and industrial...", "points": [ "Nvidia announced a strategic partnership with Japanese firms and government officials to construct a network of new semiconductor fabrication plants.", "Nvidia plans to build a network of semiconductor plants in Japan to meet the demand for artificial intelligence graphics chips." ] }, "english": { "date": "2023-12-05", "language": "en", "title": "Nvidia Partners with Japan to Build AI Chip Plants", "description": "Nvidia announced a strategic partnership with Japanese firms and government officials to construct a network of new semiconductor fabrication plants. This initiative aims to leverage Japan's technical expertise and industrial...", "points": [ "Nvidia announced a strategic partnership with Japanese firms and government officials to construct a network of new semiconductor fabrication plants.", "Nvidia plans to build a network of semiconductor plants in Japan to meet the demand for artificial intelligence graphics chips." ] }, "coverage": { "total_coverage": 5, "total_netlocs": 5, "coverage_concentration_index": 0.236623, "first_seen": "2023-12-05T02:57:30+00:00", "last_seen": "2023-12-05T07:20:36+00:00", "most_seen": "2023-12-05T07:20:36+00:00" }, "locations": [ { "continent": "Asia", "region": "East Asia", "country": "Japan", "lat": 35.6762, "lng": 139.6503, "source": "llm", "matched_on": "{event.title}+{event.description}" }, { "matched_on": "Japan", "entity_type": "GPE", "lat": 36.13793, "lng": 138.441899, "region": null, "country": "Japan", "continent": "Asia", "source": "ner" } ], "signals": { "sentiment": "positive", "sentiment_prob_positive": 0.9999, "sentiment_prob_neutral": 0.0001, "sentiment_prob_negative": 0, "materiality": "medium", "materiality_score": 0.500766, "time_horizon": "years", "forward_looking": "forward", "forward_looking_prob_forward": 0.9967, "forward_looking_prob_not_forward": 0.0033 }, "tickers": [ { "ticker": "NVDA.US", "companyv5_id": "c5-1b5479ea345b", "name": "NVIDIA Corporation", "website": "https://nvidia.com", "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0", "sector": "Information Technology", "industry": "Semiconductors & Semiconductor Equipment", "country_iso": "US", "exchange": "NASDAQ", "mic": "XNAS", "score": 0.990087 } ], "has_tickers": true, "entities": { "ORG": [ { "name": "Nvidia", "mention_count": 7, "confidence": 1 } ], "GPE": [ { "name": "Japan", "mention_count": 7, "confidence": 0.9937 } ], "PERSON": [ { "name": "Jensen Huang", "mention_count": 1, "confidence": 1 } ] }, "sentiments": { "GPE": [ { "name": "Japan", "sentiment_label": "positive", "sentiment_score": 0.9392265444883087 } ], "ORG": [ { "name": "Nvidia", "sentiment_label": "positive", "sentiment_score": 0.7662573465222714 } ], "PERSON": [ { "name": "Jensen Huang", "sentiment_label": "neutral", "sentiment_score": 0.04459716603911458 } ] }, "ontologies": [ { "ontology": "nosible", "category": "Business Operations", "event": "Major Partnership Announced", "subcategory": "Sales Efforts", "probability": 0.9989 }, { "ontology": "schema_org_event", "label": "BusinessEvent", "probability": 0.9988 }, { "ontology": "plover", "context": "technology", "probability": 0.9984 }, { "ontology": "media_frame", "label": "Economic Consequences", "probability": 0.9961 } ], "similarity": 0.7622290725192079, "retrieval": "archive_hnsw" } ], "thread": [], "errors": [], "took_ms": 386 } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/resolve": { "get": { "operationId": "v2_0_world_resolve", "summary": "Find entities", "description": "Find the canonical entity or security identifier before retrieving its event timeline.\n\nIn V2.0, Find entities searches Atlas's normalized entities: a spelling or short name such as \"NVIDIA\" or \"Trump\" resolves to the canonical entity, and the names it returns are the ones the Atlas API accepts. Results are lite by default: each candidate's identity, event count, date range, how it matched, a ready filter and its events_url, and for a ticker its issuer's reference data and Atlas entity. That is what an autocomplete or a lookup needs; send view=full for each candidate's profile, events per year, facets and numeric statistics, as Entity profile and Ticker profile return them. An exact match is marked match: \"exact\" and is never followed by fuzzy candidates; with no match at all, results is empty (count 0).", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-resolve" }, "x-nosible-reference-pages": [ "v2.0-world-resolve" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "schema": { "type": "string", "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "example": "lite" } }, { "name": "q", "in": "query", "required": true, "description": "Entity, company, ticker, or identifier to resolve.", "schema": { "type": "string", "description": "Entity, company, ticker, or identifier to resolve.", "example": "nvidia" } }, { "name": "types", "in": "query", "required": false, "description": "Comma-separated entity types or TICKER.", "schema": { "type": "string", "description": "Comma-separated entity types or TICKER.", "example": "ORG,TICKER" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of candidates. Defaults to 10, maximum 50.", "schema": { "type": "integer", "description": "Maximum number of candidates. Defaults to 10, maximum 50.", "example": 3 } }, { "name": "min_events", "in": "query", "required": false, "description": "Only candidates with at least this many events.", "schema": { "type": "integer", "description": "Only candidates with at least this many events.", "example": 10 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view of the records: lite (the default) or full." }, "q": { "type": "string", "description": "The query." }, "count": { "type": "integer", "description": "Candidates found." }, "results": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "kind": { "type": "string", "description": "entity or ticker." }, "type": { "type": "string", "description": "NER type of an entity, or TICKER." }, "name": { "type": "string", "description": "The entity's canonical Atlas name, or the issuer's name for a ticker." }, "ticker": { "type": "string", "description": "Symbol with its exchange suffix (tickers only), such as NVDA.US." }, "identifiers": { "type": "object", "additionalProperties": true, "description": "isin, figi, lei and wiki_qid of the security (tickers only)." }, "match": { "type": "string", "description": "How the query matched: exact (the query is the candidate's name or one of its names, or a ticker's symbol, ISIN, FIGI, LEI or Wikidata QID), prefix (one of its names starts with the query) or fuzzy (a similar spelling). Exact candidates come first, then prefix, then fuzzy. Fuzzy candidates are returned only when nothing matches exactly, and only when they share at least a quarter of their letter triples with the query (trigram similarity 0.25), so an identifier or an exact name is not padded with unrelated candidates." }, "score": { "type": "number", "description": "Ranking score; higher is better." }, "total_events": { "type": "integer", "description": "Indexed events of the candidate." }, "first_date": { "type": "string", "format": "date", "description": "Date of its earliest indexed event." }, "last_date": { "type": "string", "format": "date", "description": "Date of its latest indexed event." }, "events_url": { "type": "string", "description": "The candidate's event timeline on this API version." }, "filter": { "type": "object", "additionalProperties": true, "description": "Ready-made World Search filter for the candidate." }, "profile": { "type": "object", "additionalProperties": true, "description": "view=full only. The same identity fields as the candidate's profile endpoint." }, "metadata": { "type": "object", "additionalProperties": true, "description": "view=full only. What the indexed events of this entity look like: events_by_year, and with view=full facets (the top 20 values of each categorical event field, such as language, country, sentiment and every taxonomy level) and numeric (count, missing, sum, min, max and mean of lat, lng, total_coverage, total_netlocs, coverage_concentration_index and materiality_score).", "properties": { "events_by_year": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "view=full only. Events per year: {year, count}, every year of the archive." }, "facets": { "type": "object", "additionalProperties": true, "description": "view=full only. Top values of each categorical field: {field: [{value, count}]}." }, "numeric": { "type": "object", "additionalProperties": true, "description": "view=full only. Summary statistics of each numeric field." } } }, "reference": { "type": "object", "additionalProperties": true, "description": "Tickers only. Reference data for the issuer: its Atlas entity, name, identifiers, listing and country; with view=full also its website, every identifier and its classification. Each part is present only when it is known.", "properties": { "entity": { "type": "object", "additionalProperties": true, "description": "The issuer's Atlas entity, {type, name}: the entity the Atlas API and the entity endpoints use. Absent when the ticker is not mapped to an Atlas entity.", "properties": { "type": { "type": "string", "description": "NER type of the issuer's entity: ORG." }, "name": { "type": "string", "description": "Canonical Atlas name of the issuer, such as Nvidia." } } }, "company_name": { "type": "string", "description": "Issuer name." }, "websites": { "type": "object", "additionalProperties": true, "description": "view=full only. Issuer websites: website.", "properties": { "website": { "type": "string", "description": "view=full only. Main website of the issuer." } } }, "identifiers": { "type": "object", "additionalProperties": true, "description": "Identifiers of the issuer and security: isin, figi, lei and wiki_qid; view=full adds the others known.", "properties": { "isin": { "type": "string", "description": "ISIN of the security." }, "lei": { "type": "string", "description": "LEI of the issuer." }, "figi": { "type": "string", "description": "FIGI of the security." }, "wiki_qid": { "type": "string", "description": "Wikidata identifier of the issuer." }, "companyv5_id": { "type": "string", "description": "view=full only. NOSIBLE company identifier of the issuer." } } }, "market": { "type": "object", "additionalProperties": true, "description": "Listing: exchange and mic.", "properties": { "exchange": { "type": "string", "description": "Exchange of the listing." }, "mic": { "type": "string", "description": "ISO 10383 market identifier code of the exchange." } } }, "geography": { "type": "object", "additionalProperties": true, "description": "Issuer country: country_iso.", "properties": { "country_iso": { "type": "string", "description": "ISO 3166-1 alpha-2 country of the issuer." } } }, "classification": { "type": "object", "additionalProperties": true, "description": "view=full only. GICS classification of the issuer: sector and industry.", "properties": { "sector": { "type": "string", "description": "view=full only. GICS sector." }, "industry": { "type": "string", "description": "view=full only. GICS industry." } } } } } } }, "description": "Entity and ticker candidates, best first. Entities are Atlas's canonical entities, so a spelling or short name resolves to the canonical name (\"Trump\" to \"Donald Trump\"); tickers carry their exchange suffix (NVDA.US)." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_resolve_v1", "view": "lite", "q": "nvidia", "count": 10, "results": [ { "kind": "entity", "type": "ORG", "name": "Nvidia", "total_events": 27742, "first_date": "2010-01-07", "last_date": "2026-10-09", "match": "exact", "score": 3.359183036431392, "events_url": "/api/v2.0/entities/events?type=ORG&name=Nvidia", "filter": { "entity_org": { "eq": "Nvidia" } } }, { "kind": "ticker", "type": "TICKER", "ticker": "NVDA.US", "name": "NVIDIA Corporation", "identifiers": { "isin": "US67066G1040", "figi": "BBG000BBJQV0", "lei": "549300S4KLFTLO7GSQ80", "wiki_qid": "Q182477" }, "total_events": 31828, "first_date": "2010-01-07", "last_date": "2026-10-09", "match": "prefix", "score": 2.362663878714361, "events_url": "/api/v2.0/tickers/NVDA.US/events", "filter": { "ticker": { "eq": "NVDA.US" } }, "reference": { "company_name": "NVIDIA Corporation", "identifiers": { "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0" }, "market": { "exchange": "NASDAQ", "mic": "XNAS" }, "geography": { "country_iso": "US" }, "entity": { "type": "ORG", "name": "Nvidia" } } } ], "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "took_ms": 55 } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/resolve/ticker": { "get": { "operationId": "v2_0_world_resolve_ticker", "summary": "Find tickers", "description": "Resolve a ticker symbol, issuer name, or alternate security identifier without returning entity candidates.\n\nIn V2.0, each ticker names the Atlas entity of its issuing company in reference.entity, so a ticker leads straight to that company's Atlas graph. Results are lite by default: each candidate's identity, event count, date range, how it matched, a ready filter and its events_url, and for a ticker its issuer's reference data and Atlas entity. That is what an autocomplete or a lookup needs; send view=full for each candidate's profile, events per year, facets and numeric statistics, as Entity profile and Ticker profile return them. An exact match is marked match: \"exact\" and is never followed by fuzzy candidates; with no match at all, results is empty (count 0).", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-resolve-ticker" }, "x-nosible-reference-pages": [ "v2.0-world-resolve-ticker" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "schema": { "type": "string", "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "example": "lite" } }, { "name": "q", "in": "query", "required": true, "description": "Ticker symbol, issuer name, or alternate security identifier (ISIN, FIGI, LEI or Wikidata QID).", "schema": { "type": "string", "description": "Ticker symbol, issuer name, or alternate security identifier (ISIN, FIGI, LEI or Wikidata QID).", "example": "NVDA" } }, { "name": "limit", "in": "query", "required": false, "description": "Maximum number of ticker candidates; defaults to 10 and is capped at 50.", "schema": { "type": "integer", "description": "Maximum number of ticker candidates; defaults to 10 and is capped at 50.", "example": 3 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view of the records: lite (the default) or full." }, "q": { "type": "string", "description": "The query." }, "count": { "type": "integer", "description": "Ticker candidates found." }, "results": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string", "description": "The entity's canonical Atlas name, or the issuer's name for a ticker." }, "ticker": { "type": "string", "description": "Symbol with its exchange suffix (tickers only), such as NVDA.US." }, "identifiers": { "type": "object", "additionalProperties": true, "description": "isin, figi, lei and wiki_qid of the security (tickers only)." }, "match": { "type": "string", "description": "How the query matched: exact (the query is the candidate's name or one of its names, or a ticker's symbol, ISIN, FIGI, LEI or Wikidata QID), prefix (one of its names starts with the query) or fuzzy (a similar spelling). Exact candidates come first, then prefix, then fuzzy. Fuzzy candidates are returned only when nothing matches exactly, and only when they share at least a quarter of their letter triples with the query (trigram similarity 0.25), so an identifier or an exact name is not padded with unrelated candidates." }, "score": { "type": "number", "description": "Ranking score; higher is better." }, "total_events": { "type": "integer", "description": "Indexed events of the candidate." }, "first_date": { "type": "string", "format": "date", "description": "Date of its earliest indexed event." }, "last_date": { "type": "string", "format": "date", "description": "Date of its latest indexed event." }, "events_url": { "type": "string", "description": "The candidate's event timeline on this API version." }, "filter": { "type": "object", "additionalProperties": true, "description": "Ready-made World Search filter for the candidate." }, "profile": { "type": "object", "additionalProperties": true, "description": "view=full only. The same identity fields as the candidate's profile endpoint." }, "metadata": { "type": "object", "additionalProperties": true, "description": "view=full only. What the indexed events of this entity look like: events_by_year, and with view=full facets (the top 20 values of each categorical event field, such as language, country, sentiment and every taxonomy level) and numeric (count, missing, sum, min, max and mean of lat, lng, total_coverage, total_netlocs, coverage_concentration_index and materiality_score).", "properties": { "events_by_year": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "view=full only. Events per year: {year, count}, every year of the archive." }, "facets": { "type": "object", "additionalProperties": true, "description": "view=full only. Top values of each categorical field: {field: [{value, count}]}." }, "numeric": { "type": "object", "additionalProperties": true, "description": "view=full only. Summary statistics of each numeric field." } } }, "reference": { "type": "object", "additionalProperties": true, "description": "Tickers only. Reference data for the issuer: its Atlas entity, name, identifiers, listing and country; with view=full also its website, every identifier and its classification. Each part is present only when it is known.", "properties": { "entity": { "type": "object", "additionalProperties": true, "description": "The issuer's Atlas entity, {type, name}: the entity the Atlas API and the entity endpoints use. Absent when the ticker is not mapped to an Atlas entity.", "properties": { "type": { "type": "string", "description": "NER type of the issuer's entity: ORG." }, "name": { "type": "string", "description": "Canonical Atlas name of the issuer, such as Nvidia." } } }, "company_name": { "type": "string", "description": "Issuer name." }, "websites": { "type": "object", "additionalProperties": true, "description": "view=full only. Issuer websites: website.", "properties": { "website": { "type": "string", "description": "view=full only. Main website of the issuer." } } }, "identifiers": { "type": "object", "additionalProperties": true, "description": "Identifiers of the issuer and security: isin, figi, lei and wiki_qid; view=full adds the others known.", "properties": { "isin": { "type": "string", "description": "ISIN of the security." }, "lei": { "type": "string", "description": "LEI of the issuer." }, "figi": { "type": "string", "description": "FIGI of the security." }, "wiki_qid": { "type": "string", "description": "Wikidata identifier of the issuer." }, "companyv5_id": { "type": "string", "description": "view=full only. NOSIBLE company identifier of the issuer." } } }, "market": { "type": "object", "additionalProperties": true, "description": "Listing: exchange and mic.", "properties": { "exchange": { "type": "string", "description": "Exchange of the listing." }, "mic": { "type": "string", "description": "ISO 10383 market identifier code of the exchange." } } }, "geography": { "type": "object", "additionalProperties": true, "description": "Issuer country: country_iso.", "properties": { "country_iso": { "type": "string", "description": "ISO 3166-1 alpha-2 country of the issuer." } } }, "classification": { "type": "object", "additionalProperties": true, "description": "view=full only. GICS classification of the issuer: sector and industry.", "properties": { "sector": { "type": "string", "description": "view=full only. GICS sector." }, "industry": { "type": "string", "description": "view=full only. GICS industry." } } } } }, "kind": { "type": "string", "description": "ticker." }, "type": { "type": "string", "description": "TICKER." } } }, "description": "Ticker candidates, best first, each with its issuer's reference data and Atlas entity in reference." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_resolve_v1", "view": "lite", "q": "NVDA", "count": 1, "results": [ { "kind": "ticker", "type": "TICKER", "ticker": "NVDA.US", "name": "NVIDIA Corporation", "identifiers": { "isin": "US67066G1040", "figi": "BBG000BBJQV0", "lei": "549300S4KLFTLO7GSQ80", "wiki_qid": "Q182477" }, "total_events": 31828, "first_date": "2010-01-07", "last_date": "2026-10-09", "match": "prefix", "score": 2.862663878714361, "events_url": "/api/v2.0/tickers/NVDA.US/events", "filter": { "ticker": { "eq": "NVDA.US" } }, "reference": { "company_name": "NVIDIA Corporation", "identifiers": { "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0" }, "market": { "exchange": "NASDAQ", "mic": "XNAS" }, "geography": { "country_iso": "US" }, "entity": { "type": "ORG", "name": "Nvidia" } } } ], "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "took_ms": 2 } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/entities": { "get": { "operationId": "v2_0_world_entity_catalog", "summary": "Entity directory", "description": "Enumerate Atlas canonical entities, most mentioned first: lite records by default, with each entity's observed metadata on view=full.\n\nIn V2.0, the directory lists Atlas's normalized entities: each canonical entity once, with its spellings and short names folded in. Use Entity directory to list or mirror the entities World indexes. Page through with page and limit, or walk the whole directory with next_cursor, which stays on one index build. min_events cuts the long tail of names seen once or twice, and type keeps one NER type. Lite records (the default) carry what you need to choose an entity and fetch its events; view=full adds the facets and numeric statistics of its events, as Entity profile returns them.", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-entity-catalog" }, "x-nosible-reference-pages": [ "v2.0-world-entity-catalog" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "schema": { "type": "string", "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "example": "lite" } }, { "name": "type", "in": "query", "required": false, "description": "Optional NER type such as ORG or PERSON, or ANY: ANY looks each entity type up under the name it indexes and lists the union, as the entity_any filter does.", "schema": { "type": "string", "description": "Optional NER type such as ORG or PERSON, or ANY: ANY looks each entity type up under the name it indexes and lists the union, as the entity_any filter does.", "example": "ORG" } }, { "name": "page", "in": "query", "required": false, "description": "1-based page number of limit entities. Ignored when cursor is sent.", "schema": { "type": "integer", "description": "1-based page number of limit entities. Ignored when cursor is sent.", "example": 1 } }, { "name": "limit", "in": "query", "required": false, "description": "Entries per page: 1 to 500 with view=lite, 1 to 100 with view=full. Defaults to 50.", "schema": { "type": "integer", "description": "Entries per page: 1 to 500 with view=lite, 1 to 100 with view=full. Defaults to 50.", "example": 50 } }, { "name": "min_events", "in": "query", "required": false, "description": "Only entries with at least this many events. Defaults to 1. The directory is in event order, so this cuts its long tail: most names have one or two events.", "schema": { "type": "integer", "description": "Only entries with at least this many events. Defaults to 1. The directory is in event order, so this cuts its long tail: most names have one or two events.", "example": 10 } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor of the previous page, to walk the whole directory. A cursor belongs to one index build and one set of filters (type, min_events): after the daily index rebuild it is refused with 410 cursor_expired, so start again from the first page. page is ignored when cursor is sent.", "schema": { "type": "string", "description": "next_cursor of the previous page, to walk the whole directory. A cursor belongs to one index build and one set of filters (type, min_events): after the daily index rebuild it is refused with 410 cursor_expired, so start again from the first page. page is ignored when cursor is sent." } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view of the records: lite (the default) or full." }, "entity_type": { "type": "string", "nullable": true, "description": "The type filter, null for every type." }, "coverage": { "type": "string", "description": "What the directory enumerates: indexed_entity_vocabulary." }, "order": { "type": "string", "description": "mentions_desc: the most-mentioned entities first." }, "page": { "type": "integer", "description": "1-based page number: the page of limit entries this response starts in." }, "limit": { "type": "integer", "description": "Entries per page applied." }, "min_events": { "type": "integer", "description": "Fewest events an entry has, as requested (1 by default)." }, "total": { "type": "integer", "description": "Entries in the directory with the request's type and min_events." }, "has_more": { "type": "boolean", "description": "Whether entries follow this page." }, "next_cursor": { "type": "string", "nullable": true, "description": "Send it back as cursor for the next page; null after the last. It expires with the index build." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." }, "entities": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "kind": { "type": "string", "description": "entity." }, "type": { "type": "string", "description": "NER type of the entity, such as ORG or PERSON." }, "name": { "type": "string", "description": "The entity's canonical Atlas name." }, "normalized": { "type": "string", "description": "Lower-cased lookup form of the name." }, "total_events": { "type": "integer", "description": "Indexed events that mention the entity under any of its names." }, "first_date": { "type": "string", "format": "date", "description": "Date of the earliest indexed event." }, "last_date": { "type": "string", "format": "date", "description": "Date of the latest indexed event." }, "events_url": { "type": "string", "description": "The entity's event timeline on this API version." }, "metadata": { "type": "object", "additionalProperties": true, "description": "What the indexed events of this entity look like: events_by_year, and with view=full facets (the top 20 values of each categorical event field, such as language, country, sentiment and every taxonomy level) and numeric (count, missing, sum, min, max and mean of lat, lng, total_coverage, total_netlocs, coverage_concentration_index and materiality_score).", "properties": { "events_by_year": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Events per year: {year, count}, every year of the archive." }, "facets": { "type": "object", "additionalProperties": true, "description": "view=full only. Top values of each categorical field: {field: [{value, count}]}." }, "numeric": { "type": "object", "additionalProperties": true, "description": "view=full only. Summary statistics of each numeric field." } } }, "filter": { "type": "object", "additionalProperties": true, "description": "Ready-made World Search filter for the entity." } } }, "description": "Up to limit Atlas canonical entities, each once, with the counts of all its names folded in." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_entity_catalog_v1", "view": "lite", "entity_type": null, "coverage": "indexed_entity_vocabulary", "order": "mentions_desc", "page": 1, "limit": 50, "min_events": 1, "total": 9469611, "has_more": true, "next_cursor": "eyJ2IjoxLCJi...", "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "took_ms": 149, "entities": [ { "kind": "entity", "type": "GPE", "name": "United States", "normalized": "united states", "total_events": 1457850, "first_date": "2010-01-01", "last_date": "2026-10-09", "events_url": "/api/v2.0/entities/events?type=GPE&name=United%20States", "metadata": { "events_by_year": [ { "year": "2025", "count": 249390 }, { "year": "2026", "count": 273613 } ] }, "filter": { "entity_gpe": { "eq": "United States" } } } ] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.\n\ncursor_expired: The index was rebuilt since the cursor was issued, which reorders the directory; start again from the first page.", "x-nosible-error-codes": [ "cursor_expired", "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.\n\ninvalid_entity_type: The type filter is not one of the indexed NER types or ANY.\n\ncursor_invalid: The cursor could not be read; start again from the first page.\n\ncursor_filter_mismatch: The cursor belongs to a walk with another type or min_events; drop it to start a new walk.", "x-nosible-error-codes": [ "validation_error", "invalid_entity_type", "cursor_invalid", "cursor_filter_mismatch" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.\n\ninverted_index_unavailable: The entity directory index is not loaded; retry after the next index publish.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable", "inverted_index_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/entities/profile": { "get": { "operationId": "v2_0_world_entity_profile", "summary": "Entity profile", "description": "Retrieve one indexed entity name with the same observed metadata returned by the Entity Directory.\n\nIn V2.0, the profile is the Atlas entity: one canonical record whose counts include every spelling and short name folded into it. Use Entity Profile for one known raw entity name. Its profile and metadata shape is identical to the corresponding item in Entity Directory.", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-entity-profile" }, "x-nosible-reference-pages": [ "v2.0-world-entity-profile" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "schema": { "type": "string", "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "example": "lite" } }, { "name": "type", "in": "query", "required": true, "description": "NER entity type, such as ORG or PERSON.", "schema": { "type": "string", "description": "NER entity type, such as ORG or PERSON.", "example": "ORG" } }, { "name": "name", "in": "query", "required": true, "description": "The entity's name, normally taken from the Entity directory or Find entities; any name Atlas folds into the entity works.", "schema": { "type": "string", "description": "The entity's name, normally taken from the Entity directory or Find entities; any name Atlas folds into the entity works.", "example": "Nvidia" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view of the records: lite (the default) or full." }, "profile": { "type": "object", "properties": { "kind": { "type": "string", "description": "entity." }, "type": { "type": "string", "description": "NER type of the entity, such as ORG or PERSON." }, "name": { "type": "string", "description": "The entity's canonical Atlas name." }, "normalized": { "type": "string", "description": "Lower-cased lookup form of the name." }, "total_events": { "type": "integer", "description": "Indexed events that mention the entity under any of its names." }, "first_date": { "type": "string", "format": "date", "description": "Date of the earliest indexed event." }, "last_date": { "type": "string", "format": "date", "description": "Date of the latest indexed event." }, "events_url": { "type": "string", "description": "The entity's event timeline on this API version." } }, "additionalProperties": true, "description": "The Atlas canonical entity: identity, event count and date range, counting every name folded into it." }, "metadata": { "type": "object", "properties": { "events_by_year": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Events per year: {year, count}, every year of the archive." }, "facets": { "type": "object", "additionalProperties": true, "description": "view=full only. Top values of each categorical field: {field: [{value, count}]}." }, "numeric": { "type": "object", "additionalProperties": true, "description": "view=full only. Summary statistics of each numeric field." } }, "additionalProperties": true, "description": "What the indexed events of this entity look like: events_by_year, and with view=full facets (the top 20 values of each categorical event field, such as language, country, sentiment and every taxonomy level) and numeric (count, missing, sum, min, max and mean of lat, lng, total_coverage, total_netlocs, coverage_concentration_index and materiality_score)." }, "filter": { "type": "object", "properties": { "entity_org": { "type": "object", "properties": { "eq": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true, "description": "Ready-made World Search filter for the entity." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_entity_profile_v1", "view": "lite", "profile": { "kind": "entity", "type": "ORG", "name": "Nvidia", "normalized": "nvidia", "total_events": 27742, "first_date": "2010-01-07", "last_date": "2026-10-09", "events_url": "/api/v2.0/entities/events?type=ORG&name=Nvidia" }, "metadata": { "events_by_year": [ { "year": "2025", "count": 7076 }, { "year": "2026", "count": 7498 } ] }, "filter": { "entity_org": { "eq": "Nvidia" } }, "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "took_ms": 1 } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.\n\nunknown_entity: The requested entity is not present in the index.", "x-nosible-error-codes": [ "not_found", "unknown_entity" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/tickers": { "get": { "operationId": "v2_0_world_ticker_catalog", "summary": "Ticker directory", "description": "Enumerate indexed tickers in mentions order, each with its issuer's reference data and Atlas entity: lite records by default, observed metadata on view=full.\n\nIn V2.0, each ticker names the Atlas entity of its issuer in reference.entity, when the issuer has one. Use the Ticker Directory like Entity Directory: page through indexed tickers in mentions-desc order with page and limit, or walk them all with next_cursor; min_events cuts rarely mentioned tickers. Each lite record has the ticker's identity, event count and events per year, and its issuer's name, identifiers, listing, country and Atlas entity in reference; view=full adds the observed metadata and the complete reference data.", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-ticker-catalog" }, "x-nosible-reference-pages": [ "v2.0-world-ticker-catalog" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "schema": { "type": "string", "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "example": "lite" } }, { "name": "page", "in": "query", "required": false, "description": "1-based page number of limit tickers. Ignored when cursor is sent.", "schema": { "type": "integer", "description": "1-based page number of limit tickers. Ignored when cursor is sent.", "example": 1 } }, { "name": "limit", "in": "query", "required": false, "description": "Entries per page: 1 to 500 with view=lite, 1 to 100 with view=full. Defaults to 50.", "schema": { "type": "integer", "description": "Entries per page: 1 to 500 with view=lite, 1 to 100 with view=full. Defaults to 50.", "example": 50 } }, { "name": "min_events", "in": "query", "required": false, "description": "Only entries with at least this many events. Defaults to 1. The directory is in event order, so this cuts its long tail: most names have one or two events.", "schema": { "type": "integer", "description": "Only entries with at least this many events. Defaults to 1. The directory is in event order, so this cuts its long tail: most names have one or two events.", "example": 10 } }, { "name": "cursor", "in": "query", "required": false, "description": "next_cursor of the previous page, to walk the whole directory. A cursor belongs to one index build and one set of filters (type, min_events): after the daily index rebuild it is refused with 410 cursor_expired, so start again from the first page. page is ignored when cursor is sent.", "schema": { "type": "string", "description": "next_cursor of the previous page, to walk the whole directory. A cursor belongs to one index build and one set of filters (type, min_events): after the daily index rebuild it is refused with 410 cursor_expired, so start again from the first page. page is ignored when cursor is sent." } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view of the records: lite (the default) or full." }, "coverage": { "type": "string", "description": "What the directory enumerates: ticker_resolver_vocabulary." }, "order": { "type": "string", "description": "mentions_desc: the most-mentioned tickers first." }, "page": { "type": "integer", "description": "1-based page number: the page of limit entries this response starts in." }, "limit": { "type": "integer", "description": "Entries per page applied." }, "min_events": { "type": "integer", "description": "Fewest events an entry has, as requested (1 by default)." }, "total": { "type": "integer", "description": "Entries in the directory with the request's type and min_events." }, "has_more": { "type": "boolean", "description": "Whether entries follow this page." }, "next_cursor": { "type": "string", "nullable": true, "description": "Send it back as cursor for the next page; null after the last. It expires with the index build." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "kind": { "type": "string", "description": "ticker." }, "type": { "type": "string", "description": "TICKER." }, "name": { "type": "string", "description": "Symbol with its exchange suffix, such as NVDA.US." }, "normalized": { "type": "string", "description": "Lower-cased lookup form of the name." }, "total_events": { "type": "integer", "description": "Indexed events matched to the ticker." }, "first_date": { "type": "string", "format": "date", "description": "Date of the earliest indexed event." }, "last_date": { "type": "string", "format": "date", "description": "Date of the latest indexed event." }, "events_url": { "type": "string", "description": "The ticker's event timeline on this API version." }, "metadata": { "type": "object", "additionalProperties": true, "description": "What the indexed events of this entity look like: events_by_year, and with view=full facets (the top 20 values of each categorical event field, such as language, country, sentiment and every taxonomy level) and numeric (count, missing, sum, min, max and mean of lat, lng, total_coverage, total_netlocs, coverage_concentration_index and materiality_score).", "properties": { "events_by_year": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Events per year: {year, count}, every year of the archive." }, "facets": { "type": "object", "additionalProperties": true, "description": "view=full only. Top values of each categorical field: {field: [{value, count}]}." }, "numeric": { "type": "object", "additionalProperties": true, "description": "view=full only. Summary statistics of each numeric field." } } }, "filter": { "type": "object", "additionalProperties": true, "description": "Ready-made World Search filter for the ticker." }, "reference": { "type": "object", "additionalProperties": true, "description": "Reference data for the issuer: its Atlas entity, name, identifiers, listing and country; with view=full also its website, every identifier and its classification. Each part is present only when it is known.", "properties": { "entity": { "type": "object", "additionalProperties": true, "description": "The issuer's Atlas entity, {type, name}: the entity the Atlas API and the entity endpoints use. Absent when the ticker is not mapped to an Atlas entity.", "properties": { "type": { "type": "string", "description": "NER type of the issuer's entity: ORG." }, "name": { "type": "string", "description": "Canonical Atlas name of the issuer, such as Nvidia." } } }, "company_name": { "type": "string", "description": "Issuer name." }, "websites": { "type": "object", "additionalProperties": true, "description": "view=full only. Issuer websites: website.", "properties": { "website": { "type": "string", "description": "view=full only. Main website of the issuer." } } }, "identifiers": { "type": "object", "additionalProperties": true, "description": "Identifiers of the issuer and security: isin, figi, lei and wiki_qid; view=full adds the others known.", "properties": { "isin": { "type": "string", "description": "ISIN of the security." }, "lei": { "type": "string", "description": "LEI of the issuer." }, "figi": { "type": "string", "description": "FIGI of the security." }, "wiki_qid": { "type": "string", "description": "Wikidata identifier of the issuer." }, "companyv5_id": { "type": "string", "description": "view=full only. NOSIBLE company identifier of the issuer." } } }, "market": { "type": "object", "additionalProperties": true, "description": "Listing: exchange and mic.", "properties": { "exchange": { "type": "string", "description": "Exchange of the listing." }, "mic": { "type": "string", "description": "ISO 10383 market identifier code of the exchange." } } }, "geography": { "type": "object", "additionalProperties": true, "description": "Issuer country: country_iso.", "properties": { "country_iso": { "type": "string", "description": "ISO 3166-1 alpha-2 country of the issuer." } } }, "classification": { "type": "object", "additionalProperties": true, "description": "view=full only. GICS classification of the issuer: sector and industry.", "properties": { "sector": { "type": "string", "description": "view=full only. GICS sector." }, "industry": { "type": "string", "description": "view=full only. GICS industry." } } } } } } }, "description": "Up to limit tickers with their issuer." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_ticker_catalog_v1", "view": "lite", "coverage": "ticker_resolver_vocabulary", "order": "mentions_desc", "page": 1, "limit": 50, "min_events": 1, "total": 30442, "has_more": true, "next_cursor": "eyJ2IjoxLCJi...", "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "took_ms": 138, "tickers": [ { "kind": "ticker", "type": "TICKER", "name": "NVDA.US", "normalized": "nvda.us", "total_events": 31828, "first_date": "2010-01-07", "last_date": "2026-10-09", "events_url": "/api/v2.0/tickers/NVDA.US/events", "metadata": { "events_by_year": [ { "year": "2025", "count": 7731 }, { "year": "2026", "count": 8226 } ] }, "filter": { "ticker": { "eq": "NVDA.US" } }, "reference": { "company_name": "NVIDIA Corporation", "identifiers": { "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0" }, "market": { "exchange": "NASDAQ", "mic": "XNAS" }, "geography": { "country_iso": "US" }, "entity": { "type": "ORG", "name": "Nvidia" } } } ] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.\n\ncursor_expired: The index was rebuilt since the cursor was issued, which reorders the directory; start again from the first page.", "x-nosible-error-codes": [ "cursor_expired", "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.\n\ncursor_invalid: The cursor could not be read; start again from the first page.\n\ncursor_filter_mismatch: The cursor belongs to a walk with another type or min_events; drop it to start a new walk.", "x-nosible-error-codes": [ "validation_error", "cursor_invalid", "cursor_filter_mismatch" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.\n\nresolve_index_unavailable: The ticker directory index is not loaded; retry after the next index publish.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable", "resolve_index_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/tickers/profile": { "get": { "operationId": "v2_0_world_ticker_profile", "summary": "Ticker profile", "description": "Retrieve one indexed ticker with its issuer's reference data and Atlas entity, and on view=full the same observed metadata as the Ticker Directory.\n\nIn V2.0, the profile names the Atlas entity of the ticker's issuer in reference.entity. Use Ticker Profile for one known symbol or alternate identifier. The lite record (the default) has the ticker's identity, event count and events per year, and its issuer's name, identifiers, listing, country and Atlas entity in reference; view=full adds the observed metadata and the complete reference data.", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-ticker-profile" }, "x-nosible-reference-pages": [ "v2.0-world-ticker-profile" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "view", "in": "query", "required": false, "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "schema": { "type": "string", "description": "The records returned: lite (the default), each entity's or ticker's identity, event count, date range and events per year, enough to choose one and fetch its events; or full, which adds the facets and numeric statistics of its events and a ticker's complete reference data. Any other value is a 422 validation_error.", "example": "lite" } }, { "name": "symbol", "in": "query", "required": true, "description": "Ticker symbol or alternate identifier to look up.", "schema": { "type": "string", "description": "Ticker symbol or alternate identifier to look up.", "example": "NVDA.US" } }, { "name": "id_type", "in": "query", "required": false, "description": "Identifier type: symbol, isin, figi, lei, or qid. Defaults to symbol.", "schema": { "type": "string", "description": "Identifier type: symbol, isin, figi, lei, or qid. Defaults to symbol.", "example": "symbol" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "view": { "type": "string", "description": "The view of the records: lite (the default) or full." }, "profile": { "type": "object", "properties": { "kind": { "type": "string", "description": "ticker." }, "type": { "type": "string", "description": "TICKER." }, "name": { "type": "string", "description": "Symbol with its exchange suffix, such as NVDA.US." }, "normalized": { "type": "string", "description": "Lower-cased lookup form of the name." }, "total_events": { "type": "integer", "description": "Indexed events matched to the ticker." }, "first_date": { "type": "string", "format": "date", "description": "Date of the earliest indexed event." }, "last_date": { "type": "string", "format": "date", "description": "Date of the latest indexed event." }, "events_url": { "type": "string", "description": "The ticker's event timeline on this API version." } }, "additionalProperties": true, "description": "The ticker's identity, event count and date range." }, "metadata": { "type": "object", "properties": { "events_by_year": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Events per year: {year, count}, every year of the archive." }, "facets": { "type": "object", "additionalProperties": true, "description": "view=full only. Top values of each categorical field: {field: [{value, count}]}." }, "numeric": { "type": "object", "additionalProperties": true, "description": "view=full only. Summary statistics of each numeric field." } }, "additionalProperties": true, "description": "What the indexed events of this entity look like: events_by_year, and with view=full facets (the top 20 values of each categorical event field, such as language, country, sentiment and every taxonomy level) and numeric (count, missing, sum, min, max and mean of lat, lng, total_coverage, total_netlocs, coverage_concentration_index and materiality_score)." }, "filter": { "type": "object", "properties": { "ticker": { "type": "object", "properties": { "eq": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true, "description": "Ready-made World Search filter for the ticker." }, "reference": { "type": "object", "properties": { "company_name": { "type": "string", "description": "Issuer name." }, "identifiers": { "type": "object", "properties": { "wiki_qid": { "type": "string", "description": "Wikidata identifier of the issuer." }, "isin": { "type": "string", "description": "ISIN of the security." }, "lei": { "type": "string", "description": "LEI of the issuer." }, "figi": { "type": "string", "description": "FIGI of the security." }, "companyv5_id": { "type": "string", "description": "view=full only. NOSIBLE company identifier of the issuer." } }, "additionalProperties": true, "description": "Identifiers of the issuer and security: isin, figi, lei and wiki_qid; view=full adds the others known." }, "market": { "type": "object", "properties": { "exchange": { "type": "string", "description": "Exchange of the listing." }, "mic": { "type": "string", "description": "ISO 10383 market identifier code of the exchange." } }, "additionalProperties": true, "description": "Listing: exchange and mic." }, "geography": { "type": "object", "properties": { "country_iso": { "type": "string", "description": "ISO 3166-1 alpha-2 country of the issuer." } }, "additionalProperties": true, "description": "Issuer country: country_iso." }, "entity": { "type": "object", "properties": { "type": { "type": "string", "description": "NER type of the issuer's entity: ORG." }, "name": { "type": "string", "description": "Canonical Atlas name of the issuer, such as Nvidia." } }, "additionalProperties": true, "description": "The issuer's Atlas entity, {type, name}: the entity the Atlas API and the entity endpoints use. Absent when the ticker is not mapped to an Atlas entity." }, "websites": { "type": "object", "additionalProperties": true, "description": "view=full only. Issuer websites: website.", "properties": { "website": { "type": "string", "description": "view=full only. Main website of the issuer." } } }, "classification": { "type": "object", "additionalProperties": true, "description": "view=full only. GICS classification of the issuer: sector and industry.", "properties": { "sector": { "type": "string", "description": "view=full only. GICS sector." }, "industry": { "type": "string", "description": "view=full only. GICS industry." } } } }, "additionalProperties": true, "description": "Reference data for the issuer: its Atlas entity, name, identifiers, listing and country; with view=full also its website, every identifier and its classification. Each part is present only when it is known." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" } }, "additionalProperties": true, "description": "index_build and archive_cutoff: the index that answered." }, "took_ms": { "type": "integer", "description": "Server time in milliseconds." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_ticker_profile_v1", "view": "lite", "profile": { "kind": "ticker", "type": "TICKER", "name": "NVDA.US", "normalized": "nvda.us", "total_events": 31828, "first_date": "2010-01-07", "last_date": "2026-10-09", "events_url": "/api/v2.0/tickers/NVDA.US/events" }, "metadata": { "events_by_year": [ { "year": "2025", "count": 7731 }, { "year": "2026", "count": 8226 } ] }, "filter": { "ticker": { "eq": "NVDA.US" } }, "reference": { "company_name": "NVIDIA Corporation", "identifiers": { "wiki_qid": "Q182477", "isin": "US67066G1040", "lei": "549300S4KLFTLO7GSQ80", "figi": "BBG000BBJQV0" }, "market": { "exchange": "NASDAQ", "mic": "XNAS" }, "geography": { "country_iso": "US" }, "entity": { "type": "ORG", "name": "Nvidia" } }, "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09" }, "took_ms": 4 } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.\n\nunknown_ticker: The requested symbol or identifier does not resolve to an indexed security.", "x-nosible-error-codes": [ "not_found", "unknown_ticker" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/ontology": { "get": { "operationId": "v2_0_world_ontology_catalog", "summary": "Ontology directory", "description": "List all supported ontologies, or fetch one ontology's hierarchy, definitions, coverage statistics, and example events.\n\nCall without parameters to list every supported ontology, or add ontology=emdat for its hierarchy, definitions and live coverage. Levels are local to an ontology: GICS returns sector, industry_group, industry and sub_industry; IAB returns tier_1 through tier_4. These are distinct from indexed fields such as gics_sector or iab_tier_1. Flat taxonomies can retain names such as iptc_genre or media_frame. Use the returned ontology id and level together, or copy a hierarchy node's events_url for event retrieval.", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-ontology-catalog" }, "x-nosible-reference-pages": [ "v2.0-world-ontology-catalog" ], "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "ontology", "in": "query", "required": false, "description": "Optional ontology id or slug. Omit it to list every supported ontology; use emdat for the full EM-DAT reference.", "schema": { "type": "string", "description": "Optional ontology id or slug. Omit it to list every supported ontology; use emdat for the full EM-DAT reference.", "example": "emdat" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "id": { "type": "string", "description": "Taxonomy id, accepted by ontology=. It can differ from the name in an event's ontologies (media_frames here, media_frame there)." }, "slug": { "type": "string", "description": "URL slug, also accepted by ontology=." }, "name": { "type": "string", "description": "Taxonomy name." }, "short_name": { "type": "string", "description": "Short taxonomy name." }, "description": { "type": "string", "description": "What the taxonomy classifies." }, "levels": { "type": "array", "items": { "type": "string" }, "description": "Local level names, from the top level down: sector for GICS, tier_1 for IAB, disaster_group for EM-DAT. They are not necessarily the indexed filter field names." }, "category_count": { "type": "integer", "description": "Classes in the taxonomy." }, "leaf_count": { "type": "integer", "description": "Leaf classes." }, "root_count": { "type": "integer", "description": "Top-level classes." }, "max_depth": { "type": "integer", "description": "Depth of the deepest class; 0 for a flat taxonomy." }, "events_supported": { "type": "boolean", "description": "Whether events are classified in the taxonomy." }, "coverage": { "type": "object", "additionalProperties": true, "description": "labelled_events, unclassified_events, world_events and share_of_world in the current index." }, "reference_url": { "type": "string", "description": "The taxonomy's reference page on nosible.com." }, "details_url": { "type": "string", "description": "This endpoint for the one taxonomy." } } }, "description": "Every supported taxonomy, when ontology is not sent." }, "count": { "type": "integer", "description": "Taxonomies listed." }, "as_of": { "type": "object", "properties": { "index_build": { "type": "string" }, "archive_cutoff": { "type": "string" }, "rows": { "type": "number" } }, "additionalProperties": true, "description": "index_build, archive_cutoff and rows (events in the index)." }, "ontology": { "type": "object", "additionalProperties": true, "description": "The selected taxonomy's metadata (with ontology=): id, name, levels, counts, versions and source." }, "coverage": { "type": "object", "additionalProperties": true, "description": "Indexed event counts and share for the selected taxonomy (with ontology=)." }, "examples": { "type": "object", "additionalProperties": true, "description": "How the example events in the hierarchy were chosen (with ontology=)." }, "hierarchy": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "The selected taxonomy as a tree (with ontology=): each class with its path, definition, event_count, events_url, example_events and children." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_ontology_reference_v1", "ontologies": [ { "id": "iptc_genre", "slug": "iptc-genre", "name": "IPTC News Genre", "short_name": "IPTC Genre", "description": "A flat set of categories describing the editorial form of a published piece, such as analysis, interview, obituary, or transcript.", "levels": [ "iptc_genre" ], "category_count": 55, "leaf_count": 55, "root_count": 55, "max_depth": 0, "events_supported": true, "coverage": { "labelled_events": 13248716, "unclassified_events": 3687754, "world_events": 16936470, "share_of_world": 0.7822595853799522 }, "reference_url": "https://nosible.com/ontologies/iptc-genre", "details_url": "/api/v2.0/ontology?ontology=iptc_genre" }, { "id": "media_frames", "slug": "media-frames", "name": "Media Frames", "short_name": "Media Frames", "description": "Five categories describing the narrative frame used to present an event.", "levels": [ "media_frame" ], "category_count": 5, "leaf_count": 5, "root_count": 5, "max_depth": 0, "events_supported": true, "coverage": { "labelled_events": 15776853, "unclassified_events": 1159617, "world_events": 16936470, "share_of_world": 0.9315313639737206 }, "reference_url": "https://nosible.com/ontologies/media-frames", "details_url": "/api/v2.0/ontology?ontology=media_frames" } ], "count": 16, "as_of": { "index_build": "inv-20261011-004754-2913402", "archive_cutoff": "2026-10-09", "rows": 16936470 } } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.\n\nunknown_ontology: The ontology id or slug is not in the supported ontology directory.", "x-nosible-error-codes": [ "not_found", "unknown_ontology" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.\n\ninverted_index_unavailable: Current ontology counts cannot be served until the live World index is loaded.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable", "inverted_index_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/api/v2.0/search/schema": { "get": { "operationId": "v2_0_world_search_schema", "summary": "Search Schema", "description": "Retrieve the versioned filter and field schema accepted by World Search.\n\nFetch this schema before generating dynamic World Search filters. It is the machine-readable inventory of supported fields, operators, aliases, entity types, semantic controls, and ontology values. Cache it by revision and invalidate your cache when revision changes.", "tags": [ "HELPERS" ], "externalDocs": { "description": "Interactive reference", "url": "https://docs.nosible.com/endpoints/v2.0-world-search-schema" }, "x-nosible-reference-pages": [ "v2.0-world-search-schema" ], "security": [ { "BearerAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "schema": { "type": "string", "description": "Response schema name." }, "revision": { "type": "integer", "description": "Revision of the catalogue; cache by it." }, "endpoint": { "type": "string", "description": "The search route the catalogue describes, as the backend names it." }, "search_types": { "type": "array", "items": { "type": "string" }, "description": "Supported retrieval modes." }, "semantic_inputs": { "type": "object", "properties": { "q": { "type": "string" }, "vector": { "type": "string" }, "vectors": { "type": "string" }, "vector_texts": { "type": "string" }, "score_vectors": { "type": "string" }, "score_vector_texts": { "type": "string" } }, "additionalProperties": true, "description": "How q, vector, vectors, vector_texts, score_vectors and score_vector_texts are used." }, "date_grouped_semantic": { "type": "object", "properties": { "enable": { "type": "object", "properties": { "group_by": { "type": "string" }, "include": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "definition_inputs": { "type": "string" }, "response_projections": { "type": "object", "properties": { "nosible_world_factor_search_v1": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "nosible_world_factor_columns_v1": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string" } }, "revision": { "type": "number" }, "score_range": { "type": "array", "items": { "type": "number" } }, "score_vector_width": { "type": "string" }, "score_vector_order": { "type": "string" } }, "additionalProperties": true } }, "additionalProperties": true }, "vector_aggregate": { "type": "array", "items": { "type": "string" } }, "per_date_limit": { "type": "string" }, "min_score": { "type": "string" }, "max_dates_per_request": { "type": "number" }, "max_vectors_per_field": { "type": "number" }, "max_candidate_retrievals": { "type": "number" }, "max_score_dot_products": { "type": "number" }, "max_concurrent_requests": { "type": "number" }, "max_queued_requests": { "type": "number" }, "max_response_events": { "type": "number" }, "max_response_units": { "type": "number" }, "max_request_bytes": { "type": "number" }, "response": { "type": "string" } }, "additionalProperties": true, "description": "How to request date-grouped semantic search, with its limits." }, "operators": { "type": "object", "properties": { "string": { "type": "array", "items": { "type": "string" } }, "number": { "type": "array", "items": { "type": "string" } }, "boolean": { "type": "array", "items": { "type": "string" } }, "date": { "type": "array", "items": { "type": "string" } }, "string_set": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true, "description": "Filter operators per field type." }, "entity_types": { "type": "array", "items": { "type": "string" }, "description": "NER types of the entity_* filter fields." }, "resolve_endpoint": { "type": "string", "description": "The resolver route, as the backend names it." }, "logical": { "type": "array", "items": { "type": "string" }, "description": "Logical filter operators." }, "geo": { "type": "object", "properties": { "bbox": { "type": "object", "properties": { "shape": { "type": "string" } }, "additionalProperties": true }, "geo_radius": { "type": "object", "properties": { "shape": { "type": "object", "properties": { "lat": { "type": "number" }, "lng": { "type": "number" }, "km": { "type": "number" } }, "additionalProperties": true } }, "additionalProperties": true } }, "additionalProperties": true, "description": "Shapes of the bbox and geo_radius filters." }, "retrieval": { "type": "object", "properties": { "archive_semantic": { "type": "string" }, "live_semantic": { "type": "string" }, "filtered_semantic": { "type": "string" } }, "additionalProperties": true, "description": "Retrieval paths for archive, live and filtered semantic search." }, "semantic_filter_modes": { "type": "array", "items": { "type": "string" }, "description": "Semantic filter strategies." }, "fields": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "type": "string", "description": "Field name, as used in filters, sort and facets." }, "type": { "type": "string", "description": "Field type: string, number, boolean, date or string_set; operators lists what each accepts." }, "aliases": { "type": "array", "items": { "type": "string" }, "description": "Other names accepted for the field." }, "facet": { "type": "boolean", "description": "Whether facets can count the field." } } }, "description": "Every filterable field." } }, "additionalProperties": true }, "example": { "schema": "nosible_world_search_schema_v1", "revision": 5, "endpoint": "POST /api/v2.0/search", "search_types": [ "metadata", "lexical", "semantic", "hybrid" ], "semantic_inputs": { "q": "server embeds text with the configured embedding provider", "vector": "caller-supplied query vector of 3072 numbers; alias query_vector", "vectors": "caller-supplied query vectors for date-grouped semantic retrieval", "vector_texts": "plain-language factor anchors embedded server-side for date-grouped retrieval", "score_vectors": "extra vectors scored exactly on grouped candidates without widening retrieval", "score_vector_texts": "plain-language score-only statements embedded server-side for date-grouped retrieval" }, "date_grouped_semantic": { "enable": { "group_by": "date", "include": [ "factor" ] }, "definition_inputs": "provide vectors or vector_texts (but not both); score_vectors and score_vector_texts are score-only equivalents", "response_projections": { "nosible_world_factor_search_v1": { "include": [ "factor" ] }, "nosible_world_factor_columns_v1": { "include": [ "factor", "factor_columns_v1" ], "revision": 1, "score_range": [ -1, 1 ], "score_vector_width": "request.score_vectors.length", "score_vector_order": "request order" } }, "vector_aggregate": [ "max", "mean", "softmax" ], "per_date_limit": "candidate count retrieved per query vector and date; default 1000", "min_score": "inclusive aggregate cosine floor applied after exact reranking", "max_dates_per_request": 120, "max_vectors_per_field": 64, "max_candidate_retrievals": 2000000, "max_score_dot_products": 50000000, "max_concurrent_requests": 5, "max_queued_requests": 20, "max_response_events": 100000, "max_response_units": 1000000, "max_request_bytes": 16777216, "response": "lean numeric projection, exact eligible totals, and explicit truncation diagnostics per date" }, "operators": { "string": [ "eq", "neq", "in", "not_in", "exists", "missing", "contains", "prefix" ], "number": [ "eq", "neq", "in", "not_in", "exists", "missing", "gt", "gte", "lt", "lte", "between" ], "boolean": [ "eq", "neq", "exists", "missing" ], "date": [ "eq", "neq", "in", "not_in", "gt", "gte", "lt", "lte", "between" ], "string_set": [ "eq", "in", "all", "not_in", "contains", "prefix" ] }, "entity_types": [ "GPE", "LOC", "ORG", "PERSON", "PRODUCT" ], "resolve_endpoint": "GET /api/v2.0/resolve", "logical": [ "and", "or", "not" ], "geo": { "bbox": { "shape": "[west_lng, south_lat, east_lng, north_lat]" }, "geo_radius": { "shape": { "lat": 0, "lng": 0, "km": 100 } } }, "retrieval": { "archive_semantic": "approximate nearest-neighbour retrieval over the whole archive, then exact rescoring", "live_semantic": "per-day indexes of the days after the archive cutoff, when date.include_live is true", "filtered_semantic": "semantic_filter_mode=auto or usearch applies the filters while walking the vector index; semantic_filter_mode=exact scores every event that passes the filters" }, "semantic_filter_modes": [ "auto", "usearch", "exact" ], "fields": [ { "name": "event_id", "type": "string", "aliases": [], "facet": false }, { "name": "date", "type": "date", "aliases": [], "facet": true }, { "name": "title", "type": "string", "aliases": [], "facet": false } ] } } } }, "400": { "description": "invalid_json: The request body is not JSON. Every error body, 401 included, is {error, message, status}.", "x-nosible-error-codes": [ "invalid_json" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "api_key_required: No API key was sent. Send it as Authorization: Bearer or the api-key header.\n\ninvalid_api_key: The API key is invalid or has been revoked.", "x-nosible-error-codes": [ "api_key_required", "invalid_api_key" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "403": { "description": "access_denied: The requested archive date is outside the caller's World tier.", "x-nosible-error-codes": [ "access_denied" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "not_found: The requested date, entity, ticker, or event does not exist in the accessible index.", "x-nosible-error-codes": [ "not_found" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "410": { "description": "cursor_expired: The cursor was minted against a replaced index build. Restart pagination from the first page.", "x-nosible-error-codes": [ "cursor_expired" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "422": { "description": "validation_error: The request is well formed but the API cannot decode or validate it: an unknown body field or query parameter, a missing required parameter, a value of the wrong type, an empty and, or or not, a date that is not a calendar date (in the path, the query or the body), an unknown enum value or a reversed range. The message names the parameter and what is wrong.", "x-nosible-error-codes": [ "validation_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "429": { "description": "rate_limited: The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.", "x-nosible-error-codes": [ "rate_limited" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "501": { "description": "backend_not_configured: The World backend is not configured for this deployment.", "x-nosible-error-codes": [ "backend_not_configured" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "502": { "description": "backend_error: The World backend could not be reached or did not return a valid response; retry shortly.", "x-nosible-error-codes": [ "backend_error" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "503": { "description": "api_key_auth_unavailable: API key authentication is temporarily unavailable; retry shortly.\n\napi_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.", "x-nosible-error-codes": [ "api_key_auth_unavailable", "api_key_metering_unavailable" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "504": { "description": "backend_timeout: The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.", "x-nosible-error-codes": [ "backend_timeout" ], "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "API key" } }, "schemas": { "EntitySentiments": { "type": "object", "description": "Entity-level sentiments grouped by entity type. sentiment_score is the final Percentage Margin Z-score.", "additionalProperties": { "type": "array", "items": { "$ref": "#/components/schemas/EntitySentiment" } } }, "EntitySentiment": { "type": "object", "required": [ "name", "sentiment_label", "sentiment_score" ], "properties": { "name": { "type": "string" }, "sentiment_label": { "type": "string", "enum": [ "positive", "neutral", "negative" ] }, "sentiment_score": { "type": "number", "description": "Final Percentage Margin Z-score." } }, "additionalProperties": false }, "WorldEvent": { "type": "object", "properties": { "view": { "type": "string", "description": "The view the events are returned in: lite (the default) or full. See About records on Event details." }, "event_id": { "type": "string", "description": "Stable event identifier. The same event has the same identifier in V1.2." }, "version": { "type": "string", "description": "Event record version: \"2.0-preview\"." }, "event": { "type": "object", "properties": { "date": { "type": "string", "format": "date", "description": "World archive date of the event." }, "language": { "type": "string", "description": "ISO 639-1 code of the event's original language." }, "title": { "type": "string", "description": "Headline, in the original language." }, "description": { "type": "string", "description": "Short narrative of the event, in the original language." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts of the event, one sentence each, drawn from its sources." } }, "additionalProperties": true, "description": "The event in its original language: date, language, title, description and points." }, "english": { "type": "object", "properties": { "date": { "type": "string" }, "language": { "type": "string" }, "title": { "type": "string", "description": "Headline in English." }, "description": { "type": "string", "description": "Narrative in English." }, "points": { "type": "array", "items": { "type": "string" }, "description": "Key facts in English." } }, "additionalProperties": true, "description": "The event in English: title, description and points translated when the original language is not English, identical to event otherwise. english.date and english.language repeat the event's own." }, "coverage": { "type": "object", "properties": { "total_coverage": { "type": "integer", "description": "Source documents (articles) in the event." }, "total_netlocs": { "type": "integer", "description": "Distinct source sites in the event." }, "coverage_concentration_index": { "type": "number", "description": "Concentration of the coverage across sites (a Herfindahl index from 0 to 1); near 1, one syndicated story dominates." }, "first_seen": { "type": "string", "format": "date-time", "description": "Earliest source timestamp, UTC." }, "last_seen": { "type": "string", "format": "date-time", "description": "Latest source timestamp, UTC." }, "most_seen": { "type": "string", "format": "date-time", "description": "The most frequent source timestamp, UTC (the earliest on a tie)." } }, "additionalProperties": true, "description": "How widely the event was reported and when." }, "locations": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "continent": { "type": "string", "description": "Continent of the place." }, "region": { "type": "string", "nullable": true, "description": "Region of the place, null when unknown." }, "country": { "type": "string", "description": "Country of the place, as a full English name." }, "lat": { "type": "number", "description": "Latitude." }, "lng": { "type": "number", "description": "Longitude." }, "source": { "type": "string", "description": "How the place was found: llm for the event's own place, ner for a named place." }, "matched_on": { "type": "string", "description": "What the place was matched on: {event.title}+{event.description} for the event's own place, otherwise the entity name." }, "entity_type": { "type": "string", "description": "NER type of the named place (GPE or LOC); absent on the event's own place." } } }, "description": "Places of the event. The first is the event's own place, read from its title and description (source: \"llm\"); the rest are places named in the event (entities of type GPE and LOC) resolved on the map (source: \"ner\")." }, "signals": { "type": "object", "properties": { "sentiment": { "type": "string", "description": "positive, neutral or negative: the material impact on the event's main subject, not the tone of the prose." }, "sentiment_prob_positive": { "type": "number", "description": "Probability of positive sentiment. The three sentiment probabilities sum to 1." }, "sentiment_prob_neutral": { "type": "number", "description": "Probability of neutral sentiment." }, "sentiment_prob_negative": { "type": "number", "description": "Probability of negative sentiment." }, "materiality": { "type": "string", "description": "high, medium or low, bucketed from materiality_score at 0.60 and 0.30." }, "materiality_score": { "type": "number", "description": "Continuous materiality from 0 to 1." }, "time_horizon": { "type": "string", "description": "intraday, days, weeks, months, quarters or years." }, "forward_looking": { "type": "string", "description": "forward or not-forward." }, "forward_looking_prob_forward": { "type": "number", "description": "Probability that the event is forward-looking." }, "forward_looking_prob_not_forward": { "type": "number", "description": "Probability that it is not." } }, "additionalProperties": true, "description": "Sentiment, materiality, time horizon and forward-looking signals, with the class probabilities behind each label." }, "tickers": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "ticker": { "type": "string", "description": "Symbol with its exchange suffix, such as NVDA.US." }, "companyv5_id": { "type": "string", "description": "NOSIBLE company identifier of the issuer." }, "name": { "type": "string", "description": "Issuer name." }, "website": { "type": "string", "description": "Issuer website." }, "wiki_qid": { "type": "string", "description": "Wikidata identifier of the issuer." }, "isin": { "type": "string", "description": "ISIN of the security." }, "lei": { "type": "string", "description": "LEI of the issuer." }, "figi": { "type": "string", "description": "FIGI of the security." }, "sector": { "type": "string", "description": "GICS sector of the issuer." }, "industry": { "type": "string", "description": "GICS industry of the issuer." }, "country_iso": { "type": "string", "description": "ISO 3166-1 alpha-2 country of the issuer." }, "exchange": { "type": "string", "description": "Exchange of the listing." }, "mic": { "type": "string", "description": "ISO 10383 market identifier code of the exchange." }, "score": { "type": "number", "description": "Strength of the link between the event and the company, from 0 to 1." }, "why": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "view=full only. The reasons for the link, strongest first: an entity in the event and the graph relationships that lead from it to the issuer." } } }, "description": "Listed companies the event concerns, mapped through the Atlas graph, strongest first. Empty when has_tickers is false." }, "has_tickers": { "type": "boolean", "description": "Whether tickers is non-empty." }, "entities": { "type": "object", "properties": { "PERSON": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "mention_count": { "type": "number" }, "confidence": { "type": "number" } }, "additionalProperties": true } }, "ORG": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "mention_count": { "type": "number" }, "confidence": { "type": "number" } }, "additionalProperties": true } }, "GPE": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "mention_count": { "type": "number" }, "confidence": { "type": "number" } }, "additionalProperties": true } } }, "additionalProperties": true, "description": "Named entities in the event by NER type (PERSON, ORG, GPE, LOC, PRODUCT, ...). Each type lists {name, mention_count, confidence}: the name as written in the sources, how often it is mentioned and the recognizer's confidence from 0 to 1." }, "sentiments": { "$ref": "#/components/schemas/EntitySentiments" }, "ontologies": { "type": "array", "items": { "type": "object", "additionalProperties": true, "properties": { "ontology": { "type": "string", "description": "Taxonomy, named as in the World Search filter fields: iab, gics, nosible, media_frame, ekman7_emotion, schema_org_event and so on." }, "probability": { "type": "number", "description": "Probability of the classification." } } }, "description": "Classifications of the event, one per taxonomy that classified it, most probable first. Each names its taxonomy in ontology, carries that taxonomy's slots (label for a flat taxonomy; tier_1 to tier_4, sector to sub_industry, category / subcategory / event and so on for the others) and the probability. A taxonomy that did not classify the event is absent, and so is a slot it left empty." }, "include_vector": { "type": "boolean", "description": "true when the request asked for the embedding with include_vector=true; absent otherwise." }, "triples": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "view=full only. Relationships between entities stated in the event, as in Event details." }, "provenance": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "view=full only. Supporting source documents with their snippets, as in Event details." }, "availability": { "type": "object", "additionalProperties": true, "description": "view=full only. Source documents per UTC hour, as in Event details." }, "v2_preview_success": { "type": "boolean", "description": "view=full only. Whether the V2.0 pipeline completed the event." }, "oai_vector": { "type": "string", "description": "Only with include_vector=true: the event's 3,072-dimension embedding (text-embedding-3-large), comma-separated." } }, "additionalProperties": true } } } }