Skip to main content
GET
Get Companies

Authorizations

Authorization
string
header
required

API key for Companies API authentication. Include as Bearer token in Authorization header.

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
limit
integer
default:20

Number of results per page (maximum 100)

Required range: 1 <= x <= 100

Free-text search across company name, industry, description, keywords, and specialties

domain
string

Resolve a specific company by its website domain (exact match, not fuzzy). Accepted URL variants — scheme, www., port, path and trailing slash — are normalized. Invalid syntax returns 400; a valid domain with no match returns an empty data set. ANDed with any other filters.

linkedin_url
string

Resolve a specific company by its LinkedIn URL (exact match, not fuzzy). Scheme, www. and a trailing slash are normalized. Invalid syntax returns 400; a valid URL with no match returns an empty data set. ANDed with any other filters.

countries
string

Comma-separated list of country codes to filter by

exclude_countries
string

Comma-separated list of country names or codes to EXCLUDE (denylist), e.g. China or CN. Complements countries. Companies with an unknown/NULL HQ country are kept, not excluded.

industry
string

Comma-separated list of industry names to filter by (exact match)

categories
string

Pipe-separated list of company industry categories to filter by

subcategories
string

Comma-separated list of subcategory IDs to filter by

employee_count_min
integer

Minimum employee count

Required range: x >= 0
employee_count_max
integer

Maximum employee count

Required range: x >= 0
founded_year_min
integer

Minimum founded year

Required range: x >= 1800
founded_year_max
integer

Maximum founded year

Required range: x >= 1800
sort_by
enum<string>
default:name

Field to sort by

Available options:
name,
employee_count,
founded_year,
created_at
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
count
enum<string>

If set to true, returns only the total count without data rows and without deducting credits.

Available options:
true

Response

Successful response with companies

success
boolean
required

Indicates if the request was successful

Example:

true

data
object[]
required

Array of company records

pagination
object
required
meta
object
required