Search
Free-text search across event titles and summaries.
GET /api/v2/search?q=...
curl "https://divergence.news/api/v2/search?q=federal+reserve&limit=10"
Parameters
| Name | Type | Default | Notes |
|---|---|---|---|
q | string | - | Required. Minimum 2 characters |
cursor | string | - | |
limit | int | 25 | 1 to 100 |
Response
Same shape as GET /events. Results are ranked by relevance (Postgres ts_rank), not recency or divergence.
What search does not do
- No fuzzy matching. Misspellings return fewer results.
- No phrase matching with quotes. Tokens are ANDed.
- No filters combined with search in v2.0. If you need
q + category, make two calls and intersect IDs client-side. Combined filtering is on the roadmap.
Errors
400 invalid_parameter-qmissing or shorter than 2 characters