Upwork Jobs Scraper API

RapidAPI2026-08-14 更新2026-08-15 收录

数据链接：

官方服务：

资源简介：

Search public Upwork jobs and collect structured job details.

创建时间：

2026-08-14

原始信息汇总

简介 Upwork Jobs Scraper API 是一个非官方的数据接口，用于搜索公开的 Upwork 职位列表，或获取单个职位的完整公开详情。该 API 使用稳定的职位 ID 和规范化的 Upwork URL，适用于职位监控、劳动力市场研究、技能分析和内部职位发现。

基础信息

搜索职位
- 支持通过关键词、高级搜索文本（如 allWords、anyWords、excludedWords、exactPhrase、titleWords）或类型化的公共过滤器（如职位类型、时薪范围、经验级别、客户所在地等）进行生成式搜索。
- 也支持直接提供一个严格的公开 Upwork 搜索 URL（searchUrl），并保留其支持的过滤器进行搜索。
- 单次调用最多可返回 100 个搜索卡片；结合详情获取（fetchDetails: true）时，最多可为 10 个结果附加完整详情。
获取职位详情
- 通过稳定的职位 ID（以 ~02 开头，后跟 18-30 位数字）或规范化的职位 URL 获取单个职位的完整公开信息。
- 职位不可用或已关闭时返回 HTTP 404 错误。

基本用法

认证： 使用 RapidAPI 提供的 x-rapidapi-key 和 x-rapidapi-host 头信息。无需发送额外的后端 bearer 密钥。
REST 路由： POST /jobs（搜索）和 POST /job-detail（职位详情）。
成功状态码： 每次成功调用返回 HTTP 201，并消耗一次 RapidAPI 请求和一次 scraper.run 后端额度。

主要输入与限制

文本字段： 关键词及高级搜索文本字段，字符数限制为 1-200。
ID 字段： 技能、类别、子类别 ID（如 skillIds、categoryIds、subcategoryIds）是数字 Upwork ID，长度限制不同。
分页与排序： pageSize 可选 10、20 或 50；sort 可选 relevance 或 recency（默认 relevance）。
maxItems 控制： 搜索返回数量 1-100；若 fetchDetails 为 true，则上限为 10。
URL 限制： 搜索 URL 必须使用 HTTPS、www.upwork.com 主机和 /nx/search/jobs/ 路径，不支持凭据或自定义端口，URL 长度最多 2048 字符。

搜索输出： 返回 data.jobs、count、estimatedTotal、truncated 和 partial 字段。
详情输出： 返回 data.job。
详情状态： 可能为 not_requested、fetched、unavailable 或 failed。若后续页面或可选详情失败，可能返回部分成功的行（partial: true）。
字段规范： 输出字段固定；缺失值为 null，缺失技能为空数组。