Search content

Use POST /v1/content/search when a user types a topic, company, person, product, or theme and expects relevant coverage back. Send the query and the filters you care about; the API returns the strongest matches for that request.

Request shape

{
  "query": "battery supply chains",
  "media_types": ["news", "wire", "podcast"],
  "include_domains": ["reuters.com"],
  "start_date": "2026-05-01",
  "end_date": "2026-05-08",
  "limit": 10
}

limit defaults to 10 and can be as high as 100. Search endpoints do not paginate; ask for the number of results you want to show or inspect.

Filters

Filter	Type	Notes
start_date	ISO date or datetime	Start of the publication window.
end_date	ISO date or datetime	End of the publication window.
media_types	string array	news, wire, and podcast are supported.
include_domains	string array	Restrict results to these source domains. Maximum 10.
exclude_domains	string array	Exclude these source domains. Maximum 10.
entity_ids	string array	Return content linked to at least one of these entities.

Use either include_domains or exclude_domains, not both. If you omit a date range, search uses a recent default window.

Response

{
  "results": [
    {
      "score": 0.92,
      "content_item": {
        "id": "content_...",
        "media_type": "news",
        "title": "Example article",
        "source": {
          "name": "Example News",
          "domain": "example.com"
        },
        "key_points": ["A concise point."]
      }
    }
  ]
}

Only results with a strong rerank score are returned. The public score field is that rerank score.