JobSignal

Job market intelligence API — normalized job listings from 10+ boards & ATS platforms (Workday, Dice, Bayt, JustJoin.IT, and more), with built-in salary benchmarking and skill-demand analytics.

原始信息汇总

JobSignal — 就业市场情报API

数据集概述

JobSignal是一个将10个求职板和ATS平台（包括Workday、Dice、Bayt、Built In、JustJoin.IT、No Fluff Jobs、SimplyHired、We Work Remotely、Bulldogjobs和Guru）的职位发布信息聚合到统一标准化架构中的就业市场情报API。它不仅提供职位搜索功能，还内置了薪资基准分析和技能需求分析，无需自行构建数据管道即可回答市场相关问题。

数据标准化详情

每个职位记录均被标准化为一致的结构，包括：

• 资历级别：junior（初级）、mid（中级）、senior（高级）、lead（主管）
• 雇佣类型：full_time（全职）、part_time（兼职）、contract（合同）、b2b（企业对企业）、internship（实习）
• 工作场所类型：remote（远程）、hybrid（混合）、onsite（现场）
• 薪资：转换为小时、日、周、月和年五个时间维度的数据，同时保留原始字符串和货币信息
• 技能：提取并标准化（例如：Python、FastAPI、SQL）
• 地点：原始文本及解析后的国家/地点数组

端点功能

1. 职位搜索与分析

• GET /jobs：支持全文搜索及多种结构化过滤器组合（技能、来源、雇佣类型、资历、工作场所类型、薪资范围、发布日期范围等），返回轻量级职位摘要对象，分页参数中page_size默认50，最大100。
• GET /jobs/{job_id}：返回完整职位记录，包含完整描述、job_highlights（资格要求、福利、职责）、薪资标准化数据、地点解析、quality_flags（数据完整性检查）及摄取元数据（抓取时间和发布精度等）。
• GET /similar/{job_id}：基于技能和标题关键词的Jaccard相似度对职位进行排序，返回相似职位列表及相似度评分（0.0-1.0）；支持设置limit（1-100）、min_score、按资历/工作场所/来源过滤及排除同一公司的职位。

2. 分析类端点

• GET /analytics/salary：返回符合过滤条件的职位的最低、最高、平均和中位数薪资统计数据，可按资历、来源、地点或工作场所类型分组，并可嵌入薪资最高的前N个职位（0-100，默认10）。
• GET /analytics/skills：返回匹配职位中最常见的标准化技能，同时给出提及该技能的职位百分比及与该技能关联的平均最高薪资（可指定薪资周期），可按照计数、技能名称或平均最高薪资排序。

数据覆盖范围

来源标识	数据类型
workday	ATS租户聚合器（多公司）
bayt	职位板
builtin	职位板
bulldogjobs	职位板
dice	职位板
guru	自由职业市场
simplyhired	职位板
weworkremotely	职位板
justjoinit	职位板
nofluffjobs	职位板

适用场景

• 职位市场薪资基准分析：在做出薪酬决策前，跨资历级别、地点或来源比较岗位薪资范围。
• 技能需求追踪：识别哪些技能在职位发布中最常出现及其与薪酬的关联。
• 职位推荐引擎：结合/jobs搜索和/similar/{job_id}实现"您可能感兴趣的工作"功能。
• 招聘与人才寻源工具：按技能、资历和工作场所类型筛选实时职位，以确定需求集中区域。
• 市场研究报告：直接获取结构化的薪资和技能频率数据，无需手动聚合职位公告。

接口特点

• 统一架构：10个来源的数据映射为相同的响应结构，一次集成即可全面使用。
• 确定性ID：job_id是基于职位发布内容的SHA-256哈希值，便于去重和稳定引用。
• 规范化查询参数：列表类过滤器既支持逗号分隔的CSV格式，也支持重复参数。
• 类型化响应：每个字段均为有文档记录的Pydantic模型，可明确定义可选与必填字段。
• 结果集受限：所有列表和分析端点都有明确的分页或top-N上限，确保生产环境安全使用。
• 错误处理：无效参数返回422状态码，不存在的职位ID返回404状态码，均附带详细的detail字段说明；超限时返回429 Too Many Requests。