Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
People API 搜索
按条件查找人物，而不是补全你已经确定的人。可按职位、资历、地点、公司域名、员工人数和行业筛选，并使用 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 计费记录为准。
- 类型: array string[]contact
_email _status[] 要查找的人员的邮箱状态。可添加多个状态以扩大搜索范围。可搜索的状态包括：verified unverified likely to engage unavailable
- 类型: array string[]currently
_not _using _any _of _technology _uids[] 根据此人当前雇主使用的任一技术，将人员排除在搜索之外。Apollo 支持按 1,500 多种技术筛选。Apollo 从多个来源计算技术数据，并定期更新。下载此 CSV 文件即可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org
- 类型: array string[]currently
_using _all _of _technology _uids[] 根据此人当前雇主使用的所有技术查找人员。Apollo 支持按 1,500 多种技术筛选。Apollo 从多个来源计算技术数据，并定期更新。下载此 CSV 文件即可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org
- 类型: array string[]currently
_using _any _of _technology _uids[] 根据此人当前雇主使用的任一技术查找人员。Apollo 支持按 1,500 多种技术筛选。Apollo 从多个来源计算技术数据，并定期更新。下载此 CSV 文件即可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org
- 类型: booleaninclude
_similar _titles 此参数决定响应中是否返回职位名称与你通过 person_titles[] 参数定义的名称相似的人员。使用 person_titles[] 仅返回职位名称的严格匹配时，请将此参数设为 false。
- 类型: array string[]organization
_ids[] 要纳入搜索结果的公司（雇主）的 Apollo ID。Apollo 数据库中的每家公司都会被分配一个唯一 ID。要查找 ID，请调用 Organization Search 端点并确认 organization_id 的值。示例：5e66b6381e05b4008c8331b8
- 类型: array string[]organization
_job _locations[] 此人雇主正在积极招聘的职位所在地。示例：atlanta; japan
- 类型: stringorganization
_job _posted _at _range[max] 此人当前雇主发布职位的最晚日期。与 organization_job_posted_at_range[min] 配合使用可设置职位发布时间范围。示例：2025-09-25
- 类型: stringorganization
_job _posted _at _range[min] 此人当前雇主发布职位的最早日期。与 organization_job_posted_at_range[max] 配合使用可设置职位发布时间范围。示例：2025-07-25
- 类型: array string[]organization
_locations[] 此人当前雇主的公司总部位置。可跨城市、美国各州和国家搜索。如果公司有多个办公地点，结果仍以总部位置为准。例如，搜索 chicago，但公司总部位于 boston，则为这家总部在波士顿的公司工作的人员不会出现在结果中，即使他们匹配其他参数。要按人员个人所在地查找，请使用 person_locations 参数。示例：texas; tokyo; spain
- 类型: array string[]organization
_num _employees _ranges[] 此人当前公司的员工人数区间。可据此按雇主的员工人数查找人员。可添加多个区间以扩大搜索结果。添加的每个区间必须是字符串，区间的上下限之间只用逗号分隔。示例：1,10; 250,500; 10000,20000
- 类型: integerorganization
_num _jobs _range[max] 此人当前雇主活跃的职位发布数量上限。与 organization_num_jobs_range[min] 配合使用可设置职位发布数量区间。示例：50; 500
- 类型: integerorganization
_num _jobs _range[min] 此人当前雇主活跃的职位发布数量下限。与 organization_num_jobs_range[max] 配合使用可设置职位发布数量区间。示例：50; 500
- 类型: integerpage
要检索的 Apollo 数据页码。与 per_page 参数配合使用，可让搜索结果支持翻页并提升端点性能。示例：4
- 类型: integerper
_page 每页应返回的搜索结果数量。限制每页结果数可提升端点性能。使用 page 参数可检索不同页的数据。示例：10
- 类型: array string[]person
_locations[] 人员居住的地点。可跨城市、美国各州和国家搜索。要按此人当前雇主的总部位置查找人员，请使用 organization_locations 参数。示例：california; ireland; chicago
- 类型: array string[]person
_seniorities[] 此人在当前雇主中的职位资历。可据此查找目前处于特定汇报层级的人员，例如总监级或资深 IC 级。人员只需匹配你添加的任一资历即可进入搜索结果。添加更多资历会扩大搜索结果。搜索仅依据当前职位名称返回结果，因此搜索总监级员工只会返回目前持有总监级职位名称的人。如果某人过去是总监、目前是副总裁，则不会出现在搜索结果中。将此参数与 person_titles[] 参数配合使用，可按具体职能和资历层级查找人员。此参数可使用以下选项：owner founder c_suite partner vp head director manager senior entry intern
- 类型: array string[]person
_titles[] 要查找的人员所持有的职位名称。人员只需匹配你添加的任一职位名称即可进入搜索结果。添加更多职位名称会扩大搜索结果。结果也会包含使用相同词语的职位名称，即使并非完全匹配。例如，搜索 marketing manager 可能会返回职位名称为 content marketing manager 的人员。将此参数与 person_seniorities[] 参数配合使用，可按具体职能和资历层级查找人员。示例：sales development representative; marketing manager; research analyst
- 类型: stringq
_keywords 用于筛选结果的词语字符串。
- 类型: array string[]q
_organization _domains _list[] 此人雇主的域名。可以是当前雇主或前雇主。不要包含 www.、@ 符号或类似内容。此参数在单个请求中最多接受 1,000 个域名。示例：apollo.io; microsoft.com
- 类型: array string[]q
_organization _job _titles[] 此人当前雇主在活跃职位发布中列出的职位名称。示例：sales manager; research analyst
- 类型: integerrevenue
_range[max] 此人当前雇主的营收上限。与 revenue_range[min] 配合使用可设置营收区间。数字中不要输入货币符号、逗号或小数点。示例：500000; 1500000
- 类型: integerrevenue
_range[min] 此人当前雇主的营收下限。与 revenue_range[max] 配合使用可设置营收区间。数字中不要输入货币符号、逗号或小数点。示例：500000; 1500000
- 类型: object200
成功响应
- 类型: array string[]people
响应数组
- 类型: integertotal
_entries 响应字段
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/apollo/mixed_people/api_search \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"total_entries": 1,
"people": [
"string"
]
}