Events
Event-kind sips — self-contained digests of micro actions and developments
Search event intelligence
Returns event-kind sips. Searches without q are sorted by created descending; semantic searches with q are ranked by cosine distance, most similar first.
When to use: retrieve concrete developments, incidents, company actions, policy changes, market moves, or other observed business events before moving to higher-level signals.
Search modes: use ids for exact UUID lookup, tags for inclusive-AND tag filtering, q + acc for semantic search, and from to set the oldest creation date. These filters can be combined.
Default time window: when from is omitted, the service uses its default recent window, currently about the last 7 days.
Response shape: JSON responses are flattened digest objects with id and reported added by the router. Stable fields include briefing, event_type, actions, people, regions, cross_domain_impacts, future_outlook, impact_level, and tags; additional pipeline-specific keys may appear.
Agent format: use response_type=text for compact field-per-line records when feeding an LLM or MCP client. Use JSON when the caller needs structured parsing.
query Parameters
idsExact event sip UUIDs to fetch (CSV). Use when following references or retrieving known records.
tagsTag filters (CSV). Multiple values are inclusive AND, so every supplied tag must match.
qNatural-language semantic search query. Max 1024 characters; requires the embedder.
accMatch strictness for q. 0.0=broad, 1.0=strict. Default 0.5.
fromOnly include events created on or after this date (YYYY-MM-DD). Defaults to the recent window when omitted.
response_typeOutput format. json returns flattened digest objects; text returns compact plain-text records for LLM/MCP context.
limitPage size. Default 16, max 128.
offsetNumber of events to skip. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search event intelligence › Responses
Event digests when response_type=json; plain-text event blocks when response_type=text
idSip UUID (RFC 4122).
reportedReported timestamp of the sip (maps from persisted created).
briefingConcise summary of the event.
event_typeCategory or classification of the event.
impact_levelAssessed impact severity.
future_outlookForward-looking assessment of likely developments.
actionsMicro actions or developments that compose the event.
cross_domain_impactsEffects spanning multiple domains or sectors.
companiesCompanies or organizations associated with the event.
productsProducts or commodities associated with the event.
macro_contextBroader macroeconomic or geopolitical context for the event.
peoplePeople mentioned or involved in the event.
regionsGeographic regions associated with the event.
tagsScalar tags for filtering and discovery.

