POST 人员搜索

POST

/api/people/search

请求参数

Header 参数

Body 参数application/json

示例

{
  "page": 1,
  "per_page": 10,
  "waterfall": {
    "mode": "first_match",
    "source_order": [
      "apollo",
      "hunter",
      "rocketreach"
    ],
    "byok": {
      "apollo_api_key": "<YOUR_APOLLO_KEY>",
      "hunter_api_key": "<YOUR_HUNTER_KEY>",
      "rocketreach_api_key": "<YOUR_ROCKETREACH_KEY>"
    }
  },
  "company": {
    "domains": [
      "eastman.com"
    ],
    "technologies": [
      "salesforce"
    ],
    "employee_count_ranges": [
      {
        "min": 100,
        "max": 50000
      }
    ],
    "annual_revenue_ranges": [
      {
        "min": "100000",
        "max": "5000000"
      }
    ]
  },
  "job": {
    "job_titles": [
      "vp"
    ],
    "departments": [
      "sales"
    ],
    "seniorities": [
      "vp"
    ]
  },
  "company_locations": {
    "country_code": [
      "US"
    ],
    "city": [
      "San Francisco"
    ],
    "state": [
      "California"
    ]
  },
  "person_locations": {
    "country_code": [
      "US"
    ],
    "city": [
      "San Francisco"
    ],
    "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 --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",
    "source_order": [
      "apollo",
      "hunter",
      "rocketreach"
    ],
    "byok": {
      "apollo_api_key": "<YOUR_APOLLO_KEY>",
      "hunter_api_key": "<YOUR_HUNTER_KEY>",
      "rocketreach_api_key": "<YOUR_ROCKETREACH_KEY>"
    }
  },
  "company": {
    "domains": [
      "eastman.com"
    ],
    "technologies": [
      "salesforce"
    ],
    "employee_count_ranges": [
      {
        "min": 100,
        "max": 50000
      }
    ],
    "annual_revenue_ranges": [
      {
        "min": "100000",
        "max": "5000000"
      }
    ]
  },
  "job": {
    "job_titles": [
      "vp"
    ],
    "departments": [
      "sales"
    ],
    "seniorities": [
      "vp"
    ]
  },
  "company_locations": {
    "country_code": [
      "US"
    ],
    "city": [
      "San Francisco"
    ],
    "state": [
      "California"
    ]
  },
  "person_locations": {
    "country_code": [
      "US"
    ],
    "city": [
      "San Francisco"
    ],
    "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

Body

示例

{
  "success": true,
  "request_id": "req_xxx",
  "people": [],
  "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": []
    }
  },
  "error": null
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

修改于 2026-04-18 17:51:40

POST 公司 enrich

POST 人员 enrich