Entities

POST /v1/entities/search

Searches public entities by name, alias, and description. Use this when you need an entity_id before fetching a timeline or filtering content search.

Request body

Field	Type	Required	Notes
query	string	Yes	Entity name, alias, or description text.
entity_kinds	string array	No	Restrict to kinds such as person, company, product, or place.
limit	number	No	Default 10, maximum 100.

Response

{
  "results": [
    {
      "score": 0.94,
      "entity": {
        "id": "ent_...",
        "entity_id": "ent_...",
        "display_name": "Example Company",
        "entity_kind": "company",
        "description": "A short description.",
        "aliases": ["Example Co."],
        "tags": []
      }
    }
  ]
}

GET /v1/entities/{entity_id}/timeline

Returns content where a specific entity appears, ordered within a date range.

Query parameters

Parameter	Type	Notes
start_date	ISO date or datetime	Start of publication window. Defaults to a recent window.
end_date	ISO date or datetime	End of publication window.
media_types	string array	Filter to news, wire, podcast, or any combination.
limit	number	Default 25, maximum 100.
offset	number	Default 0.

Response

{
  "entity_id": "ent_...",
  "timeline": [
    {
      "id": "content_...",
      "media_type": "news",
      "published_date": "2026-05-07T14:03:00Z",
      "title": "Example article",
      "source": {
        "name": "Example News"
      }
    }
  ],
  "limit": 25,
  "offset": 0,
  "next_offset": null,
  "has_more": false
}