LinkedIn Search People
LinkedIn Search People 把每个已提交人员搜索 URL 中的 keywords 值转换为按姓名的 provider 查询。结果是供身份审阅的候选公开主页，并不能证明主页属于目标人物；该端点也不会重放 URL 中编码的公司、学校、地点、行业或联系人层级筛选。
主要特性
- 人员搜索 URL 输入提交一个或多个路径以 /search/results/people 开头的 LinkedIn 公开 URL。
- 明确的姓名映射解码 keywords，把按空白分隔的首个 token 映射为 first_name，其余 token 合并为 last_name。
- 候选主页发现返回可支持人工匹配或后续主页采集的公开主页 URL 和身份上下文。
- 规范化账号记录以稳定字段返回身份、描述、图片、网站、账号状态、地点、指标和采集时间。
- 保留来源空值无法获得的字段保持为空，不推断私密联系方式、工作经历、教育、技能或身份确定性。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 LinkedIn http 或 https URL 列表。每个域名必须是 linkedin.com 或其子域名，路径必须以 /search/results/people 开头。为了获得可靠的按姓名行为，请包含 keywords。 |
如何使用
准备按姓名的人员搜索 URL，提交异步任务，然后审阅每个返回候选项。
- 创建 LinkedIn 人员搜索 URL，并在 keywords 查询值中填写人物姓名。
- 把 urls 提交到 /v1/linkedin/search-people，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务进入终止状态。
- 成功后处理 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最佳使用场景
- 主页 URL 发现： 在使用主页专用采集端点前，查找候选 LinkedIn 公开主页 URL。
- 人工身份解析： 比较候选项的姓名、描述、地点、图片和 URL，同时保留不确定性。
- 公开目录输入： 把标准化候选账号送入审核队列，不承诺联系方式补充或私密属性。
- 姓名变体研究： 分别运行谨慎选择的姓名拼写，并比较各次采集生成的公开候选项。
使用建议
- 始终提供有意义的 keywords 查询值；不含该值的 URL 虽能通过校验，但会生成空姓名行，其 provider 行为不可靠。
- 记住 Mary Jane Smith 会映射为 first_name Mary 和 last_name Jane Smith，而不是通用关键词表达式。
- 不要假设 URL 中的地点、公司、学校、行业或联系人层级筛选会生效；当前 adapter 会丢弃它们。
- 确认人物身份前，应结合公开主页 URL 和多个相互印证的属性。
- 多个已提交搜索重叠时，使用稳定主页 URL 对重复候选项去重。
- 该端点没有调用方可控的结果上限，因此计费和审核工作流应围绕实际存储结果设计。
相关 API
需要其他类型的 LinkedIn 公开数据时，可以使用以下 API。
- LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
- LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
- LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。
- LinkedIn Jobs API — 标准化公开职位名称、公司、描述、地点、资历、雇佣信息、申请链接和可用薪资字段。
- LinkedIn Company Jobs API — 通过准备好的 LinkedIn /jobs/ URL 发现公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Company Posts API — 通过 LinkedIn 公司主页 URL 发现公开帖子，返回正文、作者信息、媒体、话题标签、时间和可见互动指标。
- LinkedIn Post Comments API — 采集已知 LinkedIn 帖子公开提供的评论，返回正文、作者信息、时间、关系标识以及可见点赞数和回复数。
- LinkedIn Profile Posts API — 通过 LinkedIn 个人主页 URL 发现关联的公开帖子，返回作者、媒体、标签、时间和可见互动信息。
- LinkedIn Search Jobs API — 通过必填地点和可选筛选搜索 LinkedIn 公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Search Posts API — 通过关键词和可选日期字符串发现 Google 索引的 LinkedIn 公开帖子，返回标准化正文、作者、媒体、标签、时间和可见互动。