Omnist API
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

FieldTypeRequiredNotes
querystringYesSearch text.
start_dateISO date or datetimeNoStart of publication window. Required when end_date is present.
end_dateISO date or datetimeNoEnd of publication window. Required when start_date is present.
media_typesstring arrayNonews, wire, and podcast.
include_domainsstring arrayNoSource domains to include. Maximum 10. Cannot be combined with exclude_domains.
exclude_domainsstring arrayNoSource domains to exclude. Maximum 10. Cannot be combined with include_domains.
entity_idsstring arrayNoReturn content linked to at least one listed entity.
limitnumberNoDefault 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": []
  }
}

On this page