Clair Job Search API
收藏官方服务:
资源简介:
Search normalized active jobs and explore hiring-market trends by role, skill, company, country, and workplace type. Includes provenance, freshness, and stable taxonomies.
创建时间:
2026-08-15
原始信息汇总
数据集概述:Clair Job Search API
该数据集是一个实时抓取并标准化处理的职位与实习信息搜索接口,由 Clair APIs 提供,属于“Jobs”类别。其核心功能是将分散在各雇主招聘网站(Applicant Tracking Systems)上格式不一的职位发布,统一抓取、规范化后,通过一个单一的 API 端点对外提供搜索服务。
1. 核心功能
- 统一搜索端点:提供
GET /v1/jobs端点,用于搜索已索引的活跃职位和实习岗位。 - 标准化数据:自动将不同格式的职位信息(如标题、公司、地点、技能、薪资等)转换为统一、可搜索的结构化字段。
- 多维度搜索与筛选:
- 支持标题的不区分大小写子字符串搜索。
- 提供公司、地点、国家(ISO 代码)、远程/混合/现场办公方式的过滤器。
- 支持职级(从实习生到高管)、职业轨道(IC、管理、高管)筛选。
- 支持基于规范技术名称的技能筛选(
skills_all和skills_any)。 - 支持薪资范围、货币和支付周期(年/月/周/日/小时)筛选。
- 支持按发布时间(
posted_after)或 Clair 发现时间(first_seen_at)进行时效性筛选。
- 实习与职位统一资源:可通过设置
seniority=intern搜索实习、合作教育、学徒等岗位。
2. 数据特点与可靠性
- 诚实数据:对无法从发布方获取或无法安全推断的字段,返回
null。薪资来源会明确标注为“ATS结构化字段”或“从职位描述中提取”。 - 数据溯源:每条职位记录都包含来源供应商、招聘网站、来源ID、首次发现时间和最后验证时间。
- 高质量链接:确保每条返回的职位记录至少包含一个已验证的 HTTPS 职位或申请链接。
- 索引健康度:响应中包含索引状态、最新抓取时间、活跃网站数等元信息。
- 去重处理:合并不同招聘网站上发布的重复职位。
3. 技术规格
- 接口协议:RESTful API,通过 RapidAPI 进行身份认证、配额管理和计费。
- 分页机制:采用不透明游标分页,默认每页 25 条,最大不超过 100 条;排序为最新优先(
posted_at或first_seen_at)。 - 参数说明:提供丰富请求参数,包括
q,company,location,country,workplace_type,seniority,track,department,skills_all/any,salary_min/max,currency,salary_interval,posted_after,first_seen_after,sort,include_description,include_total,limit,cursor等。 - 响应内容:每条职位记录包含 ID、标题、公司、地点、国家、工作类型、申请链接、发布时间、薪资信息(如适用)、职级、技能、描述可用性、来源信息及时间戳。
- 错误处理:定义了明确的错误码和 HTTP 状态码(如 400、401、429、503 等),并建议调用方依据
error字段进行分支处理。
4. 适用场景
- 职位搜索与实习发现产品。
- 招聘与寻源工具。
- 公司招聘动态与竞争对手监控。
- 职位提醒与增量数据摄取。
- 薪酬与劳动力市场研究。
5. 定价与限制
- 定价模式:提供 BASIC(免费)、PRO($10/月)、ULTRA($50/月)、MEGA($150/月)四档订阅计划。
- 描述获取:2,000 字符的纯文本职位描述预览为可选功能,并非完整的描述存档。
- 确切总数:出于性能考虑,确切总数默认关闭,需通过
include_total参数按需开启。
附带信息
- API 提供方:Clair APIs。
- 当前订阅用户数:1。
- 产品文档:完整文档可访问 https://clair.im/docs/jobs-api/introduction (页面外部链接)。
- 示例请求:提供快速开始的
curl示例,展示如何按国家、远程状态、技能进行搜索,以及如何单独搜索实习岗位。
搜集汇总
数据集介绍

背景与挑战
背景概述
Clair Job Search API 可搜索标准化后的活跃职位,并支持按角色、技能、公司、国家和工作场所类型分析招聘市场趋势。该数据集包含数据来源、新鲜度及稳定的分类体系,确保信息可靠。
以上内容由遇见数据集搜集并总结生成



