linkedin/
company-jobs

通过准备好的 LinkedIn /jobs/ URL 发现公开职位,返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。

LinkedIn Company Jobs API

职位页面输入
按 URL 限制
规范化职位记录
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

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,轮询异步任务,然后处理全部返回结果页。

  1. 准备路径以 /jobs/ 开头的公开 LinkedIn URL,并保留有用的查询参数。
  2. 把 urls 和 results_limit 提交到 /v1/linkedin/company-jobs,然后保存 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/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_cursor

LinkedIn Company Jobs API 最佳使用场景

  • 选定雇主监测: 定期访问准备好的公司职位 URL,对比不同采集时间返回的公开职位。
  • 职位目录补充: 为公开职位目录补充标准化公司、地点、雇佣、经验、远程、薪资和日期字段。
  • 招聘页面研究: 比较所选职位页面返回的岗位构成,同时保留来源 URL 和每次采集时间。
  • 工作流输入: 把发现的公开职位记录送入审核、去重、提醒或下游分析流程。

LinkedIn Company Jobs API 使用建议

  • 保留准备 URL 中有意义的查询参数,因为它们可能影响页面展示的职位。
  • 当重叠职位页面返回相同岗位时,使用稳定的职位 id 或详情 URL 去重。
  • 把单个 URL 的空结果视为一次采集结果,而不是该雇主没有开放职位的证明。
  • 需要明确的关键词或地点条件时,使用结构化职位搜索,而不是准备好的页面 URL。
  • 分别保留 published_at、expires_at 和 collected_at,避免混淆职位时间与数据获取时间。

除了 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 公开职位,返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。

探索其他平台

还可以将 LinkedIn 数据与其他已支持社交平台的公开数据结合使用。

LinkedIn Company Jobs API — 常见问题

LinkedIn Company Jobs API 是一个用于通过准备好的 LinkedIn /jobs/ URL 发现公开职位的 API。它返回采集时页面所展示职位的标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。

每个值都必须是 linkedin.com 或 LinkedIn 子域名上的完整 http 或 https URL,且路径以 /jobs/ 开头。普通 /company/ 公司主页 URL 无法通过校验。

这个整数上限分别应用于每个 URL。例如,上限为 20 时,每个提交的职位页面最多可返回 20 条职位。

不是。空结果只表示该 URL 在本次采集时没有返回受支持的公开职位。

不提供。该端点只返回公开职位数据,不会申请职位、联系招聘人员或提供私有招聘分析。

每条返回的职位记录消耗 0.5 个 SocQ 积分,不收取基础费用。空结果集不收取结果费用,允许时实际用量可能超过估算。