API Reference
Content
Search for content and fetch one content item by ID.
Search Content
POST
/v1/content/search
Finds relevant news, wire, and podcast items for a query.
If you omit dates, Omnist searches from 60 days ago through today. If you provide a date window, include both start_date and end_date. Explicit date windows can span at most 60 days.
Request Body
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | Yes | Search text. |
start_date | ISO date or datetime | No | Start of publication window. Required when end_date is present. |
end_date | ISO date or datetime | No | End of publication window. Required when start_date is present. |
media_types | string array | No | news, wire, and podcast. |
include_domains | string array | No | Source domains to include. Maximum 10. Cannot be combined with exclude_domains. |
exclude_domains | string array | No | Source domains to exclude. Maximum 10. Cannot be combined with include_domains. |
entity_ids | string array | No | Return content linked to at least one listed entity. |
limit | number | No | Default 10, maximum 100. |
Response
{
"results": [
{
"score": 0.92,
"content_item": {
"id": "content_...",
"media_type": "news",
"published_date": "2026-05-07T14:03:00Z",
"title": "Example article",
"source": {
"name": "Example News",
"domain": "example.com"
},
"key_points": ["A concise point."],
"article_id": "article_...",
"language": "en"
}
}
]
}
score is the rerank score used by the API for final ordering. Results below the search threshold are omitted.
Get Content
GET
/v1/content/{content_id}
Fetches one content item by ID. The public API returns metadata, summaries, key points, linked entities, and media-specific fields. It does not return full news article bodies or podcast transcripts.
Podcast content includes segment metadata when available.
Response
{
"content_item": {
"id": "content_...",
"media_type": "podcast",
"title": "Episode title",
"source": {
"name": "Example Show"
},
"key_points": ["A concise point."],
"episode_id": "episode_...",
"podcast_id": "podcast_...",
"segments": []
}
}