(Waterfall) Company Search

POST

{{baseUrl}}/api/company/search

Last modified:2026-07-16 18:30:38

Waterfall-mode company search (real-time), integrating global data sources such as Apollo, Hunter, RocketReach, Google Map, and Storelead, performs waterfall-style retrieval and offers two return modes: First Match (single-source priority matching) and Aggregate (multi-source data aggregation), leveraging the strengths of multiple sources. Subsequent results (company name or domain) can be used to call the (waterfall) company details API to obtain detailed company information.

Request

Header Params

Body Params application/json

Example

{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "hunter",
      "apollo",
      "rocketreach",
      "map",
      "storelead"
    ]
  },
  "company": {
    "domains": [
      "stripe.com"
    ],
    "keywords": {
      "include": [
        "fintech"
      ]
    }
  },
  "industry": {
    "include": [
      "Computer Software"
    ]
  },
  "technologies": {
    "include": [
      "react"
    ]
  },
  "location": {
    "country_code": [
      "US"
    ],
    "cities": [
      "San Francisco"
    ],
    "states": [
      "California"
    ]
  },
  "size": {
    "employee_ranges": [
      {
        "min": 51,
        "max": 10000
      }
    ]
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '{{baseUrl}}/api/company/search' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "hunter",
      "apollo",
      "rocketreach",
      "map",
      "storelead"
    ]
  },
  "company": {
    "domains": [
      "stripe.com"
    ],
    "keywords": {
      "include": [
        "fintech"
      ]
    }
  },
  "industry": {
    "include": [
      "Computer Software"
    ]
  },
  "technologies": {
    "include": [
      "react"
    ]
  },
  "location": {
    "country_code": [
      "US"
    ],
    "cities": [
      "San Francisco"
    ],
    "states": [
      "California"
    ]
  },
  "size": {
    "employee_ranges": [
      {
        "min": 51,
        "max": 10000
      }
    ]
  }
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
  "success": true,
  "request_id": "req_xxx",
  "companies": [],
  "meta": {
    "total_results": 0,
    "page": 1,
    "per_page": 10,
    "has_more": false,
    "billing": {
      "credits_charged": 0,
      "byok_used": false,
      "platform_credits_charged": 0
    },
    "waterfall": {
      "mode": "first_match",
      "source_hit": null,
      "sources_attempted": [],
      "sources_skipped": [],
      "latency_ms": 0
    },
    "post_filtered": false
  },
  "error": null
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

Modified at 2026-07-16 18:30:38

(Waterfall) Company Search

(Waterfall) Company Enrichment