v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB

Co-mentions

Connected Entities

Explore entities associated with your search filters to reveal deeper connections. This endpoint retrieves the top N entities ranked by chunk volume and headline volume, merges the two sets, and returns entities with combined or individual counts.

post/v1/search/co-mentions/entities

Request body

limitinteger

Maximum number of entities to retrieve. It must be lower than or equal to 1000.

Example request

{
  "query": {
    "text": "Type a theme to get connected entities..."
  }
}

Response

Entities co-mentions results

Example response

{
  "results": {
    "places": [
      {
        "id": "13FF12",
        "total_chunks_count": 92468,
        "total_headlines_count": 24049
      }
    ],
    "companies": [
      {
        "id": "275B6C",
        "total_headlines_count": 105
      }
    ],
    "organizations": [
      {
        "id": "1BC945",
        "total_chunks_count": 17812,
        "total_headlines_count": 2427
      }
    ],
    "people": [
      {
        "id": "22C3AF",
        "total_chunks_count": 29883,
        "total_headlines_count": 22536
      }
    ],
    "concepts": [
      {
        "id": "9DB5BD",
        "total_chunks_count": 106720,
        "total_headlines_count": 44591
      }
    ]
  },
  "metadata": {
    "request_id": "0f763fb3-4957-430a-acf6-5d4fc6b5109d",
    "timestamp": "2025-10-02T15:25:28.214117+00:00"
  },
  "usage": {
    "api_query_units": 0.7
  }
}