linkedin/
search-jobs

通过地点和可选 provider 筛选搜索 LinkedIn 公开职位,返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。

LinkedIn Search Jobs API

地点必填
结构化发现
规范化职位记录
每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

LinkedIn Search Jobs

LinkedIn Search Jobs 使用必填地点和可选筛选构建一次公开发现查询。它返回适合研究和工作流输入的采集时职位记录;返回某条职位不代表仍可申请,结果数量也不能直接解释为招聘规模或员工增长。

LinkedIn Search Jobs API 主要特性

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

LinkedIn Search Jobs API 参数

参数必填描述
location必填用于构建 provider 发现查询的必填非空地点字符串。
keyword可选透传给 provider 的可选非空岗位、技能或主题字符串。
country可选不经 SocQ 转换而透传的可选非空国家筛选字符串。
time_range可选可选的非空 provider 特定时效或时间范围字符串。
job_type可选可选的非空 provider 特定雇佣或职位类型筛选字符串。
experience_level可选可选的非空 provider 特定经验或资历筛选字符串。
remote可选可选的非空 provider 特定办公方式或远程筛选字符串。
company可选透传给 provider 的可选非空公司筛选字符串。
selective_search可选透传给 provider、用于控制其 selective-search 行为的可选布尔值。
jobs_to_not_include可选透传给 provider 的可选非空排除字符串列表。
location_radius可选与地点查询关联的可选非空 provider 特定半径字符串。
results_limit可选本次查询的可选整数上限。默认值为 100,最小值为 1,最大值为 2000。

如何使用 LinkedIn Search Jobs API

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

  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

LinkedIn Search Jobs API 最佳使用场景

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

LinkedIn Search Jobs API 使用建议

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

除了 LinkedIn Search Jobs API,需要其他类型的 LinkedIn 公开数据时,可以使用以下 API。

  • LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
  • LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
  • LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。
  • LinkedIn Jobs API — 标准化公开职位名称、公司、描述、地点、资历、雇佣信息、申请链接和可用薪资字段。
  • LinkedIn Company Jobs API — 通过准备好的 LinkedIn /jobs/ URL 发现公开职位,返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
  • LinkedIn Company Posts API — 通过 LinkedIn 公司主页 URL 发现公开帖子,返回正文、作者信息、媒体、话题标签、时间和可见互动指标。

探索其他平台

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

LinkedIn Search Jobs API — 常见问题

LinkedIn Search Jobs API 是一个用于通过必填地点和可选 provider 筛选发现 LinkedIn 公开职位的 API。它返回采集时可用职位的标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。

location 必填且必须包含非空字符串。只提供 keyword、company 或其他可选筛选不能满足当前验证器。

没有。SocQ 会把非空筛选字符串透传给发现 provider,不定义或转换其可接受拼写与组合。

不保证。它是 1 至 2000 的整数上限,默认值为 100。公开可用性、筛选组合、分页、重复项和 provider 行为都可能导致返回更少记录。

不能。每条结果都是公开的采集时记录。采取行动前,应在职位页面核实申请状态、职责、地点限制和薪酬。

不会。该端点不会申请或保存职位、创建提醒、获取申请人、访问 Recruiter,也不提供个性化匹配分数。

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