# Upwork Search API (upwork.search)

- Canonical page: [https://everyinfra.com/en/upwork-api/search](https://everyinfra.com/en/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

Upwork Search finds jobs that clients have posted on Upwork by `keyword` and returns each one's title, description, budget or hourly range, contract type, required experience level, workload, expected duration, proposal count, number of people to hire, posting time and tags, plus a profile of the client: name, location, rating, total spend, hire rate, average hourly rate paid and whether their payment method is verified. Freelancers and agencies use it to find projects worth a proposal, and analysts use it to study demand and rates for a skill.

It lists jobs, not freelancers. Filter with `job_type`, `experience_level` and a posting window in `since` and `until`, and order with `sort`. Fixed-price jobs carry `budget`, with its currency in `budget_currency`, while hourly jobs carry `hourly_rate_min` and `hourly_rate_max`. A high `proposals` count means stiff competition, and `client_total_spent` says more than any other field about whether a client is dependable.

## 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 | Searches for outsourcing jobs in search and talent in freelancers. The same skill term maps to client demand and freelancer profiles across the two actions. |
| exclude_keywords | not declared | no | not declared | Job keywords to exclude in search, rather than a talent blacklist or minimum skill requirement. |
| experience_level | enum: entry_level / expert_level / intermediate_level | no | not declared | Filters jobs by experience level: entry_level, intermediate_level, or expert_level. |
| job_type | enum: fixed_price / hourly | no | not declared | Contract billing type for search: hourly or fixed_price, rather than full-time or part-time. |
| since | not declared | no | not declared | Job posting date start point for search, rather than the employer registration date. |
| sort | enum: newest / oldest / relevance | no | not declared | Job sorting order for search: newest, oldest, or relevance. oldest is not guaranteed to take effect in every case. |
| until | not declared | no | not declared | Job posting date end point for search, used in conjunction with since, rather than the contract end date. |
| limit | integer (1–100) | no | 20 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| budget | platform-native meaning |
| budget_currency | platform-native meaning |
| hourly_rate_min | platform-native meaning |
| hourly_rate_max | platform-native meaning |
| job_type | platform-native meaning |
| experience_level | platform-native meaning |
| engagement_type | platform-native meaning |
| duration | platform-native meaning |
| proposals | platform-native meaning |
| persons_to_hire | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| tags | Array of tags. An empty array, not null, when there are none. |
| client_name | platform-native meaning |
| client_location | platform-native meaning |
| client_rating | platform-native meaning |
| client_review_count | platform-native meaning |
| client_total_spent | platform-native meaning |
| client_hire_rate | platform-native meaning |
| client_avg_hourly_rate | platform-native meaning |
| payment_verified | platform-native meaning |
| email | Contact email address, passed through as is. |
| emails | Contact email addresses (a record can have several), passed through as is with duplicates removed. |
| phone | Contact phone number, passed through without format normalization. |
| platform | Source platform identifier, the same as platform in the request (for example 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": { … }
}
```

## FAQ

### Can I search for freelancers instead of jobs?

Not with this capability: `keyword` matches jobs that clients have posted. To find people who take on work, use the Upwork Freelancers capability, which takes a skill keyword and can narrow results by continent and by Top Rated status.

### How do I leave out jobs that mention a certain word?

Pass `exclude_keywords` as an object, not a plain string, for example {"keywords": ["WordPress"], "matchTitle": true, "matchDescription": true, "matchSkills": true}. The list holds the words to exclude, and the three switches say whether to look for them in the job title, the description and the skills list.

### How do I judge whether a client is worth bidding for?

Start with `client_total_spent`, the client's total spend on Upwork and the firmest single sign of a trustworthy client. Then check `payment_verified`, since unverified payment methods carry a higher risk of not being paid, and `client_hire_rate`, where a low share means the client often posts without hiring. Read `client_rating` with `client_review_count`.

## 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
