LinkedIn Company Jobs
LinkedIn 公司职位是职位页面公开展示的招聘记录，包含岗位名称、公司、地点、雇佣类型、经验要求、远程状态、薪资和时间信息。这些字段可用于跟踪公开职位、比较岗位条件、研究招聘需求，并建立结构化职位目录。
主要特性
- 职位页面发现提交一个或多个路径以 /jobs/ 开头的公开 LinkedIn URL，采集每个准备页面展示的职位。
- 按输入设置上限把 results_limit 设为 1 至 2000；所选上限分别应用于请求中的每个 URL。
- 规范化职位记录以稳定字段返回职位、公司、地点、薪资、发布时间、过期时间和采集时间，避免依赖来源嵌套结构。
- 保留来源空值当公开职位没有展示薪资、远程状态、经验级别或精确地点时，对应字段保持为空。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 LinkedIn http 或 https URL 列表。每个域名必须是 linkedin.com 或其子域名，且路径必须以 /jobs/ 开头。 |
results_limit | 可选 | 应用于每个输入 URL 的可选整数结果上限。默认值为 100，最小值为 1，最大值为 2000。 |
如何使用
提交准备好的职位页面 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_cursor最佳使用场景
- 选定雇主监测： 定期访问准备好的公司职位 URL，对比不同采集时间返回的公开职位。
- 职位目录补充： 为公开职位目录补充标准化公司、地点、雇佣、经验、远程、薪资和日期字段。
- 招聘页面研究： 比较所选职位页面返回的岗位构成，同时保留来源 URL 和每次采集时间。
- 工作流输入： 把发现的公开职位记录送入审核、去重、提醒或下游分析流程。
使用建议
- 保留准备 URL 中有意义的查询参数，因为它们可能影响页面展示的职位。
- 当重叠职位页面返回相同岗位时，使用稳定的职位 id 或详情 URL 去重。
- 把单个 URL 的空结果视为一次采集结果，而不是该雇主没有开放职位的证明。
- 需要明确的关键词或地点条件时，使用结构化职位搜索，而不是准备好的页面 URL。
- 分别保留 published_at、expires_at 和 collected_at，避免混淆职位时间与数据获取时间。
相关 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 Post Comments API — 采集已知 LinkedIn 帖子公开提供的评论，返回正文、作者信息、时间、关系标识以及可见点赞数和回复数。
- LinkedIn Profile Posts API — 通过 LinkedIn 个人主页 URL 发现关联的公开帖子，返回作者、媒体、标签、时间和可见互动信息。
- LinkedIn Search Jobs API — 通过必填地点和可选筛选搜索 LinkedIn 公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Search People API — 通过 LinkedIn 人员搜索 URL 发现候选公开主页，返回标准化身份、描述、图片、地点、网站、账号信号和可用指标。
- LinkedIn Search Posts API — 通过关键词和可选日期字符串发现 Google 索引的 LinkedIn 公开帖子，返回标准化正文、作者、媒体、标签、时间和可见互动。