Skip to main content
Use these filter endpoints to retrieve the exact values the API accepts before building a company search request. Passing values outside the API’s taxonomy causes searches to return no results, so fetching valid options first ensures your queries work as expected. All filter values returned here are intended for use in POST /prospecting/company/search.

​
Available filter endpoints

​
How to use these endpoints

1

Fetch valid filter values

Call the filter endpoint for the dimension you want to filter on. For example, to get the list of industries:
The response is a bare array of industry objects, each with a main_industry label, a main_industry_id, and a list of sub_industries:
2

Pick the values that match your ICP

Industries are filtered by numeric ID, not by label string. Note the main_industry_id (and any sub_industries[].id) that apply to your target market.
3

Pass them into your company search request

Nest the selected values under filters.companies.include in POST /prospecting/company/search:

​
Text-search endpoints

Three filter endpoints use POST with a text query to search for matching values rather than returning a fixed list.

​
Endpoint details

​
GET /prospecting/filters/companies/industries_labels

Returns the full industry hierarchy, with each main industry’s main_industry_id and its sub_industries IDs, for filtering by numeric ID.

​
GET /prospecting/filters/companies/sizes

Returns available employee headcount ranges as {min, max} objects (e.g., {"min": 1, "max": 10}, {"min": 11, "max": 50}).

​
GET /prospecting/filters/companies/revenues

Returns available annual revenue ranges as {min, max} objects, in raw USD (e.g., {"min": 1, "max": 1000000}).

​
GET /prospecting/filters/companies/sics

Returns available Standard Industrial Classification (SIC) codes for industry-based filtering.

​
GET /prospecting/filters/companies/naics

Returns available North American Industry Classification System (NAICS) codes.

​
GET /prospecting/filters/companies/intent_topics

Returns intent topic labels you can use to target companies actively researching specific subjects.
Cache responses from the GET endpoints - industries, sizes, revenues, SIC codes, NAICS codes, and intent topics change infrequently. Refresh your cache weekly or when a search returns unexpected results.
SIC and NAICS codes provide more granular industry targeting than industry labels. Use them when you need to narrow your search to a specific sub-sector that does not map cleanly to a label.