Simplyhired API

Access comprehensive job listings from SimplyHired with our scraping API. Search positions by keyword, location, salary, and job type. Extract detailed job descriptions, company ratings, compensation data, and qualifications. Perfect for job boards, salary research, and recruitment platforms.

原始信息汇总

Simplyhired API 数据集概述

数据集基本信息

• 数据集名称: Simplyhired API
• 提供平台: RapidAPI
• API 提供者: otomo
• 数据集类别: Jobs
• API 版本: 1.0.0 (current)
• 服务等级: 100%
• 延迟: 12906ms
• 测试通过率: 100%

订阅计划与定价

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

数据集描述

该API提供对SimplyHired就业数据库中职位列表的程序化访问。此数据抓取解决方案提供结构化的职位数据，包括职位标题、描述、薪资、地点、公司信息和各行业及地理区域的资格要求。适用于招聘平台、职位聚合器和人力资源分析工具。

主要功能

• 通过关键词、地点、薪资和职位类型搜索职位。
• 提取详细的职位描述、公司评级、薪酬数据和资格要求。
• 支持具有广泛过滤条件的针对性搜索和基于URL的提取。
• 每份列表提取30多个数据字段。

数据字段详解

职位标识

• id: 唯一职位标识符
• url: 职位发布直接链接
• title: 原始职位标题
• normalized_title: 标准化标题分类
• display_title: 面向用户的格式化标题

地点数据

• formatted_location: 人类可读的地点
• city, state: 地理组成部分
• latitude, longitude: 精确坐标

薪酬数据

• compensation: 带频率的薪资字符串
• salary_info: 格式化的薪资显示
• is_compensation_estimated: 如果薪资是估算值则为True

职位详情

• job_description_html: 完整的HTML描述
• job_types: 数组（全职、兼职、合同等）
• work_settings: 远程/混合工作指示器
• benefits: 列出的福利和津贴

资格要求

• qualifications: 教育、技能、经验要求
• requirements: 核心先决条件
• uncategorized: 其他属性

雇主信息

• company: 公司名称
• company_rating: 雇主评级（1-5）
• employer_company_page_url: 公司简介链接
• employer_square_logo_url: 徽标图像
• beneficiary_name: 合法雇主实体

元数据

• date_published: 发布日期的Unix时间戳
• sponsored: 付费促销指示器
• expired: 职位状态标志

API端点

1. 搜索职位

• 端点: GET /scrapers/api/simplyhired/job/search
• 描述: 通过关键词匹配和全面的过滤选项搜索职位。

参数:

• keyword (必需): 搜索词（例如 "software engineer", "nurse", "accountant"）
• location (可选): 城市/州、邮政编码或州缩写
• job_type (可选): 雇佣类型 (CF3CP: 全职, 75GKK: 兼职, NJXCK: 合同, 4HKF7: 临时, VDTG7: 实习)
• distance (可选): 半径（英里）（0, 5, 10, 15, 25, 50, 100）
• posted_date (可选): 新近度过滤器（1, 7, 14, 30 天）
• minimum_salary (可选): 薪资阈值（$45k, $60k, $80k, $105k, $145k）
• sort_by (可选): PUBLICATION_DATE 或 RELEVANCE
• cursor (可选): 来自URL的分页游标

2. 通过URL获取职位列表

• 端点: POST /scrapers/api/simplyhired/job/listing-by-url
• 描述: 从特定的SimplyHired列表URL提取职位数据。

输入: json { "url": "https://www.simplyhired.com/search?q=it+manager&l=Hutto%2C+TX" }

响应结构

成功响应

json { "statusCode": 200, "messageCode": "OK", "data": [] }

错误响应

json { "statusCode": 500, "messageCode": "INTERNAL_SERVER_ERROR", "message": "Failed to run robot" }

状态码: 200 (成功), 400 (无效参数), 404 (未找到), 500 (服务器错误)

使用指南

搜索策略

• 关键词优化: 使用特定的职位标题或技能而非通用术语以获得更好的针对性。
• 地点处理: API接受多种格式（城市/州、邮政编码、州）。对于存在于多个州的市名，请包含州名。
• 过滤器组合: 策略性地组合过滤器。将minimum_salary与job_type和distance结合可有效缩小结果范围。
• 分页: 使用结果URL中的cursor参数进行下一页导航。从响应的from_url字段中提取游标值。

数据处理

• HTML解析: 职位描述以HTML形式返回。去除标签以获得纯文本或进行渲染显示。
• 资格要求数组: 三个字段提供技能数据：qualifications、requirements、uncategorized。
• 薪资标准化: 薪酬字符串包含频率指示器（"a year", "an hour"）。解析这些以进行准确比较。
• 坐标精度: 纬度/经度支持邻近度计算和地图可视化。

最佳实践

• 速率限制: 在请求之间实施延迟。高频抓取可能触发阻止。
• 缓存: 职位数据变化缓慢。缓存结果1-4小时以减少API负载。
• 错误处理: 针对400、404、500错误实施相应的验证和重试机制。
• 去重: 在合并来自多个搜索的数据时，交叉引用id字段以避免重复。

高级应用

• 薪资情报: 按职位、地点和经验水平汇总薪酬数据以获得市场洞察。
• 技能提取: 解析qualifications数组以识别趋势技能和认证要求。
• 公司分析: 跟踪雇主的发布量和评级模式以进行招聘定位。
• 地理趋势: 使用坐标数据分析招聘密度和区域市场动态。

搜集汇总

背景与挑战

背景概述

该数据集提供SimplyHired职位数据的API接口，支持按关键词、地点、薪资等条件搜索，可获取职位详情、公司评级等丰富信息，适用于招聘平台、薪资研究等应用场景。