Returns one page of company records for a company filter, in a fixed order. Each returned company costs one contact credit, through the same plan caps as contacts. Page with `cursor` until `page.next_cursor` is null. To find the people at these companies, send their ids to `POST /contacts/search` in the `company_ids` filter key.
Contact creditsEach returned company costs one contact credit.
Returns one page of company records for a company filter, in a fixed order. Each returned company costs one contact credit, through the same plan caps as contacts. Page with cursor until page.next_cursor is null. To find the people at these companies, send their ids to POST /contacts/search in the company_ids filter key.
Company ids (com_) to include. Takes up to 1,000 ids.
domainsarray of stringoptional
Company domains. A company matches when any of its domains is in the list. A full URL reduces to a bare domain on input.
exclude_domainsarray of stringoptional
Company domains to exclude. A company is left out when any of its domains is in the list.
company_namesarray of stringoptional
Company names. Case-insensitive exact match after normalization. Lowercase, trim and collapse whitespace. Strip one trailing legal suffix with an optional comma, then a leading "the ". Legal suffixes: inc, inc., incorporated, llc, l.l.c., ltd, ltd., limited, corp, corp., corporation, co, co., gmbh, ag, sa, s.a., bv, b.v., plc, pty ltd, srl. An empty normalized name returns 400 request.invalid. Values are OR within this key and AND across keys.
exclude_company_namesarray of stringoptional
The NOT of company_names after the same normalization. Lowercase, trim and collapse whitespace. Strip one trailing legal suffix with an optional comma, then a leading "the ". Legal suffixes: inc, inc., incorporated, llc, l.l.c., ltd, ltd., limited, corp, corp., corporation, co, co., gmbh, ag, sa, s.a., bv, b.v., plc, pty ltd, srl. An empty normalized name returns 400 request.invalid. Values are OR within this key and AND across keys.
company_sizearray of CompanySizeoptional
Company employee bands to include.
1-1011-5051-200201-500501-1K1K-5K5K-10K10K+
company_revenuearray of CompanyRevenueoptional
Company revenue ranges to include. Only companies with a known revenue range match; most small companies have none, so this key leaves them out.
0-1M1M-10M10M-50M50M-100M100M-1B1B+
industriesarray of Industryoptional
Company industries to include, as slugs such as software_development. A label such as 'Software Development' or 'IT Services & IT Consulting' is folded to its slug. Read the values from GET /companies/schema/industries/values.
exclude_industriesarray of Industryoptional
Company industries to exclude, as slugs such as software_development. A label such as 'Software Development' or 'IT Services & IT Consulting' is folded to its slug. Read the values from GET /companies/schema/industries/values.
employee_count_minintegeroptional
The smallest company employee count, inclusive.
employee_count_maxintegeroptional
The largest company employee count, inclusive.
founded_year_minintegeroptional
The earliest company founding year, inclusive.
founded_year_maxintegeroptional
The latest company founding year, inclusive.
company_hq_countriesarray of Countryoptional
Company headquarters countries to include. Send ISO-2 codes such as us, or English names such as Germany.
last_round_afterYearMonthoptional
The latest financing event is after this month, exclusive.
last_round_beforeYearMonthoptional
The latest financing event is before this month, exclusive.
The request shape, a filter key, a value, a cursor or the enrichment mode was rejected.
401
The credential is missing, unknown or revoked.
402
The daily or the monthly contact credit cap is spent, or the free plan's lifetime pool is.
422
The filter was rejected before it ran: more than 32 predicates, deeper than 4, more than 25 leaves, more than 1,000 domains or company names, more than 50 values in another list, a leading wildcard in a where leaf, a leading or trailing wildcard in title_query, an operator, value type or shape the column does not take, a leaf other than exists with no value, or an empty `and` or `or` group.
429
The key passed 300 requests a minute or 2 concurrent requests.