(Waterfall) Contact Search

POST

{{baseUrl}}/api/people/search

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

Waterfall-mode contact search (real-time) integrates global data providers such as Apollo, Hunter, RocketReach, and Snovio to perform waterfall-style retrieval, offering two data return modes: First Match (single-source priority matching) and Aggregate (multi-source data aggregation), leveraging the strengths of multiple sources. Subsequently, using the returned name, domain, or LinkedIn URL, call the (waterfall) contact details API to obtain detailed contact information.

Request

Header Params

Body Params application/json

Example

{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "apollo",
      "hunter",
      "rocketreach"
    ]
  },
  "company": {
    "domains": [
      "eastman.com"
    ],
    "technologies": [
      "salesforce"
    ],
    "employee_count_ranges": [
      {
        "min": 100,
        "max": 50000
      }
    ],
    "annual_revenue_ranges": [
      {
        "min": "100000"
      }
    ]
  },
  "job": {
    "job_titles": [
      "vp"
    ],
    "departments": [
      "sales"
    ],
    "seniorities": [
      "vp"
    ]
  },
  "company_locations": {
    "country_code": [
      "US"
    ],
    "state": [
      "California"
    ]
  },
  "person": {
    "first_name": "Jane",
    "last_name": "Doe"
  },
  "education": {
    "schools": [
      "Stanford University"
    ]
  },
  "contact_requirements": {
    "contact_email_status": [
      "verified",
      "likely_to_engage"
    ]
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '{{baseUrl}}/api/people/search' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "apollo",
      "hunter",
      "rocketreach"
    ]
  },
  "company": {
    "domains": [
      "eastman.com"
    ],
    "technologies": [
      "salesforce"
    ],
    "employee_count_ranges": [
      {
        "min": 100,
        "max": 50000
      }
    ],
    "annual_revenue_ranges": [
      {
        "min": "100000"
      }
    ]
  },
  "job": {
    "job_titles": [
      "vp"
    ],
    "departments": [
      "sales"
    ],
    "seniorities": [
      "vp"
    ]
  },
  "company_locations": {
    "country_code": [
      "US"
    ],
    "state": [
      "California"
    ]
  },
  "person": {
    "first_name": "Jane",
    "last_name": "Doe"
  },
  "education": {
    "schools": [
      "Stanford University"
    ]
  },
  "contact_requirements": {
    "contact_email_status": [
      "verified",
      "likely_to_engage"
    ]
  }
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
  "success": true,
  "request_id": "req_8OlGEbc92xIe",
  "meta": {
    "total_results": 0,
    "page": 1,
    "per_page": 10,
    "has_more": false,
    "post_filtered": false,
    "billing": {
      "credits_charged": 0,
      "byok_used": false,
      "platform_credits_charged": 0
    },
    "waterfall": {
      "mode": "first_match",
      "source_hit": null,
      "short_circuited": false,
      "sources_attempted": [
        "apollo",
        "hunter",
        "rocketreach"
      ],
      "sources_skipped": [
        {
          "source": "apollo",
          "reason": "no_match"
        },
        {
          "source": "hunter",
          "reason": "no_match"
        },
        {
          "source": "rocketreach",
          "reason": "no_match"
        }
      ],
      "latency_ms": 5663,
      "post_filter_removed": 0
    }
  },
  "people": [],
  "error": null
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

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

(Waterfall) People Search

(Waterfall) Contact Enrichment