Skip to main content
POST
搜索人员

授权

pubrio-api-key
string
header
必填

一个唯一的 API 令牌,用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 设置 部分创建该令牌。

请求体

application/json
search_term
string

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

示例:

"pubrio"

people_name
string

筛选搜索结果,仅包含指定用戶姓名。

示例:

"king"

people_titles
string[]

与目标人员相关的职位名称。

结果还将包含包含类似术语的职位,即使不完全匹配。例如,搜索 software engineer 也可能返回职位为 senior software engineer 的人员。

示例:
exclude_people_titles
string[]

要排除的职位名称。与 people_titles 相同的按词匹配,因此 ["senior"] 会移除所有包含该词的职位。在 people_titles 之后应用。

示例:
peoples
string<uuid>[]

用于用戶检索操作的一组唯一标识符(people_search_id)列表。

management_levels
enum<string>[]

人员的汇报层级。高管层的 slug 是 c_suite 而非 c_level。未知 slug 不会匹配任何人员。完整列表见 Filters 下的 management level 端点。

可用选项:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp
示例:
departments
string[]

部门字段可用于搜索特定专业领域的人员。

更多信息请参见筛选器标签下的 department 端点。

示例:
exclude_departments
string[]

要排除的部门 slug。与 departments 词表相同。未记录部门的人员会被保留。

示例:
department_functions
string[]

职位职能筛选字段可在搜索人员时指定特定岗位或专业领域。

更多信息请参见筛选器标签下的 department functions 端点。

示例:
exclude_department_functions
string[]

要排除的职能 slug。与 department_functions 词表相同。未记录职能的人员会被保留。

示例:
employees
string[][]

公司员工人数范围。可根据员工总数筛选公司,并可添加多个范围以扩展搜索结果。

更多信息请参见筛选器标签下的 company size 端点。

示例:
people_locations
string[]

用戶地点。更多信息请参见筛选器标签下的 location 端点。

示例:
exclude_people_locations
string[]

人员不得居住的国家(ISO 3166-1 alpha-2)。与 people_locations 配套使用。

示例:
company_locations
string[]

公司总部所在地。更多信息请参见筛选器标签下的 location 端点。

示例:
company_exclude_locations
string[]

要排除的总部所在国家(ISO 3166-1 alpha-2)。与 company_locations 配套使用;两者传入相同代码将不返回任何结果。

示例:
company_linkedin_urls
string[]

LinkedIn 公司主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/company/。

示例:
linkedin_urls
string[]

LinkedIn 用户主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/in/ 或 linkedin.com/pub/。

示例:
companies
string<uuid>[]

用于公司和人员检索操作的一组唯一标识符(domain_search_id)列表。

domains
string[]

用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/,系统会自动转换为 pubrio.com 进行处理。

示例:
company_filters
object

公司级筛选器的包装对象。推荐分组方式 — 视觉上分开哪些键筛选人员(顶层)、哪些筛选公司。接受与顶层公司筛选器相同的键(如 technologies、verticals、vertical_categories、vertical_sub_categories、categories、keywords、founded_dates、employees、revenues、company_locations、company_exclude_locations、company_places、company_exclude_places、companies、domains、company_linkedin_urls、is_enable_similarity_search、similarity_score,以及 filter_conditions)。引擎在处理前会把此对象摊平到顶层 — 同名时顶层键优先。与 Monitor company_filters 结构一致。示例见筛选器概览开发者指南。

示例:
filter_conditions
object[]

/people/search 中的按键 AND/OR 覆盖。省略时默认为 OR。完整的键重映射参考请见“人员 + 公司筛选器”开发者指南。

启用后,上述支持相似度搜索的筛选器可直接填写自由文本以检索特定ID。

similarity_score
number<float>

需与 is_enable_similarity_search 配合使用。该数值用于分析特定 slug(如行业、技术)与用户输入的相似程度,数值越高,匹配越严格。

示例:

0.7

per_page
integer
默认值:25

每页记录数。默认 25,在大多数套餐下这也是上限 —— 该限制即订阅中的 max_search_per_page,可通过 Profile 获取。超出会返回 HTTP 416 及错误码 41676(公司与人物搜索为 41613),而不是自动截断结果。

必填范围: x <= 25
示例:

25

page
integer
默认值:1

页码,从 1 开始。上限为订阅中的 max_search_page(公司搜索为 max_company_search_page),可通过 Profile 获取。超出会返回 HTTP 416。

示例:

1

query
string

自然语言搜索。提供后,Pubrio 会将其解析为下方的人员和公司筛选条件(职位、职级、部门、地区、行业、公司规模等)。您同时传入的显式筛选条件将优先于解析结果。留空则仅按结构化筛选条件搜索。

示例:

"decision makers in marketing"

is_include_similar_people_titles
boolean
默认值:true

默认启用。people_titles 还会匹配每个职位名称的相近变体(例如,software engineer 会匹配 senior software engineer)。metadata.filters.people_titles 返回实际搜索的完整列表。

people_title_similarity_score
number<float>

与 is_include_similar_people_titles 配合使用。控制职位名称需要多接近才算匹配,数值越高,匹配越严格。

示例:

0.9

technologies
integer[]

tag_id 列表,用于搜索公司所用的特定技术。要获取ID,请调用筛选器标签下的 technology 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["Shopify"]。

技术列表中已有的产品名称会匹配该产品及其自有产品("Salesforce" 也会匹配 Salesforce Desk 和 Salesforce Service Cloud),不会匹配相似的其他产品;其他文本按相似度匹配。

categories
integer[]

category_id 列表,用于搜索公司所用的特定技术类别。要获取ID,请调用筛选器标签下的 category 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["CDN"]。

verticals
integer[]

vertical_id 列表,用于搜索特定垂直行业或领域的公司。要获取ID,请调用筛选器标签下的 vertical 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["AI"]。

vertical_categories
integer[]

vertical_category_id 列表,用于搜索特定垂直行业类别的公司。要获取ID,请调用筛选器标签下的 vertical category 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["Information Technology"]。

vertical_sub_categories
integer[]

vertical_sub_category_id 列表,用于搜索特定垂直行业子类别的公司。要获取ID,请调用筛选器标签下的 vertical sub category 端点。

该筛选器支持 is_enable_similarity_search,启用后可输入任意自由文本,例如 ["Software"]。

keywords
string[]

用于按相关性、专业或描述对公司进行关键词筛选的列表。

示例:
founded_dates
integer[]

公司成立年份范围。最大值为当前年份。

示例:
revenues
integer[]

公司收入的最小值和最大值范围。

示例:
company_places
string[]

用于筛选结果的地点名称(城市或地区)。接受本地化或英文地点名称。

示例:
company_exclude_places
string[]

要从结果中排除的地点名称(城市或地区)。接受本地化或英文地点名称。

示例:

响应

包含相关详细信息的成功响应。

metadata
object

请求上下文:回显的 filters 和 parameters、可选的 profile 额度块,以及 ignored_fields(端点丢弃的请求键)。

data
object | null

响应信息取决于具体接口。

最后修改于 2025年6月9日