v1

latestOpenAPI 3.1.02026-07-2268276396.6 KB

Co-mentions

Connected Topics

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

post/v1/search/co-mentions/topics

Request body

limitinteger

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

Example request

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

Response

Topics co-mentions results

Example response

{
  "results": {
    "topics": [
      {
        "id": "economy,taxes,import-tax,,",
        "total_chunks_count": 2787,
        "total_headlines_count": 384
      }
    ]
  },
  "metadata": {
    "request_id": "0d353dca-fc68-41ff-9f40-c27206f1650d",
    "timestamp": "2025-10-02T15:24:34.017171+00:00"
  },
  "usage": {
    "api_query_units": 0.7
  }
}