Search Companies
Returns companies matching at least one filter. Filters can be combined.
At least one filter is required (website, employees/employees_min/employees_max, industry, social URLs) or the API returns 422.
websiteis normalized to a domain (strips scheme, www) and matched againstcompanies.domain_rootORcompany_profile_observations.website_url(substring match).employeesis an exact match. Otherwiseemployees_min/employees_maxapply as range filters.industryis provided as an array in the docs UI. Your API can still accept a single value; users can just enter one item.- Social inputs are combined into a single list and matched exactly against observed social profile URLs for the latest run.
Results are returned with latest observed profile fields plus enriched industries and social links.
Authorizations
Use Authorization: Bearer <prefix>.<secret>.
Query Parameters
Page number (min 1).
x >= 1Results per page (min 1, max 200). Default is 50.
1 <= x <= 200Website or domain to match. Normalized to a host (scheme optional). Example: https://example.com or example.com.
2048Exact employee count match (integer >= 0). If provided, employees_min/max are ignored.
x >= 0Minimum employee count (integer >= 0). Used when employees not provided.
x >= 0Maximum employee count (integer >= 0). Used when employees not provided.
x >= 0Industry filter (repeatable). Enter one or more industry names. Match is substring on industry name.
Examples in querystring:
?industry=FinTech&industry=Cybersecurity(explode=true)
Note: The backend may also accept a single industry value; in the docs UI you can just enter one item.
1160Array of social profile URLs to match exactly. Example: social_urls=https://linkedin.com/company/acme&social_urls=https://x.com/acme
2048Single LinkedIn profile URL to match exactly (added to the social URLs list).
2048Single Facebook profile URL to match exactly (added to the social URLs list).
2048Single X (Twitter) profile URL to match exactly (added to the social URLs list).
2048
