（瀑布流）联系人详情

POST

/api/people/enrich

人员 enrich（实现见 PeopleEnrichService）。当前仅读取 identity 与 waterfall（含 byok）。

字段	说明
`identity`	`email`、`first_name`、`last_name`、`domain`、`company_name`、`linkedin` 等（至少部分线索）
`waterfall`	`mode`、`source_order`

（示例中可能含其他键；以服务端为准。）

请求参数

Header 参数

Body 参数application/json

示例

{
  "identity": {
    "first_name": "Jan",
    "last_name": "Shumate",
    "domain": "eastman.com"
  },
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "hunter",
      "snov",
      "apollo",
      "rocketreach"
    ],
    "byok": {
      "apollo_api_key": "<YOUR_APOLLO_KEY>",
      "hunter_api_key": "<YOUR_HUNTER_KEY>",
      "rocketreach_api_key": "<YOUR_ROCKETREACH_KEY>",
      "snov_client_id": "<YOUR_SNOV_CLIENT_ID>",
      "snov_client_secret": "<YOUR_SNOV_CLIENT_SECRET>"
    }
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/people/enrich' \
--header 'Authorization: Bearer {{apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "identity": {
    "first_name": "Jan",
    "last_name": "Shumate",
    "domain": "eastman.com"
  },
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "hunter",
      "snov",
      "apollo",
      "rocketreach"
    ],
    "byok": {
      "apollo_api_key": "<YOUR_APOLLO_KEY>",
      "hunter_api_key": "<YOUR_HUNTER_KEY>",
      "rocketreach_api_key": "<YOUR_ROCKETREACH_KEY>",
      "snov_client_id": "<YOUR_SNOV_CLIENT_ID>",
      "snov_client_secret": "<YOUR_SNOV_CLIENT_SECRET>"
    }
  }
}'

返回响应

🟢200成功

application/json

Body

示例

{
  "success": true,
  "status": "completed",
  "request_id": "req_xxx",
  "person": {
    "emails": []
  },
  "meta": {
    "field_sources": {},
    "billing": {},
    "waterfall": {}
  }
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

修改于 2026-04-15 12:05:45

（瀑布流）联系人搜索

邮箱验证（单个）