LinkedIn Company Jobs
LinkedIn 公司职位是职位页面公开展示的招聘记录,包含岗位名称、公司、地点、雇佣类型、经验要求、远程状态、薪资和时间信息。这些字段可用于跟踪公开职位、比较岗位条件、研究招聘需求,并建立结构化职位目录。
LinkedIn Company Jobs API 主要特性
- 职位页面发现提交一个或多个路径以 /jobs/ 开头的公开 LinkedIn URL,采集每个准备页面展示的职位。
- 按输入设置上限把 results_limit 设为 1 至 2000;所选上限分别应用于请求中的每个 URL。
- 规范化职位记录以稳定字段返回职位、公司、地点、薪资、发布时间、过期时间和采集时间,避免依赖来源嵌套结构。
- 保留来源空值当公开职位没有展示薪资、远程状态、经验级别或精确地点时,对应字段保持为空。
LinkedIn Company Jobs API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 LinkedIn http 或 https URL 列表。每个域名必须是 linkedin.com 或其子域名,且路径必须以 /jobs/ 开头。 |
results_limit | 可选 | 应用于每个输入 URL 的可选整数结果上限。默认值为 100,最小值为 1,最大值为 2000。 |
如何使用 LinkedIn Company Jobs API
提交准备好的职位页面 URL,轮询异步任务,然后处理全部返回结果页。
- 准备路径以 /jobs/ 开头的公开 LinkedIn URL,并保留有用的查询参数。
- 把 urls 和 results_limit 提交到 /v1/linkedin/company-jobs,然后保存 task_id。
- 轮询 /v1/tasks/{task_id},直到任务进入终止状态。
- 成功后处理 data.results.items;has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin/company-jobs" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/jobs/microsoft-jobs/"],"results_limit":20}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items,并在 has_more 为 true 时继续使用 next_cursorLinkedIn Company Jobs API 最佳使用场景
- 选定雇主监测: 定期访问准备好的公司职位 URL,对比不同采集时间返回的公开职位。
- 职位目录补充: 为公开职位目录补充标准化公司、地点、雇佣、经验、远程、薪资和日期字段。
- 招聘页面研究: 比较所选职位页面返回的岗位构成,同时保留来源 URL 和每次采集时间。
- 工作流输入: 把发现的公开职位记录送入审核、去重、提醒或下游分析流程。
LinkedIn Company Jobs API 使用建议
- 保留准备 URL 中有意义的查询参数,因为它们可能影响页面展示的职位。
- 当重叠职位页面返回相同岗位时,使用稳定的职位 id 或详情 URL 去重。
- 把单个 URL 的空结果视为一次采集结果,而不是该雇主没有开放职位的证明。
- 需要明确的关键词或地点条件时,使用结构化职位搜索,而不是准备好的页面 URL。
- 分别保留 published_at、expires_at 和 collected_at,避免混淆职位时间与数据获取时间。
相关 API
除了 LinkedIn Company Jobs API,需要其他类型的 LinkedIn 公开数据时,可以使用以下 API。
- LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
- LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
- LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。
- LinkedIn Jobs API — 标准化公开职位名称、公司、描述、地点、资历、雇佣信息、申请链接和可用薪资字段。
- LinkedIn Company Posts API — 通过 LinkedIn 公司主页 URL 发现公开帖子,返回正文、作者信息、媒体、话题标签、时间和可见互动指标。
- LinkedIn Search Jobs API — 通过必填地点和可选筛选搜索 LinkedIn 公开职位,返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。