LinkedIn Search Jobs API

LinkedIn Search Jobs

主要特性

• 以地点开始发现每次查询都提供非空地点，并可使用关键词、国家、公司或其他 provider 筛选缩小公开职位样本。
• 灵活的来源筛选透传 time_range、job_type、experience_level、remote、company、location_radius、selective_search 和排除值，不虚构 SocQ 枚举。
• 可配置结果上限为单次发现查询把 results_limit 设为 1 至 2000；默认值是 100，provider 可能返回更少记录。
• 规范化职位记录以稳定字段返回职位、公司、地点、薪资、发布时间、过期时间和采集时间，避免依赖 provider 嵌套结构。
• 保留来源空值无法获得的薪资、远程、公司、经验、地点、发布时间和过期时间保持为空，不进行推断。

参数

如何使用

提交一次基于地点的查询，轮询异步任务，然后处理全部返回结果页。

1. 选择必填地点，并且只添加已经验证过解释方式的 provider 筛选值。
2. 把查询提交到 /v1/linkedin/search-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/search-jobs" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"Seattle","keyword":"Python","country":"US","results_limit":20}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor

最佳使用场景

• 区域岗位发现： 使用一致的岗位与地点查询采集公开职位，并保留采集时间以便后续比较。
• 雇主与岗位审阅： 检查返回样本中出现的雇主、职位名称、地点、办公方式、经验级别和雇佣类型。
• 薪酬可用性分析： 识别公开薪资信息的职位，同时把缺失薪酬保留为明确空值。
• 职位工作流输入： 把标准化公开职位 URL 和字段送入审核、去重、提醒或下游分析流程。

使用建议

• 在定期工作流使用 provider 特定筛选拼写之前，先用小规模查询验证。
• 比较不同地点或日期时，保持筛选条件和采集计划一致。
• 使用稳定职位 id 或详情 URL 去重，因为续发和重叠搜索可能返回同一岗位。
• 把远程标记视为来源信号，并阅读描述确认地理、居住地或时区限制。
• 分别保留 published_at、expires_at 和 collected_at，避免混淆职位时间与获取时间。
• 把空结果视为一次采集结果，而不是不存在匹配公开职位的证明。

相关 API