Skip to main content
POST
Find companies
Search companies by firmographic, location, event, intent, and technology filters, then page through the matching organizations.
Search shares a limit of 6 requests per second per workspace with Company filter values. It costs 0.1 credits per returned company; zero returned rows cost zero credits. At least 0.1 credits must be available before Search begins.
When next_cursor is not null, send the exact value unchanged as cursor with the same filters. Do not decode, construct, or edit the cursor. Cursor pagination preserves the original page size and can traverse up to 10,000 companies for one search. After a 429, wait for the next second and retry with bounded exponential backoff. For temporary 502 or 503 responses, retry with increasing delays and a fixed retry limit. If errors persist, stop retrying and contact support.

Company fields

rows contains public company records. Fields vary with available data; the following list is illustrative, not a set of required fields. The response does not guarantee a stable company ID. Use the available domain or LinkedIn URL to help match records, and handle missing fields.

Discover filter values

Use Company filter values to discover city, region, industry, intent-topic, and technology values, then send the returned value unchanged. Industry and topic values come from canonical lookup lists; keywords and companyName accept free text. Use JSON booleans for hasWebsite and isPublicCompany, not strings such as "true". The largest fixed buckets are 10001+ for employee size, 10T+ for revenue, 20+ for company age, and 1001+ for location count.

Next step

Use Company filter values to discover accepted values, Find people to search for roles at identified companies, or Authentication before integrating.

Authorizations

Authorization
string
header
required

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

Body

application/json

Provide at least one real company filter. Defaults such as eventWindow and locationMatch do not count as filters.

filters
object
required
page
default:0

A zero-based page supplied as an integer JSON number or one of the equivalent canonical decimal strings. OpenAPI intentionally uses canonical decimal strings even though runtime Number() accepts additional spellings.

Required range: x >= 0
size
default:50

A page size from 1 through 100 supplied as an integer JSON number or one of the equivalent canonical decimal strings. OpenAPI intentionally uses canonical decimal strings even though runtime Number() accepts additional spellings.

Required range: 1 <= x <= 100
cursor
string

An opaque fc_ cursor returned by the preceding page. When supplied, its saved page size takes precedence over new page or size values.

Pattern: ^fc_

Response

A page of matching sanitized public company records.

rows
object[]
required
total
number
required
page
number
required
size
number
required
next_cursor
string | null
required