Search Contact Launcher
Search for contacts by LinkedIn, company identity, or persona filters.
output.persons is included directly in the response. There is no separate polling step.linkedin_url as the linkedin field in Contact Enrichment Launcher.
Search modes
Authorizations
To access the API, provide your API key in x-api-key.
Body
Search Contact request payload with filters and pagination options.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
Request payload for Search Contact.
Search mode must be one of: 1) contact_linkedin 2) company-specific search with one of domain, company_linkedin, company_name 3) company-set search with one of company_location_countries, company_industries, or
company_employee_ranges (in this mode, experience_start_date or
experience_start_date_new_hire is required, and one of title_filters or
title_lists is required).
Company LinkedIn URL or ID/handle (for example google from https://www.linkedin.com/company/google/). Recommended input to maximize coverage.
3 - 500"waterfall-io"
The domain where you want to find contacts. It can be a plain domain or a full URL; Waterfall automatically extracts the company domain.
4 - 500"waterfall.io"
Company LinkedIn URL or ID/handle (for example google from https://www.linkedin.com/company/google/). Recommended input to maximize coverage.
3 - 500"waterfall-io"
The name of the company where you want to find contacts.
3 - 500"Waterfall"
Names to exclude from results.
200Full name of the contact. Providing first_name and last_name is preferable when both are available.
4 - 250"John Doe"
If provided, restrict results to these names.
100Full name of the contact. Providing first_name and last_name is preferable when both are available.
4 - 250"John Doe"
Boolean title filters.
5Named title lists.
5Contact department filters.
Contact department returned on person payloads.
Leadership, Engineering, Product Management, Sales, Marketing, Customer Success, Finance, Accounting, Legal, Human Resources, Information Technology, Operations, Education, Other 5 - 22Contact seniority filters.
Contact seniority returned on person payloads.
Owner, CXO, Partner, Vice President, Director, Manager, Senior, Entry, Other 3 - 14Contact location countries.
50Country of the contact's current address. Use full country names (for example, United States or France).
1 - 200"United States"
Company location countries.
50Country of the contact's current address. Use full country names (for example, United States or France).
1 - 200"United States"
Company industries.
50LinkedIn 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 - 57Company employee size ranges.
8LinkedIn employee-size bucket.
1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ Find contacts who started their current role on or after the specified date (YYYY-MM-DD).
"2024-01-01"
Find new hires who started their current role on or after the specified date (YYYY-MM-DD).
"2025-01-01"
Page number for paginated Search Contact results.
1 <= x <= 1001
Number of contacts to return per page in Search Contact.
1 <= x <= 25010
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 Contact result returned successfully.
Search Contact 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 Contact output payload.