（瀑布流）联系人搜索

POST

/api/people/search

人员搜索（PeopleSearchBodyDto 白名单顶层键；业务读取见 parsePeopleSearchAdvanced）。

顶层字段	说明
`page` / `per_page`	分页；`per_page` 上限 100
`waterfall`	`mode`、`min_results`、`source_order`（apollo \| hunter \| rocketreach）、`byok`
`company`	`domains`、`names`、`technologies`、`employee_count_ranges` 等
`job`	`job_titles`、`departments`、`seniorities`
`company_locations`	`country_code` / `city` / `state`（公司地址，Apollo）
`person_locations`	同上（联系人地址，多源）
`person`	`first_name`、`last_name`
`education`	`schools`
`contact_requirements`	`contact_email_status`

请求参数

Header 参数

Body 参数application/json

示例

{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "min_results": 10,
    "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_locations": {
    "country_code": [
      "US"
    ]
  },
  "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 --request POST '/api/people/search' \
--header 'Authorization: Bearer {{apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "min_results": 10,
    "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_locations": {
    "country_code": [
      "US"
    ]
  },
  "person": {
    "first_name": "Jane",
    "last_name": "Doe"
  },
  "education": {
    "schools": [
      "Stanford University"
    ]
  },
  "contact_requirements": {
    "contact_email_status": [
      "verified",
      "likely_to_engage"
    ]
  }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "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-15 12:12:45

（瀑布流）企业详情

（瀑布流）联系人详情