Get filter values

Retrieve every value a category filter can take, so a filter can be built without guessing its values. Values are returned in the exact form the corresponding search filter accepts: countries as ISO 3166-1 alpha-2 codes, source ranks as RANK_1..RANK_5, and so on.

The full sorted list is returned; there is no narrowing parameter, and lists are capped at 5000 values.

Every filter of every category is available except three on sources, which are stored in a way that cannot be enumerated and return 404: packages, categories and tiers.

GET /v1/knowledge-graph/{category}/values/{filter}

Get filter values

cURL

curl --request GET \
  --url https://api.bigdata.com/v1/knowledge-graph/{category}/values/{filter} \
  --header 'X-API-KEY: <api-key>'

200

{
  "values": [
    "Africa",
    "Antarctica",
    "Asia",
    "Europe",
    "North America",
    "Oceania",
    "South America"
  ],
  "metadata": {
    "request_id": "18f8fbd1-fa1d-4c67-9dd5-a2434ce1a6b5",
    "timestamp": "2025-10-08T06:35:46.901505+00:00"
  }
}

Authorizations

X-API-KEY · string · header · required

Path Parameters

category · enum<string> · required

Knowledge Graph category

Available options: companies, concepts, etfs, funds, organizations, people, places, products, sources, topics

filter · string · required

Name of the filter to list values for, as it appears in that category's request body (e.g. countries for places, ranks for sources, statuses for ETFs)

Response

200

application/json

Successful response with the values available for that filter

values · string[] · required

Every value the filter accepts, sorted

Example:

[
  "Africa",
  "Antarctica",
  "Asia",
  "Europe",
  "North America",
  "Oceania",
  "South America"
]

metadata · object

Show child attributes