LinkedIn Jobs
一则公开 LinkedIn 职位通过岗位、雇主、描述、地点、职级、雇佣类型、行业、申请方式和已披露薪酬说明具体招聘需求。这些信息可用于跟踪职位、比较岗位条件、开展招聘研究，并建立结构化职位目录。
主要特性
- 职位详情 URL 输入一次处理一个或多个公开 LinkedIn /jobs/view/{slug} 页面，同时拒绝搜索结果和职位集合页 URL。
- 岗位与雇主信息关联在同一条记录中返回职位名称、完整描述、详情页 URL 和标准化招聘公司信息。
- 结构化雇佣属性将地点、职级、雇佣类型和行业作为独立字段返回，不必再从职位描述中提取。
- 申请与薪资字段将 apply_link、Easy Apply 标识、薪资、发布时间和采集时间作为独立职位字段返回。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 LinkedIn 职位详情 URL 列表。每个 URL 必须使用 linkedin.com 或 LinkedIn 子域名下的 /jobs/view/{slug} 路径。 |
如何使用
发送已知职位详情链接，等待招聘记录准备完成，再取回所有结果页面。
- 将输入列表限制为公开 /jobs/view/{slug} 职位详情链接。
- 把链接放入 urls，提交到 /v1/linkedin/jobs，并保存 task_id。
- 查询 /v1/tasks/{task_id}，直到职位任务进入成功或失败状态。
- 成功后处理 data.results.items；has_more 指示还有页面时，继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin/jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/view/software-engineer-at-microsoft-4429527118"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 职位跟踪： 利用岗位、雇主、地点、发布时间和来源 URL，维护已知职位的结构化清单。
- 岗位与要求比较： 对比选定职位的描述、职级、雇佣类型、行业、地点和可用薪资。
- 招聘市场研究： 按雇主、地点、行业或雇佣类型整理选定职位，研究公开招聘需求的分布。
- 申请路径管理： 利用 apply_link 和 Easy Apply 标识，将保存的职位导向对应的可用申请方式。
使用建议
- 从 /jobs/view/ 链接中提取职位标识并去重，避免不同 URL 写法产生重复职位记录。
- 将 salary 作为可选来源数据处理，因为许多职位不会披露薪资，而且公开格式可能不同。
- 在下游界面把 apply_link 展示为外部操作前先校验链接。
- 分别保留 created_at 和 collected_at，避免混淆职位发布时间与数据采集时间。
相关 API
需要其他类型的 LinkedIn 公开数据时，可以使用以下 API。
- LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
- LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
- LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。