按职位名称搜索人员，可选用公司官网链接和居住地缩小范围。每次最多查看一条资料预览，不是完整档案，也不会显示邮箱或电话。
Apollo
按职位名称搜索人员，可选用公司官网链接和居住地缩小范围。每次最多查看一条资料预览，不是完整档案，也不会显示邮箱或电话。
预览可能包含 Apollo 人员 ID、名、部分遮挡的姓氏、职位、当前雇主名称及 Apollo 的数据刷新时间。还可能标记是否有联系方式、地点或公司资料；这些标记不包含邮箱、电话、地点或财务数据的实际值。
查找符合 [职位名称] 的 Apollo 人员。可选用 [公司官网链接] 和 [对方居住的城市或国家] 缩小范围。最多查看一条预览，整理实际返回的姓名、职位和公司。不含邮箱或电话；公司匹配可能来自过去任职。
搜索返回预览记录，不提供完整档案或实际联系方式。职位可能匹配相关名称，雇主域名条件也可能匹配当前或过去的任职。结果和刷新时间不构成身份、现职或采购决策权的独立核验。请求页可能不完整或为空；失败或没有记录不证明没有匹配人员。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
搜索设置queryParams | object | 选填 | 可选人员预览搜索设置，可填写职位、人员或雇主条件，并选择页码和每页请求条数。此搜索不返回实际邮箱地址或电话号码。 |
页码queryParams.page | integer | 选填 | 可选整数，范围 1–500。与每页请求条数一起指定当前请求页，不会自动获取后续页。
|
每页请求的预览条数queryParams.per_page | integer | 选填 | 可选整数，范围 1–100。指定所选页最多请求的预览条数，实际可能较少或为空。
|
关键词筛选queryParams.q_keywords | string | 选填 | 可选搜索词，用于筛选人员搜索结果。按角色搜索时使用职位名称列表；此字段不是专门的姓名查询。 |
职位名称列表queryParams.person_titles[] | array | 选填 | 可选职位名称列表，可匹配任一填写的职位，也可能匹配相关名称。相似职位选项控制更广的名称匹配；匹配结果不构成现职核验。 |
单个职位名称queryParams.person_titles[][] | string | — | 列表中的一个非空职位名称字符串。本例使用用户实际提供的职位名称。
|
雇主组织 ID 列表queryParams.organization_ids[] | array | 选填 | 可选已知 Apollo 组织 ID 列表，用于缩小人员搜索范围。填写已有 ID，选择此条件不会另行查找组织 ID。 |
单个组织 IDqueryParams.organization_ids[][] | string | — | 一个非空 Apollo 组织 ID 字符串，表示组织，不是人员 ID 或域名。
|
人员居住地列表queryParams.person_locations[] | array | 选填 | 可选人员居住城市、美国州或国家列表，与雇主总部和招聘地点不同；预览中的地点存在标记不包含实际地点。 |
单个人员居住地queryParams.person_locations[][] | string | — | 一个非空居住地字符串，可填写城市、美国州或国家。
|
雇主收入上限queryParams.revenue_range[max] | integer | 选填 | 可选非负整数，用于按雇主收入上限筛选。填写完整数字，不带逗号、币种符号或小数。此条件未指定币种，也不返回收入实际值。
|
雇主收入下限queryParams.revenue_range[min] | integer | 选填 | 可选非负整数，用于按雇主收入下限筛选。填写完整数字，不带逗号、币种符号或小数。此条件未指定币种，也不返回收入实际值。
|
现职职级列表queryParams.person_seniorities[] | array | 选填 | 可选职级标签：owner（所有者）、founder（创始人）、c_suite（高管）、partner（合伙人）、vp（副总裁）、head（负责人）、director（总监）、manager（经理）、senior（资深）、entry（初级）、intern（实习）。多个标签扩大匹配范围，针对当前职位，不表示历史职级或已核实的采购决策权。 |
单个职级标签queryParams.person_seniorities[][] | string | — | 一个非空职级标签字符串，按文中标签填写。
|
邮箱状态筛选列表queryParams.contact_email_status[] | array | 选填 | 可选来源邮箱状态标签：verified（已验证）、unverified（未验证）、likely to engage（可能互动）、unavailable（不可用）。多个标签扩大匹配范围。状态筛选不返回实际邮箱地址，也不证明可送达。 |
单个邮箱状态标签queryParams.contact_email_status[][] | string | — | 一个非空来源邮箱状态字符串，应与实际邮箱地址或送达测试结果区分。
|
包含相似职位名称queryParams.include_similar_titles | boolean | 选填 | 可选布尔值，控制是否匹配职位列表中的相似名称。设为 false 可请求较严格的名称匹配，但不构成职位、身份或采购决策权的独立核验。 |
当前雇主总部地点列表queryParams.organization_locations[] | array | 选填 | 可选当前雇主总部地点列表，不表示分支机构、人员居住地或招聘地点，也不让预览返回总部实际地址。 |
单个总部地点queryParams.organization_locations[][] | string | — | 一个非空当前雇主总部地点字符串。
|
雇主招聘职位名称列表queryParams.q_organization_job_titles[] | array | 选填 | 可选当前雇主的活跃招聘职位名称列表。结果仍是人员预览，不是招聘职位记录或经独立核实的空缺。 |
单个招聘职位名称queryParams.q_organization_job_titles[][] | string | — | 一个非空职位名称字符串，用于按雇主招聘记录筛选。
|
雇主招聘地点列表queryParams.organization_job_locations[] | array | 选填 | 可选雇主活跃招聘记录中的地点列表，区别于人员居住地和雇主总部；此搜索不返回招聘职位清单。 |
单个招聘地点queryParams.organization_job_locations[][] | string | — | 一个非空雇主招聘地点字符串。
|
当前或过去雇主域名列表queryParams.q_organization_domains_list[] | array | 选填 | 可选雇主域名列表，不带 www. 或 @。Apollo 文档说明每次最多填写 1,000 个。域名可能匹配当前或过去的任职，预览返回的当前雇主名称可能与输入域名不同。 |
单个雇主域名queryParams.q_organization_domains_list[][] | string | — | 一个非空雇主域名字符串，不带 www. 或 @；不要据此认定它是人员的当前雇主。
|
雇主招聘条数上限queryParams.organization_num_jobs_range[max] | integer | 选填 | 可选非负整数，按当前雇主活跃招聘记录条数的上限筛选人员。不返回这些职位，也不独立核实目前空缺。
|
雇主招聘条数下限queryParams.organization_num_jobs_range[min] | integer | 选填 | 可选非负整数，按当前雇主活跃招聘记录条数的下限筛选人员。不返回这些职位，也不独立核实目前空缺。
|
当前雇主员工数量区间queryParams.organization_num_employees_ranges[] | array | 选填 | 可选雇主员工数量区间列表，以“下限,上限”字符串填写，例如 1,10 或 250,500。多个区间扩大匹配范围，预览不因此返回员工数量实际值。 |
单个员工数量区间queryParams.organization_num_employees_ranges[][] | string | — | 一个非空“下限,上限”区间字符串，例如 250,500。
|
雇主招聘发布时间上限queryParams.organization_job_posted_at_range[max] | string | 选填 | 可选雇主招聘记录发布时间上限，按 YYYY-MM-DD 填写。通过雇主招聘背景筛选人员，不是人员数据刷新日期，也不证明职位仍在招聘。 |
雇主招聘发布时间下限queryParams.organization_job_posted_at_range[min] | string | 选填 | 可选雇主招聘记录发布时间下限，按 YYYY-MM-DD 填写。通过雇主招聘背景筛选人员，不是人员数据刷新日期，也不证明职位仍在招聘。 |
雇主使用全部所列技术queryParams.currently_using_all_of_technology_uids[] | array | 选填 | 可选技术标识列表，要求 Apollo 记录中的当前雇主匹配全部所填技术。标识以下划线（_）替代空格或句点。匹配不独立核实当前使用情况，也不返回完整技术清单。 |
单个必匹配技术标识queryParams.currently_using_all_of_technology_uids[][] | string | — | “匹配全部”条件中的一个非空技术标识。
|
雇主使用任一所列技术queryParams.currently_using_any_of_technology_uids[] | array | 选填 | 可选技术标识列表，匹配 Apollo 记录中使用任一所填技术的当前雇主。标识以下划线（_）替代空格或句点。匹配不独立核实当前使用情况，也不返回完整技术清单。 |
单个备选技术标识queryParams.currently_using_any_of_technology_uids[][] | string | — | “匹配任一”条件中的一个非空技术标识。
|
排除使用所列技术的雇主queryParams.currently_not_using_any_of_technology_uids[] | array | 选填 | 可选技术标识列表，排除当前雇主在 Apollo 记录中使用任一所填技术的人员。标识以下划线（_）替代空格或句点。排除结果不独立证明该雇主没有使用某技术。 |
单个排除技术标识queryParams.currently_not_using_any_of_technology_uids[][] | string | — | 一个非空技术标识，当前雇主被记录为使用它时触发排除。
|
{
"type": "object",
"required": [],
"properties": {
"queryParams": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"page": {
"type": "integer",
"maximum": 500,
"description": "可选整数，范围 1–500。与每页请求条数一起指定当前请求页，不会自动获取后续页。",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 100,
"description": "可选整数，范围 1–100。指定所选页最多请求的预览条数，实际可能较少或为空。",
"exclusiveMinimum": 0
},
"q_keywords": {
"type": "string",
"description": "可选搜索词，用于筛选人员搜索结果。按角色搜索时使用职位名称列表；此字段不是专门的姓名查询。"
},
"person_titles[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选职位名称列表，可匹配任一填写的职位，也可能匹配相关名称。相似职位选项控制更广的名称匹配；匹配结果不构成现职核验。"
},
"organization_ids[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选已知 Apollo 组织 ID 列表，用于缩小人员搜索范围。填写已有 ID，选择此条件不会另行查找组织 ID。"
},
"person_locations[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选人员居住城市、美国州或国家列表，与雇主总部和招聘地点不同；预览中的地点存在标记不包含实际地点。"
},
"revenue_range[max]": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"revenue_range[min]": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"person_seniorities[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选职级标签：owner（所有者）、founder（创始人）、c_suite（高管）、partner（合伙人）、vp（副总裁）、head（负责人）、director（总监）、manager（经理）、senior（资深）、entry（初级）、intern（实习）。多个标签扩大匹配范围，针对当前职位，不表示历史职级或已核实的采购决策权。"
},
"contact_email_status[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选来源邮箱状态标签：verified（已验证）、unverified（未验证）、likely to engage（可能互动）、unavailable（不可用）。多个标签扩大匹配范围。状态筛选不返回实际邮箱地址，也不证明可送达。"
},
"include_similar_titles": {
"type": "boolean",
"description": "可选布尔值，控制是否匹配职位列表中的相似名称。设为 false 可请求较严格的名称匹配，但不构成职位、身份或采购决策权的独立核验。"
},
"organization_locations[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选当前雇主总部地点列表，不表示分支机构、人员居住地或招聘地点，也不让预览返回总部实际地址。"
},
"q_organization_job_titles[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选当前雇主的活跃招聘职位名称列表。结果仍是人员预览，不是招聘职位记录或经独立核实的空缺。"
},
"organization_job_locations[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选雇主活跃招聘记录中的地点列表，区别于人员居住地和雇主总部；此搜索不返回招聘职位清单。"
},
"q_organization_domains_list[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选雇主域名列表，不带 www. 或 @。Apollo 文档说明每次最多填写 1,000 个。域名可能匹配当前或过去的任职，预览返回的当前雇主名称可能与输入域名不同。"
},
"organization_num_jobs_range[max]": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"organization_num_jobs_range[min]": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"organization_num_employees_ranges[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "可选雇主员工数量区间列表，以“下限,上限”字符串填写，例如 1,10 或 250,500。多个区间扩大匹配范围，预览不因此返回员工数量实际值。"
},
"organization_job_posted_at_range[max]": {
"type": "string",
"description": "可选雇主招聘记录发布时间上限，按 YYYY-MM-DD 填写。通过雇主招聘背景筛选人员，不是人员数据刷新日期，也不证明职位仍在招聘。"
},
"organization_job_posted_at_range[min]": {
"type": "string",
"description": "可选雇主招聘记录发布时间下限，按 YYYY-MM-DD 填写。通过雇主招聘背景筛选人员，不是人员数据刷新日期，也不证明职位仍在招聘。"
},
"currently_using_all_of_technology_uids[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"currently_using_any_of_technology_uids[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"currently_not_using_any_of_technology_uids[]": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
雇主收入筛选未指定币种，不应默认按美元理解。招聘日期条件针对雇主的职位发布记录，人员预览中的刷新时间则表示 Apollo 更新该人员数据的时间。
查找符合 [职位名称] 的人员。Apollo 也可能返回职位相近的人。
查找符合 [职位名称] 的 Apollo 人员。可选用 [公司官网链接] 和 [对方居住的城市或国家] 缩小范围。最多查看一条预览，整理实际返回的姓名、职位和公司。不含邮箱或电话；公司匹配可能来自过去任职。
用 [公司官网链接] 缩小公司范围，用 [人员居住的城市或国家] 筛选居住地。公司匹配可能来自现在或过去任职；居住地不是公司地址。
不会。这里显示的是有限的资料预览，不会提供邮箱地址或电话号码；即使 Apollo 显示可能有这些资料，也不代表可以联系对方。
不能。Apollo 匹配的公司可能是对方现在或过去任职的公司；页面显示的公司资料不能单独证明目前仍在职。
不是。这个地点指人员居住地，与公司总部或公司招聘地点不同。