Skip to main content
GET
/
v1
/
search
/
company
Search Company Finder
curl --request GET \
  --url https://api.waterfall.io/v1/search/company \
  --header 'x-api-key: <api-key>'
{
  "status": "SUCCEEDED",
  "start_date": "2024-01-15T12:00:00.000000+00:00",
  "stop_date": "2024-01-15T12:00:01.843000+00:00",
  "input": {
    "task": {
      "industries": [
        "software development"
      ],
      "location_countries": [
        "United States"
      ],
      "sizes": [
        "201-500"
      ],
      "page_number": 1,
      "page_size": 20,
      "custom_fields": null,
      "job_id": "4fa6b97b-55d0-49fb-924b-16f4c1b6b03e",
      "context_id": "4fa6b97b-55d0-49fb-924b-16f4c1b6b03e"
    }
  },
  "output": {
    "companies": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "domain": "acme.com",
        "name": "Acme Corp",
        "website": "acme.com",
        "linkedin_id": "acme-corp",
        "description": "Acme Corp builds software solutions for modern sales teams.",
        "logo_url": "https://media.licdn.com/dms/image/acme-corp-logo.png",
        "size": "201-500",
        "employees_count": 350,
        "industry": "Software Development",
        "type": "Privately Held",
        "founded": 2010,
        "address": "100 Market St, San Francisco, California 94105, US",
        "country": "United States",
        "linkedin_url": "https://www.linkedin.com/company/acme-corp/",
        "linkedin_followers": 12500,
        "crunchbase_url": null,
        "funding_details": null
      }
    ]
  }
}
Search Company returns results synchronously from the launcher. Use this endpoint to re-fetch or audit a previous job — not to poll for completion.

​
What you get

The response mirrors the launcher response exactly:
FieldDescription
input.taskEcho of all request fields plus job_id and context_id
output.companiesArray of matched companies — same shape as the launcher response

Authorizations

​
x-api-key
string
header
required

To access the API, provide your API key in x-api-key.

Query Parameters

​
job_id
string<uuid>
required

The unique job_id you want to query. This value is returned by the corresponding launcher endpoint.

A UUID.

Example:

"7d44db58-5de3-4e92-a2fb-8325d12c2e8b"

Response

Search Company job state, input, and any available output.

Search Company response with job state, input, and optional output.

​
status
enum<string>
required

The status of the job.

Available options:
RUNNING,
SUCCEEDED,
FAILED,
TIMED_OUT,
ABORTED
Example:

"RUNNING"

​
start_date
string<date-time>
required

A date time in ISO 8601 format.

Example:

"2025-02-05T15:46:35.771Z"

​
input
object
required
Example:
{
  "task": {
    "industries": ["software development"],
    "location_countries": ["United States"],
    "sizes": ["201-500"],
    "page_number": 1,
    "page_size": 20,
    "job_id": "7d44db58-5de3-4e92-a2fb-8325d12c2e8b",
    "context_id": "7d44db58-5de3-4e92-a2fb-8325d12c2e8b"
  }
}
​
stop_date
string<date-time>

A date time in ISO 8601 format.

Example:

"2025-02-05T15:46:35.771Z"

​
output
object

Search Company output payload.

Example:
{ "companies": [] }