linkedin/
search-people

通过人员搜索 URL 发现候选 LinkedIn 公开主页,返回标准化身份、描述、图片、地点、网站、账号信号和可用指标。

LinkedIn Search People API

搜索 URL 输入
按姓名发现
规范化账号
每条结果 1 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

LinkedIn Search People

LinkedIn Search People 把每个已提交人员搜索 URL 中的 keywords 值转换为按姓名的 provider 查询。结果是供身份审阅的候选公开主页,并不能证明主页属于目标人物;该端点也不会重放 URL 中编码的公司、学校、地点、行业或联系人层级筛选。

LinkedIn Search People API 主要特性

  • 人员搜索 URL 输入提交一个或多个路径以 /search/results/people 开头的 LinkedIn 公开 URL。
  • 明确的姓名映射解码 keywords,把按空白分隔的首个 token 映射为 first_name,其余 token 合并为 last_name。
  • 候选主页发现返回可支持人工匹配或后续主页采集的公开主页 URL 和身份上下文。
  • 规范化账号记录以稳定字段返回身份、描述、图片、网站、账号状态、地点、指标和采集时间。
  • 保留来源空值无法获得的字段保持为空,不推断私密联系方式、工作经历、教育、技能或身份确定性。

LinkedIn Search People API 参数

参数必填描述
urls必填必填的公开 LinkedIn http 或 https URL 列表。每个域名必须是 linkedin.com 或其子域名,路径必须以 /search/results/people 开头。为了获得可靠的按姓名行为,请包含 keywords。

如何使用 LinkedIn Search People API

准备按姓名的人员搜索 URL,提交异步任务,然后审阅每个返回候选项。

  1. 创建 LinkedIn 人员搜索 URL,并在 keywords 查询值中填写人物姓名。
  2. 把 urls 提交到 /v1/linkedin/search-people,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务进入终止状态。
  4. 成功后处理 data.results.items;has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin/search-people" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/search/results/people/?keywords=Aakash%20Gupta"]}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;has_more 为 true 时继续使用 next_cursor

LinkedIn Search People API 最佳使用场景

  • 主页 URL 发现: 在使用主页专用采集端点前,查找候选 LinkedIn 公开主页 URL。
  • 人工身份解析: 比较候选项的姓名、描述、地点、图片和 URL,同时保留不确定性。
  • 公开目录输入: 把标准化候选账号送入审核队列,不承诺联系方式补充或私密属性。
  • 姓名变体研究: 分别运行谨慎选择的姓名拼写,并比较各次采集生成的公开候选项。

LinkedIn Search People API 使用建议

  • 始终提供有意义的 keywords 查询值;不含该值的 URL 虽能通过校验,但会生成空姓名行,其 provider 行为不可靠。
  • 记住 Mary Jane Smith 会映射为 first_name Mary 和 last_name Jane Smith,而不是通用关键词表达式。
  • 不要假设 URL 中的地点、公司、学校、行业或联系人层级筛选会生效;当前 adapter 会丢弃它们。
  • 确认人物身份前,应结合公开主页 URL 和多个相互印证的属性。
  • 多个已提交搜索重叠时,使用稳定主页 URL 对重复候选项去重。
  • 该端点没有调用方可控的结果上限,因此计费和审核工作流应围绕实际存储结果设计。

除了 LinkedIn Search People API,需要其他类型的 LinkedIn 公开数据时,可以使用以下 API。

  • LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
  • LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
  • LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。
  • LinkedIn Jobs API — 标准化公开职位名称、公司、描述、地点、资历、雇佣信息、申请链接和可用薪资字段。
  • LinkedIn Profile Posts API — 通过 LinkedIn 个人主页 URL 发现关联的公开帖子,返回作者、媒体、标签、时间和可见互动信息。
  • LinkedIn Search Posts API — 通过关键词和可选日期字符串发现 Google 索引的 LinkedIn 公开帖子,返回标准化正文、作者、媒体、标签、时间和可见互动。

探索其他平台

还可以将 LinkedIn 数据与其他已支持社交平台的公开数据结合使用。

LinkedIn Search People API — 常见问题

LinkedIn Search People API 是一个用于通过人员搜索 URL 发现候选 LinkedIn 公开主页的 API。它把 URL 的 keywords 值映射为按姓名的 provider 查询,并返回供审阅的标准化公开账号记录。

每个值必须是 linkedin.com 或 LinkedIn 子域名上的完整 http 或 https URL,且路径以 /search/results/people 开头。

解码后按空白拆分。首个 token 作为 first_name,所有剩余 token 合并为 last_name。

不保留。当前 adapter 不会映射已编码的地点、公司、学校、行业、联系人层级或其它搜索筛选。

不可以。该端点不暴露调用方可控的结果上限,并为每个已提交 URL 存储发现来源产生的记录。

不能。姓名并不唯一。应把每条结果视为候选项,并核对公开 URL、姓名、描述、地点和其它可见属性。

每条成功存储的主页结果消耗 1 个 SocQ 积分,不收取基础费用。规划估算按每个 URL 100 条结果计算,空结果集不收取结果费用;由于没有结果上限,实际用量可能不同。