跳转到主要内容
POST
https://api.aisa.one/apis/v1
/
apollo
/
mixed_people
/
api_search
People API 搜索
curl --request POST \
  --url https://api.aisa.one/apis/v1/apollo/mixed_people/api_search \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.aisa.one/apis/v1/apollo/mixed_people/api_search"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/apollo/mixed_people/api_search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/apollo/mixed_people/api_search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/apollo/mixed_people/api_search"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/apollo/mixed_people/api_search")
  .header("Authorization", "Bearer <token>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/apollo/mixed_people/api_search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "total_entries": 123,
  "people": [
    "<string>"
  ]
}

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

​
person_titles[]
string[]

您要查找的人员所担任的职位。人员只需匹配您添加的任意 1 个职位，即可被纳入搜索结果。添加更多职位可以扩大搜索结果范围。结果还会包含含有相同词语的职位，即使并非完全匹配。例如，搜索 marketing manager 可能会返回职位为 content marketing manager 的人员。将此参数与 person_seniorities[] 参数结合使用，可根据特定职能和资历级别查找人员。示例：sales development representative；marketing manager；research analyst

​
include_similar_titles
boolean

此参数决定响应中是否返回职位名称与 person_titles[] 参数中定义的职位名称相似的人员。使用 person_titles[] 时，将此参数设置为 false 可仅返回职位名称严格匹配的结果。

​
q_keywords
string

用于筛选结果的词语字符串。

​
person_locations[]
string[]

人员的居住地点。可搜索城市、美国各州和国家/地区。如需根据人员当前雇主的总部所在地查找人员，请使用 organization_locations 参数。示例：california；ireland；chicago

​
person_seniorities[]
string[]

人员在其当前雇主中的职位资历。这使您能够查找目前处于特定汇报层级的人员，例如 Director 级别或高级 IC 级别。人员只需匹配您添加的任意 1 个资历级别即可包含在搜索结果中。添加更多资历级别会扩大搜索结果范围。搜索仅根据人员当前的职位名称返回结果，因此搜索 Director 级别的员工时，只会返回当前拥有 Director 级别职位名称的人员。如果某人以前是 Director，但目前是 VP，则不会包含在搜索结果中。将此参数与 person_titles[] 参数结合使用，可根据特定职能和资历级别查找人员。此参数可使用以下选项：owner founder c_suite partner vp head director manager senior entry intern

​
organization_locations[]
string[]

某人当前雇主的公司总部所在地。您可以搜索城市、美国各州和国家/地区。如果一家公司有多个办公地点，结果仍以总部所在地为准。例如，如果您搜索 chicago，但某公司的总部位于 boston，则该波士顿公司中的员工不会出现在结果中，即使他们符合其他参数。要根据个人所在地查找人员，请使用 person_locations 参数。示例：texas；tokyo；spain

​
q_organization_domains_list[]
string[]

此人雇主的域名。可以是当前雇主或以前雇主的域名。请勿包含 www.、@ [blocked] 符号或类似内容。此参数在单个请求中最多接受 1,000 个域名。示例：apollo.io；microsoft.com

​
contact_email_status[]
string[]

您要查找的人员的电子邮件状态。您可以添加多个状态以扩大搜索范围。可搜索的状态包括：verified unverified likely to engage unavailable

​
organization_ids[]
string[]

要在搜索结果中包含的公司（雇主）的 Apollo ID。Apollo 数据库中的每家公司都被分配了唯一 ID。要查找 ID，请调用 Organization Search 端点并确定 organization_id 的值。示例：5e66b6381e05b4008c8331b8

​
organization_num_employees_ranges[]
string[]

此人当前所在公司的员工人数范围。您可以借此根据雇主的员工人数查找人员。您可以添加多个范围以扩大搜索结果。添加的每个范围都必须是字符串，范围的上下限数字之间只能用逗号分隔。示例：1,10; 250,500; 10000,20000

​
revenue_range[min]
integer

人员当前雇主产生的最低营收。将此参数与 revenue_range[max] 结合使用以设置营收范围。数值中请勿输入货币符号、逗号或小数点。示例：500000；1500000

​
revenue_range[max]
integer

人员当前雇主产生的最高营收。将此参数与 revenue_range[min] 结合使用以设置营收范围。数值中请勿输入货币符号、逗号或小数点。示例：500000；1500000

​
currently_using_all_of_technology_uids[]
string[]

根据目标人员当前雇主使用的所有技术查找人员。Apollo 支持按 1,500 多种技术进行筛选。Apollo 根据多个来源计算技术数据。这些数据会定期更新。下载此 CSV 文件可查看支持的完整技术列表。对于 CSV 文件中列出的技术，请使用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org

​
currently_using_any_of_technology_uids[]
string[]

根据人员当前雇主使用的任意技术查找人员。Apollo 支持按 1,500 多种技术进行筛选。Apollo 根据多个来源计算技术数据。此数据会定期更新。下载此 CSV 文件可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请使用下划线（_）替换空格和句点。示例：salesforce; google_analytics; wordpress_org

​
currently_not_using_any_of_technology_uids[]
string[]

根据目标人员当前雇主使用的任意技术，将其从搜索结果中排除。Apollo 支持按 1,500 多种技术进行筛选。Apollo 根据多个来源计算技术数据。这些数据会定期更新。下载此 CSV 文件可查看支持的完整技术列表。对于 CSV 文件中列出的技术，请使用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org

​
q_organization_job_titles[]
string[]

此人当前雇主发布的有效招聘职位中列出的职位名称。示例：销售经理；研究分析师

​
organization_job_locations[]
string[]

此人的雇主正在积极招聘的职位所在地。示例：atlanta；japan

​
organization_num_jobs_range[min]
integer

此人当前雇主发布的有效职位的最小数量。将此参数与 organization_num_jobs_range[max] 结合使用，以设置职位发布数量范围。示例：50；500

​
organization_num_jobs_range[max]
integer

此人当前雇主的有效招聘职位数量上限。请将此参数与 organization_num_jobs_range[min] 结合使用，以设置招聘职位数量范围。示例：50；500

​
organization_job_posted_at_range[min]
string

此人当前雇主发布职位的最早日期。将此参数与 organization_job_posted_at_range[max] 结合使用，可设置职位发布日期范围。示例：2025-07-25

​
organization_job_posted_at_range[max]
string

人员当前雇主发布职位的最晚日期。请将此参数与 organization_job_posted_at_range[min] 结合使用，以设置职位发布日期范围。示例：2025-09-25

​
page
integer

要检索的 Apollo 数据页码。将此参数与 per_page 参数结合使用，使搜索结果可分页浏览并提高端点性能。示例：4

​
per_page
integer

每页应返回的搜索结果数量。限制每页的结果数量可提高端点性能。使用 page 参数搜索不同的数据页。示例：10

响应

成功响应

​
total_entries
integer

响应字段

​
people
string[]

响应数组