Skip to main content
POST
cURL
Find companies similar to one or more reference companies. The request waits for the search to finish and returns company data directly.
Costs 0.5 credits per unique returned company. Before searching, the API reserves limit × 0.5 credits and refunds the unused amount afterward. Zero results cost zero credits. Each workspace can start 15 searches per rolling minute and have 5 active searches at a time.
Authenticate with your workspace API key. See Authentication.

Reference domains and result limits

Send 1–10 company websites in domains. Domains and website URLs are normalized and deduplicated. LinkedIn URLs and IP addresses are not accepted. Reference companies and domains listed in exclude.domains are omitted from results. limit defaults to 2,000 and applies to the entire response: For example, ten reference domains with limit: 5000 request at most 5,000 unique companies in total. Results are deduplicated across references and may be fewer than requested. All results are returned in a single response.

Filters

Use include and exclude to filter by country, city, and employee size. Country filters accept country names or ISO alpha-2 codes. A location filter that cannot be resolved can return 422. Each country or city list accepts up to 100 values. Supported size bands are 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, and 10001+. Use exclude.domains to omit up to 900 company websites. Use founded.min and founded.max for founding-year bounds from 1000 through 9999; the minimum cannot exceed the maximum.

Company fields

The response contains status, total_results, credits_used, data, and warnings. Every company in data includes all of these fields: Missing text fields are empty strings. Companies matching more reference domains appear first. Check warnings for any reference companies that could not be searched. No matches returns an empty data array and costs zero credits.

Credits

A request with limit: 10 requires 5 available credits; limit: 5000 requires 2,500. Insufficient available credits returns 402. The final charge is based on the unique companies returned, and credits_used reports that amount.
Do not automatically retry this request. A search may complete even when you receive an error or no response, and repeating it can cause another charge.

Timing and errors

Allow at least 100 seconds for your client timeout. If a search times out, try fewer reference companies or a lower result limit. A rate or concurrency limit returns 429. Wait for the number of seconds in Retry-After when present. See Rate limits.

Next step

Use Find people to search for roles at matching companies, or Find companies to search using firmographic filters instead of reference domains.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json
domains
string[]
required

Reference company websites, normalized to domains and deduplicated. Accepts domains or website URLs, not LinkedIn URLs or IP addresses. Reference companies are excluded from results.

Required array length: 1 - 10 elements
Required string length: 1 - 2048
limit
integer
default:2000

Total unique results across all references, not per domain. Maximum min(5000, 2000 × distinct normalized reference domains): 2000 for one, 4000 for two, 5000 for three through ten. Searches may return fewer results.

Required range: 1 <= x <= 5000
include
object

Optional company filters to include.

exclude
object

Optional company filters and domains to exclude.

founded
object

Optional founding-year bounds. min cannot exceed max.

Response

Completed search. Companies are unique by domain. Partial reference failures can return remaining results with warnings. Empty results cost zero credits.

status
string
required
Allowed value: "success"
total_results
integer
required

Number of companies in data.

Required range: 0 <= x <= 5000
credits_used
number
required

Actual charge: total_results × 0.5 credits.

Required range: 0 <= x <= 2500
data
object[]
required
Maximum array length: 5000
warnings
string[]
required

Partial reference failures or omitted invalid websites. Empty when no warnings occurred.