搜索相似人员 - Pubrio Documentation

curl --request POST \ --url https://api.pubrio.com/people/search/similar \ --header 'Content-Type: application/json' \ --header 'pubrio-api-key: <api-key>' \ --data ' { "search_term": "pubrio", "people_name": "king", "people_titles": [ "sales manager", "marketing manager" ], "peoples": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "management_levels": [ "head" ], "departments": [ "master_human_resources" ], "department_functions": [ "human_resources" ], "employees": [ [ 1, 10 ], [ 11, 20 ], [ 10001 ] ], "people_locations": [ "US", "SG", "CN" ], "company_locations": [ "US", "SG", "CN" ], "company_linkedin_urls": [ "https://www.linkedin.com/company/pubrio" ], "linkedin_urls": [ "http://www.linkedin.com/in/king-lai-605382b7" ], "companies": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "domains": [ "pubrio.com" ], "company_filters": { "company_locations": [ "US" ], "technologies": [ 37, 152 ], "founded_dates": [ 2015, 2023 ], "filter_conditions": [ { "key": "technologies", "operator": "and" } ] }, "is_enable_similarity_search": true, "similarity_score": 0.7, "per_page": 25, "page": 1, "profile_id": 123 } '

{ "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 199616132, "total_pages": 100 }, "peoples": [ { "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946", "name": "Doug McMillon", "first_name": "Doug", "last_name": "McMillon", "title": "President & CEO", "seniority": "c_suite", "functions": null, "headline": "President & CEO at Walmart Inc.", "departments": [ "c_suite" ], "subdepartments": [ "executive" ], "keywords": null, "employment_history": [ { "title": "President & CEO", "current": true, "end_date": null, "start_date": "2014-02-01", "company_name": "Walmart" }, { "title": "President & CEO, Walmart International", "current": false, "end_date": "2014-01-01", "start_date": "2009-02-01", "company_name": "Walmart" }, { "title": "President & CEO", "current": false, "end_date": "2009-01-01", "start_date": "2005-08-01", "company_name": "Sam's Club" } ], "location": "United States", "state": "Arkansas", "city": "Bentonville", "contacts": null, "emails": null, "phones": null, "facebook_url": null, "github_url": null, "twitter_url": null, "linkedin_url": "http://www.linkedin.com/in/dougmcmillon", "saved_lists": null, "company": { "company_name": "Walmart", "company_url": "http://walmart.com", "domain_id": 26067151, "domain_ids": [ 757023267, 368242703, 26067151 ], "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6", "founded_year": 1962, "location": "United States", "phones": null, "company_size_printed": "466,000", "company_size": 466000, "industry": "Retail", "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg", "linkedin_url": "http://www.linkedin.com/company/walmart", "facebook_url": "http://facebook.com/walmart", "twitter_url": "https://twitter.com/walmart", "crunchbase_url": null, "instagram_url": "http://instagram.com/walmart", "youtube_url": "http://youtube.com/user/walmart" }, "similarity_score": 0.92 }, "..." ] } }

授权

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 的人员。

示例:

["sales manager", "marketing manager"]

peoples

string<uuid>[]

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

management_levels

string[]

人员在当前组织中所处的管理层级。可用于定位目前处于特定汇报层级（如C级或高级）的人员。

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

示例:

["head"]

departments

string[]

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

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

示例:

["master_human_resources"]

department_functions

string[]

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

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

示例:

["human_resources"]

employees

string[][]

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

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

示例:

[[1, 10], [11, 20], [10001]]

people_locations

string[]

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

示例:

["US", "SG", "CN"]

company_locations

string[]

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

示例:

["US", "SG", "CN"]

company_linkedin_urls

string[]

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

示例:

["https://www.linkedin.com/company/pubrio"]

linkedin_urls

string[]

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

示例:

[
  "http://www.linkedin.com/in/king-lai-605382b7"
]

companies

string<uuid>[]

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

domains

string[]

用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/，系统会自动转换为 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 结构一致。示例见筛选器概览开发者指南。

示例:

{
  "company_locations": ["US"],
  "technologies": [37, 152],
  "founded_dates": [2015, 2023],
  "filter_conditions": [
    { "key": "technologies", "operator": "and" }
  ]
}

is_enable_similarity_search

boolean

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

similarity_score

number<float>

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

示例:

0.7

per_page

integer

每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。

示例:

25

page

integer

要检索的数据页码。

示例:

1

profile_id

integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

响应

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

data

object

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

API 文档

端点

授权

请求体

响应