Skip to main content
POST
/
v1
/
search
/
co-mentions
/
topics
Connected Topics
curl --request POST \
  --url https://api.bigdata.com/v1/search/co-mentions/topics \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "query": {
    "text": "Tariffs impact in China",
    "filters": {
      "timestamp": {
        "start": "2023-11-07T05:31:56Z",
        "end": "2023-11-07T05:31:56Z"
      },
      "document_type": {
        "mode": "INCLUDE",
        "values": [
          "NEWS"
        ]
      },
      "source": {
        "mode": "INCLUDE",
        "values": [
          "ED68DC"
        ]
      },
      "keyword": {
        "all_of": [],
        "any_of": [],
        "none_of": [
          "operating"
        ]
      },
      "entity": {
        "all_of": [],
        "any_of": [
          "228D42"
        ],
        "none_of": []
      },
      "sentiment": {
        "values": [
          "positive",
          "negative",
          "neutral"
        ]
      },
      "reporting_entities": [
        "228D42"
      ],
      "reporting_periods": [
        {
          "fiscal_year": 2024,
          "fiscal_quarter": 3
        }
      ],
      "topic": {
        "all_of": [],
        "any_of": [
          "business,stock-prices,stock-price-volatility,down,"
        ],
        "none_of": []
      }
    },
    "limit": 1000
  }
}'
{
  "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": 1
  }
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
query
object
required

Response

200 - application/json

Topics co-mentions results

​
results
object
required

Object containing array of topics that are co-mentioned with the search query.

​
metadata
object

Request metadata and timing information.

​
usage
object

API usage information for the request.

⌘I