HiringIndex

Jobs API straight from 10 applicant tracking systems — Workday, SmartRecruiters, Greenhouse, Workable, Lever, Ashby, Recruitee, Teamtailor, Breezy, Personio. Search returns the postings with the employer's own apply link; one insights call returns count, salary percentiles, top companies, location and freshness for the same filter. 1.5M+ postings, no aggregators, no scraping of job boards.

原始信息汇总

数据集概述：HiringIndex

HiringIndex 是一个提供职位发布信息及其聚合统计的数据集 API，旨在帮助用户分析就业市场。其核心特色在于，一次 insights 调用即可返回针对同一筛选条件的所有关键统计指标，免去了自行分页抓取和计算的繁琐过程。

一、核心功能与数据来源

• 核心定位：提供职位发布（search）和市场洞察（insights）两个核心功能。insights 接口是其主要产品，可以返回与 search 相同筛选条件下的聚合数据，如职位总数、薪资中位数、顶尖公司等。
• 数据来源：数据直接来源于 10 个主流申请人跟踪系统（ATS） 的公开目录 API，包括 Workday、SmartRecruiters、Greenhouse 等。该 API 明确声明不使用 任何聚合器、招聘网站或社交网络（如 Indeed、LinkedIn、Glassdoor）的数据，确保每个职位的申请链接都指向雇主自己的申请页面。
• 数据规模与填充率：整个数据集包含 1,464,566 条 职位发布。关键字段的填充率如下：
  • 100% 填充：job_title、apply_url、source_platform
  • 99.9% 填充：company_name
  • 94.3% 填充：location_city
  • 约5% 填充：salary_range（这反映了雇主公开薪资的实际频率，而非数据解析缺口）
  • 7.2% 填充：is_remote（标记为远程工作）

二、核心端点 (Endpoints)

API 版本为 2.0.0，提供三个主要端点：

端点	功能	关键参数
POST /v2/jobs/search	返回符合筛选条件的职位列表。	支持按职位名称 (job_titles)、关键词 (keywords)、地理位置 (geo_locations)、工作类型 (location_types)、薪资范围 (salary)、发布时间 (days_ago) 等进行筛选。
POST /v2/jobs/insights	返回与 search 相同筛选条件下的聚合统计信息，而非职位列表。	接受与 search 完全相同的筛选参数。
GET /v2/jobs/{id}	根据职位 ID 获取单条职位发布的详情。	需要职位 ID。

三、数据特性与质量保证

• insights 返回的统计指标：该接口会返回包括总职位数、本周新增数、薪资中位数及百分位数（P25-P90）、薪资直方图、顶尖公司、热门地点、远程/混合/现场办公比例、职位发布年龄分布（如中位在职天数）等在内的一系列指标。
• 严格的字段类型保证：为避免下游数据处理问题，API 对关键字段做了严格定义。例如，posted_at 始终是可解析的日期或 null；salary_range 是包含数字的对象或 null；locations 始终是一个数组（可能为空）。
• 数据透明性：
  • 薪资中位数总是与公开薪资的职位百分比（pct_disclosing_salary）一同返回，以确保数据解读的准确性。
  • 对于相对日期（如"30+天前"），会提供 posted_at_is_relative 标志进行标识，而非精确日期。
  • insights 接口返回的 freshness 字段反映的是职位发布日期的年龄分布，不验证职位是否仍在接受申请。

四、成本与限制说明

• 计费方式：RapidAPI 平台按请求计费。所有发往已声明路径的请求，无论返回状态码（包括400和5xx错误），均计为1次请求。/health 端点不收费，可用于免费的健康检查。
• 明确的功能边界：该 API 不提供以下功能或数据：
  • 不含来自聚合招聘网站（如 Indeed、LinkedIn）的职位。
  • 不提供职位关闭状态或关闭时间的追踪。
  • 不包含候选人、招聘人员或公司的联系方式（公司名除外）。
  • 数据量不是该类别中最大的。
• 错误处理：所有错误均通过统一格式的 error 对象返回，可通过 error.code 进行判断。空结果以 200 状态码及空数组返回。