# People API 搜索

**API:** Data API

**Endpoint:** `POST /v1/beta/apollo/mixed_people/api_search`

**Tags:** Apollo

按条件查找人物，而不是补全你已经确定的人。可按职位、资历、地点、公司域名、员工人数和行业筛选，并使用 `page` 和 `per_page` 分页。返回 `total_entries` 和 `people` 数组。注意搜索会刻意隐藏哪些信息：条目返回的是 `last_name_obfuscated` 和布尔标志——`has_email`、`has_direct_phone`、`has_city`、`has_state`、`has_country`——而非具体值。搜索只告诉你存在匹配项；补全才会揭示联系方式。将 id 传入 `post_apollo_people_match` 或 `post_apollo_people_bulk_match` 以获取邮箱和电话号码，额度也是在那里消耗的。需要 Felo 管理员权限。

### 计费参考

- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.012 美元。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `contact_email_status[]` | query | no | array | 要查找的人员的邮箱状态。可添加多个状态以扩大搜索范围。可搜索的状态包括：verified unverified likely to engage unavailable |
| `currently_not_using_any_of_technology_uids[]` | query | no | array | 根据此人当前雇主使用的任一技术，将人员排除在搜索之外。Apollo 支持按 1,500 多种技术筛选。Apollo 从多个来源计算技术数据，并定期更新。下载此 CSV 文件即可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org |
| `currently_using_all_of_technology_uids[]` | query | no | array | 根据此人当前雇主使用的所有技术查找人员。Apollo 支持按 1,500 多种技术筛选。Apollo 从多个来源计算技术数据，并定期更新。下载此 CSV 文件即可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org |
| `currently_using_any_of_technology_uids[]` | query | no | array | 根据此人当前雇主使用的任一技术查找人员。Apollo 支持按 1,500 多种技术筛选。Apollo 从多个来源计算技术数据，并定期更新。下载此 CSV 文件即可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org |
| `include_similar_titles` | query | no | boolean | 此参数决定响应中是否返回职位名称与你通过 person_titles[] 参数定义的名称相似的人员。使用 person_titles[] 仅返回职位名称的严格匹配时，请将此参数设为 false。 |
| `organization_ids[]` | query | no | array | 要纳入搜索结果的公司（雇主）的 Apollo ID。Apollo 数据库中的每家公司都会被分配一个唯一 ID。要查找 ID，请调用 Organization Search 端点并确认 organization_id 的值。示例：5e66b6381e05b4008c8331b8 |
| `organization_job_locations[]` | query | no | array | 此人雇主正在积极招聘的职位所在地。示例：atlanta; japan |
| `organization_job_posted_at_range[max]` | query | no | string | 此人当前雇主发布职位的最晚日期。与 organization_job_posted_at_range[min] 配合使用可设置职位发布时间范围。示例：2025-09-25 |
| `organization_job_posted_at_range[min]` | query | no | string | 此人当前雇主发布职位的最早日期。与 organization_job_posted_at_range[max] 配合使用可设置职位发布时间范围。示例：2025-07-25 |
| `organization_locations[]` | query | no | array | 此人当前雇主的公司总部位置。可跨城市、美国各州和国家搜索。如果公司有多个办公地点，结果仍以总部位置为准。例如，搜索 chicago，但公司总部位于 boston，则为这家总部在波士顿的公司工作的人员不会出现在结果中，即使他们匹配其他参数。要按人员个人所在地查找，请使用 person_locations 参数。示例：texas; tokyo; spain |
| `organization_num_employees_ranges[]` | query | no | array | 此人当前公司的员工人数区间。可据此按雇主的员工人数查找人员。可添加多个区间以扩大搜索结果。添加的每个区间必须是字符串，区间的上下限之间只用逗号分隔。示例：1,10; 250,500; 10000,20000 |
| `organization_num_jobs_range[max]` | query | no | integer | 此人当前雇主活跃的职位发布数量上限。与 organization_num_jobs_range[min] 配合使用可设置职位发布数量区间。示例：50; 500 |
| `organization_num_jobs_range[min]` | query | no | integer | 此人当前雇主活跃的职位发布数量下限。与 organization_num_jobs_range[max] 配合使用可设置职位发布数量区间。示例：50; 500 |
| `page` | query | no | integer | 要检索的 Apollo 数据页码。与 per_page 参数配合使用，可让搜索结果支持翻页并提升端点性能。示例：4 |
| `per_page` | query | no | integer | 每页应返回的搜索结果数量。限制每页结果数可提升端点性能。使用 page 参数可检索不同页的数据。示例：10 |
| `person_locations[]` | query | no | array | 人员居住的地点。可跨城市、美国各州和国家搜索。要按此人当前雇主的总部位置查找人员，请使用 organization_locations 参数。示例：california; ireland; chicago |
| `person_seniorities[]` | query | no | array | 此人在当前雇主中的职位资历。可据此查找目前处于特定汇报层级的人员，例如总监级或资深 IC 级。人员只需匹配你添加的任一资历即可进入搜索结果。添加更多资历会扩大搜索结果。搜索仅依据当前职位名称返回结果，因此搜索总监级员工只会返回目前持有总监级职位名称的人。如果某人过去是总监、目前是副总裁，则不会出现在搜索结果中。将此参数与 person_titles[] 参数配合使用，可按具体职能和资历层级查找人员。此参数可使用以下选项：owner founder c_suite partner vp head director manager senior entry intern |
| `person_titles[]` | query | no | array | 要查找的人员所持有的职位名称。人员只需匹配你添加的任一职位名称即可进入搜索结果。添加更多职位名称会扩大搜索结果。结果也会包含使用相同词语的职位名称，即使并非完全匹配。例如，搜索 marketing manager 可能会返回职位名称为 content marketing manager 的人员。将此参数与 person_seniorities[] 参数配合使用，可按具体职能和资历层级查找人员。示例：sales development representative; marketing manager; research analyst |
| `q_keywords` | query | no | string | 用于筛选结果的词语字符串。 |
| `q_organization_domains_list[]` | query | no | array | 此人雇主的域名。可以是当前雇主或前雇主。不要包含 www.、@ 符号或类似内容。此参数在单个请求中最多接受 1,000 个域名。示例：apollo.io; microsoft.com |
| `q_organization_job_titles[]` | query | no | array | 此人当前雇主在活跃职位发布中列出的职位名称。示例：sales manager; research analyst |
| `revenue_range[max]` | query | no | integer | 此人当前雇主的营收上限。与 revenue_range[min] 配合使用可设置营收区间。数字中不要输入货币符号、逗号或小数点。示例：500000; 1500000 |
| `revenue_range[min]` | query | no | integer | 此人当前雇主的营收下限。与 revenue_range[max] 配合使用可设置营收区间。数字中不要输入货币符号、逗号或小数点。示例：500000; 1500000 |

## Responses

### 200 — 成功响应

Headers:
- `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "total_entries": {
      "type": "integer",
      "description": "响应字段"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "响应数组"
    }
  }
}
```

### 400 — 无法处理该请求。请检查请求参数。

### 401 — 需要有效的 Felo API 密钥。

### 402 — 由于未满足计费要求，请求无法继续。

### 403 — 该账户无权执行此操作。

### 429 — 已达到请求或支出限额。

### 502 — 服务无法完成该请求。

### 503 — API 或计费服务暂时不可用。

### 504 — 服务在处理请求时超时。

### default — 错误响应；上游透传响应可能采用提供方格式

**application/json**

Schema:

```json
{}
```