# Upwork 关键词搜索 API (upwork.search)

- Canonical page: [https://everyinfra.com/upwork-api/search](https://everyinfra.com/upwork-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "upwork", "action": "search", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=upwork&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 外包岗位关键词；返回需求方发布的工作机会，不是人才搜索。 |
| exclude_keywords | not declared | no | not declared | 排除规则对象，例如 {"keywords":["WordPress"],"matchTitle":true,"matchDescription":true,"matchSkills":true}；不是简单字符串或人才黑名单。 |
| experience_level | enum: entry_level / expert_level / intermediate_level | no | not declared | 岗位经验要求：entry_level 入门、intermediate_level 中级、expert_level 专家。 |
| job_type | enum: fixed_price / hourly | no | not declared | 合同计费类型：hourly 按小时、fixed_price 固定总价；不是全职/兼职。 |
| since | not declared | no | not declared | 岗位发布日期起点，接受 YYYY-MM-DD 或 ISO-8601；不是雇主注册日期。 |
| sort | enum: newest / oldest / relevance | no | not declared | 岗位排序：newest 最新、oldest 最早、relevance 相关性；oldest 不保证在所有情况下生效。 |
| until | not declared | no | not declared | 岗位发布日期终点，与 since 配合；不是合同结束日期。 |
| limit | integer (1–100) | no | 20 | 这次调用最多返回的条数，整数，1–100；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| 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）。 |

## Example

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

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "upwork",
        "action": "search",
        "params": {
            "keyword": "Python automation",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "upwork",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://www.upwork.com/jobs/~022103162557197640589",
      "title": "Part-Time Automation and Systems Builder",
      "text": "# Part-Time Automation & Systems Builder\n\n**The role**\n\nWe’re looking for someone who can turn operational problems into dependable systems our team uses every day. You’ll build automations, internal tools, and reporting workflows that reduce manual work as we grow.\n\nOur technica…",
      "budget_currency": "USD",
      "hourly_rate_min": 20,
      "hourly_rate_max": 30,
      "job_type": "HOURLY",
      "experience_level": "IntermediateLevel",
      "engagement_type": "FULL_TIME",
      "duration": "More than 6 months",
      "proposals": 173,
      "persons_to_hire": 1,
      "posted_at": "2026-09-24T16:40:48.454000+00:00",
      "tags": [
        "Business Process Automation",
        "API Integration",
        "Google Apps Script"
      ],
      "client_location": "United States",
      "client_rating": 4.91,
      "client_review_count": 16,
      "client_total_spent": 13591.13,
      "payment_verified": true,
      "platform": "upwork"
    },
    {
      "id": "•••",
      "url": "https://www.upwork.com/jobs/~022103697282534705588",
      "title": "Python automation script to batch-generate illustrated storybooks (Claude API + image API)",
      "text": "I'm a children's story creator. I need a Python script that runs on its own on my Mac while I'm away.\n\nWhat it should do:\n\nRead a list of story concepts from a file.\nRead one fixed style spec file (format, page count, characters, tone), used in every call.\nCall the Claude API to …",
      "budget": 1000,
      "budget_currency": "USD",
      "hourly_rate_min": 1000,
      "hourly_rate_max": 1000,
      "job_type": "FIXED",
      "experience_level": "IntermediateLevel",
      "duration": "1 to 3 months",
      "proposals": 45,
      "persons_to_hire": 1,
      "posted_at": "2026-09-26T07:05:29.443000+00:00",
      "tags": [
        "Python",
        "Automation",
        "Scripting"
      ],
      "client_location": "Singapore",
      "client_rating": 0,
      "client_review_count": 0,
      "client_total_spent": 0,
      "payment_verified": true,
      "platform": "upwork"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=upwork
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
