Upwork API

分别查看 Upwork 外包岗位与接单人才，区分岗位预算和人才展示报价，结合技能与工作成功率整理远程用工需求和候选人。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 upwork，action 填下方列表里的能力名，例如 search。

2 个能力
$1.39 / 千次
失败和空结果都不收费
24h 健康值 99%

免费开始文档

平台运行状态

24h 健康值: 99%

30 天趋势

Upwork 能力清单

能力	做什么	单价空白行均为 $1.39 / 千次	24 小时运行状态 · 全部正常
关键词搜索`search`	用 search 找需求方的岗位，将固定价预算与小时费率分开比较。		健康 · 健康值 99%
自由职业者`freelancers`	用 freelancers 查询接单人才，和 search 的岗位结果分开建模。		正常

Upwork 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

所有能力都是同步调用。

能力	必填参数	可选参数	单次条数	单价空白行均为 $1.39 / 千次	返回字段
search	keyword	exclude_keywords, experience_level, job_type, since, sort, until	默认 20 · 最多 100		id · url · title · text · budget · budget_currency · hourly_rate_min · hourly_rate_max · job_type · experience_level · engagement_type · duration · proposals · persons_to_hire · posted_at · tags · client_name · client_location · client_rating · client_review_count · client_total_spent · client_hire_rate · client_avg_hourly_rate · payment_verified · email · emails · phone · platform
freelancers	keyword	region, top_rated	默认 10 · 最多 200		id · url · name · title · text · location · region · timezone · hourly_rate · currency · job_success_score · total_earnings · total_jobs · total_hours · total_hourly_jobs · total_fixed_jobs · is_top_rated · is_top_rated_plus · is_vetted · is_available · skills · image_url · platform

怎么调用 Upwork 关键词搜索 API？

search

使用 platform="upwork"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、text、budget、budget_currency 等 28 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Upwork search 的参数分别是什么意思？

keyword必填: 外包岗位关键词；返回需求方发布的工作机会，不是人才搜索。
exclude_keywords可选: 排除规则对象，例如 {"keywords":["WordPress"],"matchTitle":true,"matchDescription":true,"matchSkills":true}；不是简单字符串或人才黑名单。
experience_level可选: 岗位经验要求：entry_level 入门、intermediate_level 中级、expert_level 专家。
查看全部 3 个允许值
entry_levelexpert_levelintermediate_level
job_type可选: 合同计费类型：hourly 按小时、fixed_price 固定总价；不是全职/兼职。
Upwork 区分按工时计费和按项目或里程碑约定金额的合同。本接口的 job_type 用于岗位分类，不具备官方合同页面的工时记录、托管付款或里程碑管理能力。官方来源：Upwork：按小时与固定价合同的区别来源核查：2026-09-04
查看全部 2 个允许值
fixed_pricehourly
since可选: 岗位发布日期起点，接受 YYYY-MM-DD 或 ISO-8601；不是雇主注册日期。
sort可选: 岗位排序：newest 最新、oldest 最早、relevance 相关性；oldest 不保证在所有情况下生效。
查看全部 3 个允许值
newestoldestrelevance
until可选: 岗位发布日期终点，与 since 配合；不是合同结束日期。

Upwork 返回字段与含义（18）

job_type: 计费方式（时薪/固定价）。
budget: 固定价项目的预算金额。
budget_currency: 预算币种。
hourly_rate_min: 岗位时薪区间下限。
hourly_rate_max: 岗位时薪区间上限。
duration: 项目预计持续时长。
engagement_type: 投入强度（全职/兼职/按需）。
experience_level: 要求的经验层级（入门/中级/专家）。
persons_to_hire: 计划招募人数。
proposals: 已收到的投标数。数值高说明竞争激烈。
client_name: 雇主名称。
client_location: 雇主所在地。
client_rating: 雇主评分，5 分制。
client_review_count: 雇主收到的评价数。
client_total_spent: 雇主在平台累计花费。判断雇主靠谱程度最硬的一个指标。
client_hire_rate: 雇主的发布转录用比例，低说明常发不招。
client_avg_hourly_rate: 雇主历史支付的平均时薪。
payment_verified: 雇主付款方式是否已验证。未验证的项目回款风险高。

怎么调用 Upwork 自由职业者 API？

freelancers

使用 platform="upwork"、action="freelancers" 调用“自由职业者”能力；返回列表，默认 10 条、单次最多 200 条，主要包含 id、url、name、title、text、location 等 23 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

Upwork freelancers 的参数分别是什么意思？

