Stepstone API

Access structured job listing data from Stepstone Group — one of the UK's leading employment platforms. Search vacancies by keyword and location, retrieve full job details including salary, company ratings, and geolocation, all via a clean REST API.

原始信息汇总

Stepstone API 数据集概述

数据集基本信息

• 数据集名称: Stepstone API
• 数据来源: Stepstone Group（英国领先的就业平台网络）
• 数据内容: 结构化职位列表数据
• 数据覆盖范围: 英国及Stepstone集团旗下多个国际市场的招聘平台

数据覆盖平台

欧洲市场

• totaljobs.com: 英国领先的招聘网站
• stepstone.de: 德国主要招聘平台
• stepstone.at: 奥地利顶级招聘网站
• stepstone.be: 比利时主要就业市场
• stepstone.nl: 荷兰领先的职业平台

国际市场

• pnet.co.za: 南非最大的求职门户

爱尔兰及北爱尔兰

• irishjobs.ie: 爱尔兰领先的求职网站
• nijobs.com: 北爱尔兰顶级招聘平台

API端点功能

1. GET /job/search - 按条件搜索职位

• 主要功能: 职位发现的主要入口点
• 必需参数: keyword（职位名称、角色或技能）
• 可选参数:
  • location: 城市或地区名称
  • radius: 搜索半径（英里）：0, 5, 10, 20, 30
  • posted_date: 近期筛选：1（最近24小时）、3（3天）、7（1周）、14（2周）
  • sort_by: 排序方式：sort_publish（最新）、sort_distance（最近）、sort_salary_low、sort_salary_high
  • page: 分页页码

2. POST /job/listing-by-url - 通过URL获取职位列表

• 主要功能: 通过传递完整的Totaljobs搜索结果URL检索一批职位列表
• 必需参数: url（Totaljobs职位列表页面的完整URL）

3. POST /job/get-by-url - 通过URL获取完整职位详情

• 主要功能: 通过传递直接Totaljobs URL检索单个职位的全面信息
• 必需参数: url（Totaljobs.com上单个职位列表页面的URL）

数据结构

响应格式

所有端点返回统一的JSON响应信封：

成功响应: json { "statusCode": 200, "messageCode": "OK", "data": [ /* 职位对象数组 */ ] }

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

常见HTTP状态码

• 200: 成功 - 返回数据
• 400: 错误请求 - 参数或URL格式无效
• 404: 未找到 - 职位列表不存在或已过期
• 500: 内部服务器错误 - 爬虫执行失败

数据字段详情

搜索响应包含的字段

• id: 职位ID
• url: 职位URL
• title: 职位标题
• salary: 薪资信息
• location: 工作地点
• company_name: 公司名称
• date_posted: 发布日期
• publish_to_date: 发布截止日期
• company_logo_url: 公司Logo URL
• text_snippet: 职位描述摘要

详细响应包含的字段

• description: 完整的HTML职位描述
• company.rating: 公司评分数据（overall_rating_avg, surveys_count）
• job_location.geo: 地理坐标（latitude, longitude）
• direct_apply: 直接申请标志
• employment_type: 雇佣类型
• valid_through: 有效期至
• benefits: 福利信息

主要功能特性

• 关键词驱动搜索: 支持位置和半径过滤
• 近期筛选: 可将结果缩小到最近24小时、3天、7天或14天
• 薪资排序: 按薪资从低到高或从高到低排序
• 丰富的职位详情数据: 完整的HTML职位描述、公司评分、地理坐标、雇佣类型和有效期
• 直接申请标志: 指示职位是否允许直接在Totaljobs上申请或重定向到外部

使用建议

推荐工作流程

1. 使用/job/search或/job/listing-by-url发现职位，大规模收集职位ID、标题、地点和薪资信息
2. 对符合标准的职位调用/job/get-by-url，仅在需要时检索完整的描述、公司评分和地理定位数据

最佳实践提示

• 使用posted_date=1或posted_date=3进行实时职位监控
• sort_salary_high对薪资基准测试特别有用
• direct_apply标志可帮助筛选允许简化申请流程的职位
• 公司评分（overall_rating_avg, surveys_count）为雇主声誉筛选提供有用信号
• 详细响应中的地理坐标支持基于地图的职位发现功能
• 搜索结果中的publish_to_date可计算职位列表到期前剩余时间

错误处理

• 缺少必需参数: 状态码400，建议在发送请求前验证输入
• 过期或删除的职位列表: 状态码404，建议跳过并记录
• 爬虫执行失败: 状态码500，建议使用指数退避重试

法律合规

使用此API需确保符合Totaljobs的服务条款和适用的数据保护法规（包括英国GDPR）。职位发布可能包含招聘人员联系方式等个人数据，应妥善处理此类数据，仅存储用例必需的数据，并避免以可能侵犯Totaljobs知识产权的方式重新发布职位内容。