LinkedIn Profiles API

LinkedIn Profiles

主要特性

• 公开个人主页 URL 输入一次处理一个或多个 LinkedIn /in/{slug} URL，不会混入公司主页、帖子或职位链接。
• 当前职业信息在同一条标准化记录中返回公开姓名、简介、头像、地区、职位和当前公司。
• 结构化职业经历将工作经历、教育和技能保留为独立区块，便于筛选、索引和资料补全。
• 公开受众指标将可用的粉丝数和连接数作为独立指标，与职业资料字段一起返回。

参数

如何使用

从已知个人主页开始，等待资料处理完成，再逐页读取职业记录。

1. 只保留路径符合 /in/{slug} 的公开 LinkedIn 链接。
2. 把这些链接放入 urls，提交至 /v1/linkedin/profiles，并保留 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/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/in/satyanadella"]}'

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

最佳使用场景

• 联系人和候选人资料补全： 根据已知个人主页 URL，为现有记录补充当前职位、公司、地区、经历、教育和技能。
• 职业经历研究： 利用结构化工作经历和教育信息，研究职位变化与职业背景。
• 公开资料监测： 比较不同时期保存的个人资料，识别职位、当前公司、技能或公开受众数量的变化。

使用建议

• 提交前统一并去重 /in/ URL，避免同一主页的不同链接写法产生重复记录。
• 构建人物唯一键时优先使用返回的 id；记录没有 id 时再使用 url。
• 将工作经历、教育、技能和受众数量视为可选字段，不要把公开主页缺少某个区块当成异常。
• 比较职位或受众变化时，为每个保存版本保留 collected_at。

相关 API