API Reference
API Reference
Endpoint groups, authentication, paging, and response conventions.
Base URL:
https://api.omnist.ai
All endpoints return JSON. Send API keys with the authorization header:
Authorization: Bearer omni_live_...
Endpoint Groups
| Area | Endpoints |
|---|---|
| Content | POST /v1/content/search, GET /v1/content/{content_id} |
| Entities | POST /v1/entities/search, GET /v1/entities/{entity_id}/timeline |
| News clusters | GET /v1/news/clusters, GET /v1/news/clusters/{cluster_id} |
| Monitors | POST /v1/monitors, GET /v1/monitors, GET /v1/monitors/{monitor_id}, PATCH /v1/monitors/{monitor_id}, DELETE /v1/monitors/{monitor_id}, POST /v1/monitors/{monitor_id}/run, GET /v1/monitors/{monitor_id}/runs, GET /v1/monitors/{monitor_id}/results, POST /v1/monitors/{monitor_id}/search, POST /v1/monitors/{monitor_id}/backfills, GET /v1/monitors/{monitor_id}/backfills, GET /v1/monitors/{monitor_id}/backfills/{task_id} |
| Webhooks | GET /v1/webhooks, PUT /v1/webhooks, POST /v1/webhooks/rotate-signing-secret, POST /v1/webhooks/test, GET /v1/webhooks/test, GET /v1/webhooks/events, GET /v1/webhooks/stats |
Conventions
- JSON request bodies use
content-type: application/json. - Search endpoints return a single ranked page with
limitup to 100. - List endpoints use
limitandoffset, and returnnext_offsetwithhas_more. - Monitor backfills are asynchronous and return a parent
task_id. - Timestamps are ISO 8601 strings in UTC.
- Errors use
{ error, message, meta }. - Response metadata includes request IDs when available.