（瀑布流）联系人搜索

POST

/api/people/search

瀑布流模式联系人搜索（实时），整合Apollo, Hunter, RocketReach, Snovio等全球知名数据渠道，进行瀑布流式检索，提供First Match (单源优先匹配) 及 Aggregate (多源数据聚合)两种数据返回模式，博采众长。后续可通过姓名/域名/领英链接结果，调用（瀑布流）联系人详情接口获取联系人详细信息。

请求参数

Header 参数

Body 参数application/json

示例

{
  "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"
    ]
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/people/search' \
--header 'Authorization: Bearer {{apiKey}}' \
--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"
    ]
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "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请求过多

修改于 2026-04-22 07:32:23

（瀑布流）企业详情

（瀑布流）联系人详情