keyword必填: 人才技能关键词；返回接单自由职业者，不是岗位列表。
region可选: 人才所在大洲：africa、americas、asia、europe、oceania；这是大洲筛选，不接受 US 等国家代码。
查看全部 5 个允许值
africaamericasasiaeuropeoceania
top_rated可选: 是否只取 Top Rated / Top Rated Plus 人才，使用布尔值 true / false，默认不筛选。
Upwork 将 JSS 描述为综合客户满意度、合同结果与长期关系的表现指标，并将其作为部分人才徽章的条件之一。JSS 不等于星级评分，Top Rated 也不代表 EveryInfra 对项目质量作出保证。官方来源：Upwork：JSS 与人才徽章不是同一字段来源核查：2026-09-04

Upwork 返回字段与含义（14）

hourly_rate: 自由职业者的时薪报价。
skills: 技能标签。
region: 地区。
timezone: 时区。
job_success_score: 自由职业者的项目成功分（JSS），Upwork 的核心信誉指标。
is_top_rated: 是否为 Top Rated 认证。
is_top_rated_plus: 是否为 Top Rated Plus（更高一档）。
is_vetted: 是否通过平台专家审核。
is_available: 当前是否接单。
total_jobs: 累计完成项目数。
total_hours: 累计工作小时数。
total_earnings: 累计收入。
total_hourly_jobs: 时薪制项目数。
total_fixed_jobs: 固定价项目数。

一次 Upwork search 调用的全过程：向 POST /api/v1/social 发送 platform="upwork"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、budget 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。

Upwork 原始字段名

EveryInfra 统一字段名

左边是 Upwork 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Upwork 的独有字段名（当前目录）

全站 106 个平台的当前目录中，这 24 个字段名只在 Upwork 出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

budget
budget_currency
hourly_rate_min
hourly_rate_max
experience_level
engagement_type
proposals
persons_to_hire
client_name
client_location
client_rating
client_review_count
client_total_spent
client_hire_rate
client_avg_hourly_rate
payment_verified
job_success_score
total_earnings

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
text: 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
budget: 固定价项目的预算金额。
budget_currency: 预算币种。
hourly_rate_min: 岗位时薪区间下限。
hourly_rate_max: 岗位时薪区间上限。
job_type: 计费方式（时薪/固定价）。
experience_level: 要求的经验层级（入门/中级/专家）。
engagement_type: 投入强度（全职/兼职/按需）。
duration: 项目预计持续时长。
proposals: 已收到的投标数。数值高说明竞争激烈。
persons_to_hire: 计划招募人数。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
tags: 标签数组。无标签时为空数组，不是 null。
client_name: 雇主名称。
client_location: 雇主所在地。
client_rating: 雇主评分，5 分制。
client_review_count: 雇主收到的评价数。
client_total_spent: 雇主在平台累计花费。判断雇主靠谱程度最硬的一个指标。
client_hire_rate: 雇主的发布转录用比例，低说明常发不招。
client_avg_hourly_rate: 雇主历史支付的平均时薪。
payment_verified: 雇主付款方式是否已验证。未验证的项目回款风险高。
email: 联系邮箱，原文透传。
emails: 联系邮箱列表（一条记录可能有多个），原文透传、去重。
phone: 联系电话，原文透传，未做号码格式归一。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
location: 地理位置描述，原文透传，格式随平台而异。
region: 地区。
timezone: 时区。
hourly_rate: 自由职业者的时薪报价。
currency: 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
job_success_score: 自由职业者的项目成功分（JSS），Upwork 的核心信誉指标。
total_earnings: 累计收入。
total_jobs: 累计完成项目数。
total_hours: 累计工作小时数。
total_hourly_jobs: 时薪制项目数。
total_fixed_jobs: 固定价项目数。
is_top_rated: 是否为 Top Rated 认证。
is_top_rated_plus: 是否为 Top Rated Plus（更高一档）。
is_vetted: 是否通过平台专家审核。
is_available: 当前是否接单。
skills: 技能标签。
image_url: 图片链接。多图能力可能返回 image_urls 数组。

请求填写示例

这里检索项目职位；country 的实际大陆值域与常见国家码不同。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

