LinkedIn Jobs Data API

Search public LinkedIn guest job listings and get structured details for one job.

原始信息汇总

数据集概述：LinkedIn Jobs Data API

核心功能： 该API允许用户通过关键词和可选地点搜索公开的LinkedIn访客职位列表，或通过数字公司ID搜索职位，并通过数字职位ID或支持的LinkedIn URL获取单个职位的详情。它提供结构化的职位数据，包括稳定的职位ID、公司信息、日期和薪资信号。

---

主要特性与使用场景

该API支持以下主要操作：

• 关键词搜索： 通过keyword（必填）和location（可选）搜索职位，location不填则不限地点。
• 公司搜索： 通过数字companyId（如1441）搜索特定公司的所有职位，此模式下不支持keyword或location。
• 职位搜索筛选： 可按以下条件进行过滤：
  • 职位类型 (jobType)： full_time, part_time, contract, temporary, volunteer, internship, other。
  • 经验级别 (experienceLevel)： internship, entry_level, associate, mid_senior, director, executive。
  • 工作形式 (workType)： on_site, remote, hybrid。
  • 发布日期 (datePosted)： past_24h, past_week, past_month。
  • 薪资下限 (salary)： 支持40000至200000美元的不同阈值。
  • 排序 (sortBy)： 默认按relevant（相关性），也可选择recent（按日期排序）。
  • Easy Apply (easyApplyOnly)： 布尔值，过滤支持一键申请的职位。
• 职位详情获取： 通过数字jobId或完整的jobUrl获取单个职位的详细描述、资格要求、公司信息等。

---

技术规格信息

• 基础URL： https://scraper.run/api/v1/tools/linkedin
• 端点：
  • POST /jobs（用于搜索）
  • POST /job-detail（用于获取详情）
• 请求方式： 仅支持POST请求。
• 响应格式： 返回JSON格式的数据，包含data和meta字段。
• 操作限制：
  • 截止时间： 单次操作最多60秒。
  • 并发限制： 同一用户最多同时运行2个调用。
  • 数据量： 搜索结果的maxItems参数范围为1到100，默认值为25，具体上限取决于订阅计划。
  • 代理： 服务端仅使用已配置的代理，不接受客户端提供的代理设置。

---

错误处理机制

API使用application/problem+json格式返回错误，错误码及含义见下表：

HTTP状态码	代码	含义
400	validation_error	请求字段、模式、类型或边界值无效
400	invalid_job_url	提供的URL不是有效的LinkedIn职位URL
400	max_items_exceeded	maxItems超过订阅计划允许的上限
401	no_api_key	没有有效的API密钥
402	no_subscription 等	账户无法预留调用配额（如无订阅或无积分）
404	job_not_found	请求的职位不存在或不可用
409	duplicate_request	请求ID已被接受（重复请求）
429	concurrency_limit 等	用户并发调用过多或触发限流
499	request_cancelled	调用方取消或关闭了请求
502	upstream_blocked 等	上游服务（如LinkedIn）阻塞或返回异常数据
503	concurrency_unavailable 等	服务暂时不可用（如并发控制、代理或计费系统故障）
504	upstream_timeout	上游请求或完整操作超时

---

定价与订阅计划

该API提供免费试用及付费订阅计划，具体如下：

计划名称	月费	每月请求数
Basic	免费	25次
Pro	$4.99	20,000次
Ultra	$24.99	120,000次
Mega	$49.99	250,000次

注：官方推荐用于常规集成工作的计划为Pro。

---

数据与合规警告

重要事项： 此API为非官方服务，与LinkedIn无任何隶属或背书关系。它使用LinkedIn的公共访客页面和未公开的访客端点。在商业使用前，开发者必须自行评估并遵守相关法律法规，包括但不限于：自动化访问政策、商业再分发权限、职位描述和公司内容的版权、LinkedIn商标使用、数据保留和删除义务，以及公开职位描述中可能包含的个人数据处理要求。