Search Company Launcher
Search for companies by industry, location, and size.
output.companies is included directly in the response. There is no separate polling step.Filters
At least one of the following must be provided:Output
Each company inoutput.companies includes name, domain, LinkedIn, employee count, industry, founding year, address, and funding details where available.Authorizations
To access the API, provide your API key in x-api-key.
Body
Search Company request payload with company filters, pagination, and optional custom_fields.
- Option 1
- Option 2
- Option 3
Request payload for Search Company.
At least one non-empty list among industries, location_countries, or sizes must be provided.
Industry filters used to match companies.
1 - 50 elementsLinkedIn industry filter value. Use title-case industry names from the supported industry list: https://waterfall-io-public.s3.us-east-1.amazonaws.com/industries.txt.
5 - 57Country filters used to match companies.
50Country filter value for Search Company.
4 - 40LinkedIn employee-size buckets used to filter companies.
8LinkedIn employee-size bucket.
1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ Page number for paginated Search Company results.
1 <= x <= 1001
Number of companies to return per page in Search Company.
1 <= x <= 25020
Optional custom key-value metadata echoed on job input and output (useful for correlating internal source metadata). On create requests, omit the field or send JSON null when no custom fields are needed; both are stored as {}. When present, the value must be a JSON object with keys matching ^[A-Za-z0-9_-]+$ and values that are a string (max 1000 characters), number, or boolean. Empty string, arrays, and other non-object types return HTTP 400. On job GET responses, input.task.custom_fields is always an object ({} or populated).
Response
Search Company result returned successfully.
Search Company response with job state, input, and optional output.
The status of the job.
RUNNING, SUCCEEDED, FAILED, TIMED_OUT, ABORTED "RUNNING"
A date time in ISO 8601 format.
"2025-02-05T15:46:35.771751+00:00"
A date time in ISO 8601 format.
"2025-02-05T15:46:35.771751+00:00"
Search Company output payload.