upwork_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"upwork","action":"search","params":{"keyword":"Python automation"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "budget": null,
  "budget_currency": null,
  "hourly_rate_min": null,
  "hourly_rate_max": null,
  "job_type": null,
  "experience_level": null,
  "engagement_type": null,
  "duration": null,
  "proposals": null,
  "persons_to_hire": null,
  "posted_at": null,
  "tags": null,
  "client_name": null,
  "client_location": null,
  "client_rating": null,
  "client_review_count": null,
  "client_total_spent": null,
  "client_hire_rate": null,
  "client_avg_hourly_rate": null,
  "payment_verified": null,
  "email": null,
  "emails": null,
  "phone": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按合同计费方式搜索 Upwork 外包岗位

用 search 找需求方的岗位，将固定价预算与小时费率分开比较。

查看 search 的 job_type 参数

keyword 是技能或岗位词；job_type 的 hourly 表示按小时，fixed_price 表示固定总价，不是全职或兼职。budget / budget_currency 与 hourly_rate_min / hourly_rate_max 不能直接相互比较，也不是 EveryInfra 调用价格。
since / until 是岗位发布时间边界，exclude_keywords 用于排除岗位关键词；部分执行路径的筛选及 oldest 排序尚未保证一致，不要据此当作完整历史。experience_level 虽在说明中出现，当前公开参数表未列出，不自行追加。
proposals 是返回的投标数或区间，payment_verified 只是付款方式标记，client_total_spent 是历史花费；这些都不保证雇主履约或回款。接口不代投标、发消息或签订合同。

按技能查看 Upwork 人才及 JSS 指标

用 freelancers 查询接单人才，和 search 的岗位结果分开建模。

查看 freelancers 的 top_rated 参数

keyword 在这里是人才技能词；top_rated 使用 JSON 布尔值，不传字符串 false。country 当前允许值实际是大洲，并存在国家和地区映射冲突，不能作为可靠的国家过滤器。
hourly_rate / currency 是人才展示报价，job_success_score 是平台的 JSS；is_top_rated、is_top_rated_plus、is_vetted 是不同标记，不能合成同一种认证或技能保证。is_available 来自可接单徽章，不保证能立即接受项目。
total_jobs / total_hours / total_earnings 仅按返回值使用，不等于完整合同或个人收入流水；此接口不返回私信、联系方式名单或雇佣操作。

Upwork API 常见问题

Upwork API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="upwork"、action 和 params。以 search 为例，必填 keyword，可选 exclude_keywords、experience_level、job_type、since。这里检索项目职位；country 的实际大陆值域与常见国家码不同。 Upwork 共 2 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Upwork API 怎么收费？

$1.39 / 千次，Upwork 全部 2 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Upwork 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Upwork API 一次能返回多少条数据？

Upwork 有 2 个列表接口，包括 search、freelancers。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Upwork API 返回哪些字段？

当前目录为 search 列出 id、url、title、text、budget、budget_currency 等 28 个字段名。按全站当前目录统计，24 个字段名只在 Upwork 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按合同计费方式搜索 Upwork 外包岗位」怎样接入 Upwork API？

用 search 找需求方的岗位，将固定价预算与小时费率分开比较。 keyword 是技能或岗位词；job_type 的 hourly 表示按小时，fixed_price 表示固定总价，不是全职或兼职。budget / budget_currency 与 hourly_rate_min / hourly_rate_max 不能直接相互比较，也不是 EveryInfra 调用价格。 since / until 是岗位发布时间边界，exclude_keywords 用于排除岗位关键词；部分执行路径的筛选及 oldest 排序尚未保证一致，不要据此当作完整历史。experience_level 虽在说明中出现，当前公开参数表未列出，不自行追加。 proposals 是返回的投标数或区间，payment_verified 只是付款方式标记，client_total_spent 是历史花费；这些都不保证雇主履约或回款。接口不代投标、发消息或签订合同。

「按技能查看 Upwork 人才及 JSS 指标」怎样接入 Upwork API？

用 freelancers 查询接单人才，和 search 的岗位结果分开建模。 keyword 在这里是人才技能词；top_rated 使用 JSON 布尔值，不传字符串 false。country 当前允许值实际是大洲，并存在国家和地区映射冲突，不能作为可靠的国家过滤器。 hourly_rate / currency 是人才展示报价，job_success_score 是平台的 JSS；is_top_rated、is_top_rated_plus、is_vetted 是不同标记，不能合成同一种认证或技能保证。is_available 来自可接单徽章，不保证能立即接受项目。 total_jobs / total_hours / total_earnings 仅按返回值使用，不等于完整合同或个人收入流水；此接口不返回私信、联系方式名单或雇佣操作。

可以先免费试用 Upwork API 吗？

可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小⁠时内有效。请先选择 Upwork 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 2 个能力。无需信用卡。

Airbnb API App Store API Booking API Capterra API Clutch API Crexi API Dice API Expedia API 全部 106 平台 ↗

开始调用 Upwork API

在 GitHub 给两个仓库点星领 $1 额度，注册后在控制台领取，24 小⁠时内有效，先选一个 Upwork 接口验证结果。

免费开始