AI Jobs Search API

Get real-time job listings with powerful filtering and AI-powered insights in one API. Perfect for job boards, dashboards, automation tools, and career platforms

原始信息汇总

AI Jobs Search API 数据集概述

数据集名称

AI Jobs Search API

数据集提供者

novastartech

数据集类别

Jobs

数据集描述

该API提供了一个统一的、通过简单REST接口搜索、分析和集成最新职位列表的方式。它专为需要可靠、结构化职位数据的招聘网站、招聘平台、人才智能工具、自动化工作流和内部招聘系统而设计。这是一个具有AI增强、薪资信号、远程过滤和候选人与职位匹配功能的实时全球职位API。

主要功能与特性

• 可搜索的职位列表：提供可搜索的职位列表。
• 基于新鲜度的数据流：提供按小时、24小时、7天和6个月划分的最新职位数据流。
• 过期职位跟踪：跟踪过期职位以便清理。
• AI就绪的职位元数据：提供AI就绪的职位元数据。
• 候选人与职位匹配：支持根据候选人资料进行职位匹配。
• 趋势市场洞察：提供趋势市场洞察。

目标用户

• 招聘网站创始人
• 招聘人员
• 人才寻源团队
• HR技术平台
• 人才智能公司
• 寻找招聘信号的销售团队
• 无代码和工作流自动化用户

主要端点

• GET /health：检查API是否正在运行。
• GET /v1/jobs/search：基于关键词进行职位搜索的主要端点。
• GET /v1/jobs/hourly：过去一小时内索引的职位。
• GET /v1/jobs/24h：过去24小时内索引的职位。
• GET /v1/jobs/7d：过去7天内索引的职位。
• GET /v1/jobs/6m：过去6个月内发布的职位。
• GET /v1/jobs/expired：返回过期的职位ID，以便从自己的系统中移除或停用。
• GET /v1/jobs/{id}：返回单个职位的完整详细信息。
• POST /v1/jobs/match：根据职位名称、技能、地点、远程偏好和其他信号，对职位与候选人资料进行匹配排序。
• GET /v1/jobs/insights/trending：返回趋势信号，如顶级组织、职位名称和技能。

搜索过滤器

支持多种过滤器，包括：q、location、organization、organization_slug_filter、remote、source、industry_filter、seniority_filter、employment_type_filter、description_filter、organization_description_filter、organization_specialties_filter、employees_gte、employees_lte、agency、directapply、external_apply_url、date_filter、order、limit、offset、include_ai、description_type、ai_work_arrangement_filter、ai_experience_level_filter、ai_visa_sponsorship_filter、ai_has_salary。

分页

使用 limit 和 offset 参数进行分页。

• 标准端点：最多 100 条。
• 6m 端点：最多 500 条。

描述输出控制

使用 description_type 参数控制职位描述的格式：

• none：不包含描述。
• text：纯文本描述。
• html：HTML格式描述。

AI字段

当设置 include_ai=true 时，API可能返回以下字段：

• 薪资信号
• 经验水平
• 工作安排
• 签证赞助信号
• 福利
• 关键技能
• 职责摘要
• 要求摘要
• 语言 （注意：如果AI增强尚未运行，某些AI字段可能为空值。）

返回的职位信息

一个职位结果可能包含以下字段： id、title、organization、organization_url、location_text、remote_derived、employment_type、source、source_type、source_domain、url、date_posted、date_indexed、seniority、linkedin_org_employees、linkedin_org_industry、linkedin_org_followers、directapply、external_apply_url。 启用AI字段后，还可能包含：ai_salary_minvalue、ai_salary_maxvalue、ai_experience_level、ai_work_arrangement。

最佳实践

• 使用 hourly、24h 或 7d 端点进行计划数据摄取。
• 使用 expired 端点保持本地数据库清洁。
• 使用 offset 进行分页。
• 仅在需要AI字段时使用 include_ai=true。
• 需要更小、更快的响应时，使用 description_type=none。
• 需要排序结果而非原始搜索时，使用 match 端点。
• 为仪表板和商业智能使用 insights/trending 端点。

重要说明

• 这是一个职位API，不是官方的LinkedIn API。
• 数据新鲜度取决于数据源可用性和摄取计划。
• 某些字段可能为空，具体取决于数据源覆盖范围和增强状态。
• LinkedIn衍生的公司元数据可能因列表详细信息可用性而异。
• 如果在最终用户应用程序中显示，应谨慎渲染HTML描述。

使用场景总结

• 搜索职位：使用 search。
• 获取最新职位：使用 hourly、24h、7d 或 6m。
• 移除旧职位：使用 expired。
• 推荐职位：使用 match。
• 分析市场：使用 insights/trending。