Search Events
search_eventsRead-onlyIdempotent
Search and filter the WEO event corpus by query text or classification (bloc, tier, domain, event type, primary industry tag); returns the matching events with their metadata, capped by limit (default 20, max 50). Use to discover or shortlist events; for a single event's complete record, use get_event. Events enter after a verification lag from their implementation date (six months; 60 days for verified product releases), so recent events may not yet appear, and an empty result is not evidence that no such event has occurred. Free tier returns the classification facts with the deeper assessment and evidence withheld on non-sample events; full tier — and sample events on either tier — return every field.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bloc | No | Filter by bloc: Western, Eastern (tier 3); Western-Led, Eastern-Led (tier 2); Cross-Bloc (tier 1). Each bloc value occurs at one tier only | |
| tier | No | Filter by tier: 1 (Cross-Bloc), 2 (Between-Bloc), 3 (Intra-Bloc); each tier carries its own bloc values (see `bloc`) | |
| type | No | Filter by event type: Policy, Infrastructure, Corporate, Coordination | |
| limit | No | Number of results (default 20, max 50) | |
| query | No | Free-text search across event name and description | |
| domain | No | Filter by domain: Technology, Energy/Infrastructure, Security, Trade | |
| industry | No | Filter by primary industry tag |