ZipRecruiter API

Access comprehensive job posting data from ZipRecruiter's extensive employment database. Extract detailed job information including descriptions, locations, employment types, company details, and geographic coordinates. Ideal for job aggregators, recruitment analytics, market research, and career platform development.

原始信息汇总

ZipRecruiter API 数据集概述

数据集基本信息

• 数据集名称: ZipRecruiter API
• 提供平台: RapidAPI
• API 版本: 1.0.0 (current)
• 类别: Jobs
• API 创建者: otomo
• 订阅者数量: 2

API 功能概述

提供对 ZipRecruiter 庞大就业数据库中全面招聘职位发布数据的程序化访问。提取详细的职位信息，包括描述、地点、雇佣类型、公司详情和地理坐标。适用于职位聚合器、招聘分析、市场研究和职业平台开发。

技术特性

• 架构: 基于 REST 原则构建。
• 响应格式: 结构化的 JSON 响应，使用 schema.org JobPosting 标准进行格式化，确保与搜索引擎和申请人跟踪系统的兼容性。

端点详情

端点：获取职位详情（通过 URL）

• 方法: POST
• 路径: /scrapers/api/ziprecruiter/job/get-by-url
• 功能: 从特定的 ZipRecruiter 职位列表 URL 检索全面的职位发布信息。

请求体示例

json { "url": "https://www.ziprecruiter.ie/jobs/487269132-operations-manager-12-month-fixed-term-contract-at-gallagher" }

• 关键输入字段:
  • url (必需): ZipRecruiter 职位发布的完整 URL。

响应结构

• 成功响应: json { "statusCode": 200, "messageCode": "OK", "data": [...] }

• 错误响应: json { "statusCode": 404, "messageCode": "NOT_FOUND", "message": "Job not found" }

状态码

• 200: 请求成功。
• 400: URL 格式无效。
• 404: 未找到职位列表。
• 500: 内部服务器错误。

数据字段详情

职位信息 (data 列表中的对象)

• id: 唯一标识符。
• url: 职位 URL。
• title: 职位头衔。
• description: 完整的 HTML 职位描述（包含格式）。
• date_posted: 发布日期 (YYYY-MM-DD 格式)。
• valid_through: 申请截止日期 (ISO 8601 时间戳)。
• employment_type: 雇佣类型（例如："Full Time", "Part Time", "Contract"）。
• direct_apply: 布尔值，指示是否可直接申请。

公司详情 (hiring_organization)

• name: 雇主名称。
• url: 公司网站。
• same_as: 公司社交媒体或其他 URL。

地点数据 (job_location)

• address_locality: 城市/城镇。
• address_region: 州/省/县。
• postal_code: 邮政编码。
• address_country: 国家名称。
• geo.latitude, geo.longitude: 用于地图绘制的精确坐标。

订阅计划与指标

• 流行度: 8.9
• 服务等级: 75%
• 延迟: 13557ms
• 测试通过率: 100%

可用订阅计划

• BASIC: $0.00 / 月
• PRO: $15.00 / 月
• ULTRA: $49.00 / 月
• MEGA: $139.00 / 月

使用指南与最佳实践

常见问题

• 无效 URL (400): 确保 URL 完整、编码正确且域名匹配目标区域（如 .ie, .com, .co.uk）。
• 未找到职位 (404): 列表可能已过期或被删除，请检查 URL 拼写并确认职位在 ZipRecruiter 上仍处于活跃状态。
• 字段缺失: 并非所有职位都有完整的公司信息，建议在数据处理前进行验证。

数据应用场景

• 职位聚合器: 构建多源招聘板，跨平台规范化数据，提供基于位置的筛选。
• 市场研究: 按区域跟踪就业趋势，分析职位发布频率，监控招聘模式。
• 招聘分析: 比较发布时长，分析职位描述模式，跟踪申请截止日期策略。
• 职业平台: 为职位搜索功能提供支持，启用基于位置的推荐，提供截止日期提醒。

搜集汇总

背景与挑战

背景概述

ZipRecruiter API提供对ZipRecruiter就业数据库中全面职位数据的访问，可提取包括职位描述、地点、雇佣类型、公司详情和地理坐标在内的详细信息。该数据集适用于职位聚合、招聘分析、市场研究及职业平台开发等应用场景。