LinkedIn 公开数据 API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。
可用的 LinkedIn API
个人主页使用 Profiles，公司主页使用 Companies，已知公开内容使用 Posts，公开职位详情 URL 使用 Jobs。
可以获取哪些 LinkedIn 数据？
SocQ 将已知公开 LinkedIn URL 转换为标准化记录，可用于数据补全、招聘研究、内容分析和数据产品。
职业个人资料
通过 /in/ URL 获取公开身份、职位、地区、可见受众、经历、教育和技能。
公司主页
通过 /company/ URL 获取简介、网站、Logo、可见计数、行业、公司规模、地点和专长。
帖子内容
将受支持的帖子 URL 解析为正文、作者、媒体、发布时间、帖子类型、标签和可见互动。
职位详情
获取岗位、公司、描述、地点、职级、雇佣类型、行业、申请信息和可用薪资字段。
SocQ 与 LinkedIn APIs 对比
SocQ 用于解析受支持的公开 LinkedIn URL；LinkedIn 官方 API 面向已授权的会员、组织和合作伙伴集成。
| 能力 | SocQ | LinkedIn APIs |
|---|---|---|
| 主要用途 | 从已知 URL 采集公开个人资料、公司、帖子和职位记录 | 构建已授权的会员、组织、营销或合作伙伴集成 |
| 客户 OAuth | 使用 SocQ API key，无需客户 LinkedIn OAuth | 需要 OAuth 2.0、产品权限，且通常需要 LinkedIn 审批 |
| 起始输入 | 受支持的公开 LinkedIn URL | 已授权账号上下文、LinkedIn URN 或资源 ID |
| 创建或管理内容 | 不支持 | 具备所需权限的会员和组织可以使用 |
| 返回格式 | 标准化 SocQ 记录 | LinkedIn REST 原生对象 |
LinkedIn API 如何工作
Profiles、Companies、Posts 和 Jobs 使用相同的异步任务和结果分页流程。
1. 提交公开 URL
将 urls 数组提交到与 LinkedIn 路径匹配的 API，并保存返回的 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到任务处理完成。
3. 获取结果
读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
使用 SocQ API key 鉴权并提交一个或多个公开 /in/ URL。Companies、Posts 和 Jobs 使用相同的任务流程。
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常见 LinkedIn API 使用场景
销售线索与账号补充
为工作流中已有的个人或公司 URL 补充公开职业与企业信息。
招聘研究
使用一致的岗位、公司、地点、雇佣类型和薪资字段比较选定个人资料与职位。
内容与营销活动分析
将选定帖子 URL 解析为内容、作者、媒体、发布时间和采集时互动。
研究与数据产品
在数据仓库、搜索索引、分类器、审核队列和看板中使用一致的 LinkedIn 记录。
限制与公开数据政策
SocQ 返回任务运行时公开可访问的 LinkedIn 数据。
- 每个 API 都从已知公开 URL 开始，不提供 LinkedIn 个人、公司、帖子或职位搜索。
- 可见计数和变化的页面字段是以 collected_at 为锚点的快照，不是实时数据流。
- 字段未公开或采集时不可见时，选填字段可能为 null 或空值。
- 这些 API 只读取公开数据，不连接、发布或管理 LinkedIn 账号。
LinkedIn API 常见问题
LinkedIn API 是什么？
LinkedIn API 是 SocQ 提供的一组 API，用于将已知的公开个人主页、公司主页、帖子和职位 URL 转换为对应资源的标准化记录。
应该选择哪个 LinkedIn API？
/in/ URL 使用 Profiles，/company/ URL 使用 Companies，受支持的帖子路径使用 Posts，/jobs/view/ URL 使用 Jobs。
可以通过这些 API 搜索 LinkedIn 吗？
不可以。每个 API 都需要已知公开 URL，并解析对应的个人、公司、帖子或职位资源。
任务处理流程是什么？
提交 POST 请求，轮询 /v1/tasks/{task_id}，然后读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
结果是完整或实时的吗？
结果是公开可见字段的采集时快照，不提供完整历史或持续实时覆盖。
LinkedIn 数据采集如何计费？
每条返回结果中，Profiles 消耗 2.5 积分，Companies 消耗 2 积分，Posts 消耗 1 积分，Jobs 消耗 0.8 积分。