Indeed API
收藏Indeed API 数据集详情
概要
Indeed API 是一个封装了 Indeed 职位与公司数据的快速、干净的接口，返回标准化 JSON 响应，数据经过 Cloudflare 全球网络边缘缓存，并包含指向 Indeed 页面的直接链接。其覆盖 38 个国家，提供 7 个端点，涵盖职位搜索、公司信息与自动补全建议。
核心功能
- 职位搜索与详情：通过关键词和地点搜索职位，支持按相关性或日期排序，并使用游标分页；可获取完整职位信息（描述、薪资范围、公司评价与评论数、紧急招聘、高招聘量、快速申请等标识）。
- 公司搜索与详情：根据公司名称查找公司（返回 ID、名称、Logo、页面 URL）；可查看公司详细信息（评分、评论数、Logo、页面 URL）；支持获取特定公司的职位列表。
- 自动补全建议：提供职位名称/关键词的自动补全建议；提供地点建议（包含经纬度坐标）。
地理覆盖范围
支持 38 个国家/地区，只需在请求中添加 country 参数（ISO-3166 alpha-2 代码），默认值为 US。支持的国家/地区包括：US、GB、CA、AU、IE、NZ、IN、SG、ZA、PH、AE、SA、DE、AT、CH、FR、BE、LU、NL、ES、IT、PT、BR、MX、AR、CL、CO、PE、SE、NO、DK、FI、PL、TR、JP、KR、HK、MY。
接口端点
| 类别 | 端点 | 说明 |
|---|---|---|
| 职位 | GET /jobs/search |
按关键词和地点搜索职位，支持游标分页 |
GET /jobs/{id} |
获取指定职位的完整详情 | |
| 公司 | GET /companies/search |
按公司名称查找公司 |
GET /companies/{id} |
获取公司详情 | |
GET /companies/{id}/jobs |
获取特定公司发布的职位列表 | |
| 建议 | GET /suggestions/jobs |
职位名称/关键词自动补全建议 |
GET /suggestions/locations |
地点自动补全建议（返回经纬度） |
身份认证与错误处理
-
认证：通过 RapidAPI 自动处理，只需在请求中包含
X-RapidAPI-Key。 -
错误格式：所有错误返回统一的 JSON 信封： json { "error": { "code": "ERROR_CODE", "message": "描述信息", "requestId": "..." } }
-
错误码：
BAD_REQUEST（400）、FORBIDDEN（403）、NOT_FOUND（404）、RATE_LIMITED（429）、UPSTREAM_ERROR（502）、SERVICE_UNAVAILABLE（503）。
示例
请求：GET /jobs/search?q=nurse&location=Houston,%20TX&limit=2
响应： json { "query": { "q": "nurse", "location": "Houston, TX", "sort": "relevance" }, "count": 2, "nextCursor": "AAIAAYEAAgAA…", "jobs": [ { "id": "c524db492b8d45a6", "url": "https://www.indeed.com/viewjob?jk=c524db492b8d45a6", "title": "Registered Nurse - Aesthetic Training Provided", "company": { "name": "LaserAway", "rating": 3.0, "reviewCount": 398, "logoUrl": "https://…/256x256/…", "url": "https://www.indeed.com/cmp/LaserAway" }, "location": "Houston, TX 77339", "countryCode": "US", "latitude": 30.05, "longitude": -95.24, "salary": "$40 - $45 an hour", "currency": "USD" } ] }
