# Upwork Scraper API: 1 Endpoint, Typed JSON | Scrapier (https://scrapier.io/scrapers/upwork/)

> Upwork scraper API: freelance job posts by keyword: title, category, contract type, hourly range and client location. 2 credits per call. Get a free API key.

Last updated: 2026-11-10

## Upwork Scraper API: _1 endpoint_, structured JSON

Upwork job posts by keyword, returned as typed JSON with title, description, category, contract type, hourly range, contractor tier, status and client location. Public data only.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**1**Upwork endpoint

**2**credits per successful call

**0**credits for a failed call

**1**need no Upwork login

Quick answerScrapier returns typed JSON from **1 Upwork endpoint**: freelance job posts with category, contract type, hourly range, contractor tier and client location. Public data only and no proxies; no Upwork login needed. 2 credits per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with Upwork Scraper?

One live endpoint covers Upwork job search. It takes a keyword and optional filters and gives you clean JSON back, for 2 credits per successful call.

### Job searchStart here

`**GET**/api/v2/upwork-jobs/`

Job posts by keyword: title, description, category, contract type, hourly range, tier, status and client location.

2 credits per call_View →Page soon_

Playground

## Try Upwork Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

Upwork**Job search**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping Upwork cost?

Every successful call costs 2 credits, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 2 credits cost $3.16. Scale brings that to $2.39, so 125,000 Upwork calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $3.87 |
| Pro | $79 | 50,000 | $3.16 |
| Scale | $299 | 250,000 | $2.39 |

How to

## How do I use Upwork Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get Upwork job data in a few minutes:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Open the Upwork jobs endpoint**It is `upwork-jobs`, the live Upwork endpoint in the catalog.
3. **Add your keyword**One search term in `query` per call, for example `python developer`.
4. **Choose how many jobs**Set `max_items` (10 by default). The endpoint returns one page; `next_cursor` is always null.
5. **Filter the jobs**Optional `hourly`, `fixed`, `payment_verified`, `no_hires`, `contract_to_hire` and `sort` (recency or relevance).
6. **Run the request**One GET with your key in the `X-API-Key` header and a 210-second timeout, or ask your AI agent over MCP.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Every endpoint takes the same kind of input.

1

### By keyword

You don't know the items yet: find them with a keyword.

Job search`python developer`

Best fordiscovery · plain text, "travel" not "#travel"

Example requests

// GET /api/v2/upwork-jobs/
{
  "query": "python developer",
  "max\_items": "10",
  "hourly": "false",
  "fixed": "false",
  "payment\_verified": "false",
  "no\_hires": "false",
  "contract\_to\_hire": "false",
  "sort": "recency",
  "detail\_concurrency": "3"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Skill or job keyword | `query` | Job posts with title, description, category and contract details |
| Number of jobs | `max_items` | Up to that many jobs in the single page |
| Contract type | `hourly` · `fixed` · `contract_to_hire` | Only hourly, fixed-price or contract-to-hire jobs |
| Client filters | `payment_verified` · `no_hires` | Jobs from clients with a verified payment method, or with no prior hires |
| Order | `sort` | Newest first (recency) or best match (relevance) |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/upwork-jobs/?query=python developer
// one item of data.jobs · catalog sample
{
  "buyer": {
    "location": {
      "city": "Duluth",
      "country": "United States"
    }
  },
  "category": {
    "name": "Virtual Assistance"
  },
  "contractor\_tier": "INTERMEDIATE",
  "currency": "USD",
  "description": "Virtual Specialist - Strategic Executive Specialist...",
  "hourly": {
    "max": 7,
    "min": 4,
    "type": "FULL\_TIME"
  },
  "id": "1991285813907195478",
  "level": "IntermediateLevel",
  "status": "ACTIVE",
  "title": "Talent acquisition specialist",
  "type": "Hourly",
  "keyword": "python developer",
  "scraped\_at": "2026-09-12T09:00:00.000Z"
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with Upwork data?

Public Upwork job data powers freelance lead generation, rate research and demand tracking for skills and tools. Here are three common jobs, and the Upwork scraper endpoint each one uses.

01

### Freelance and agency lead alerts

Search your skills every few hours, sorted by recency, and keep only clients with a verified payment method. Send new posts to your team so you can reply to good clients early.

1. _1_jobs
2. New-job feed

HourlyEmail, CRM

02

### Rate research

Collect hourly ranges and contractor tiers for a skill across many posts, then compare what clients offer for entry, intermediate and expert work before you set your own rates.

1. _1_jobs
2. Rate table

MonthlySheets

03

### Skill demand tracking

Run the same set of keywords every week and count posts per skill, category and contract type. See which tools and frameworks clients ask for more often over time.

1. _1_jobs
2. Demand report

WeeklyDashboard

Features

## Features

Upwork Scraper fetches clean, structured Upwork job data at low cost: built for freelancers, agencies, market research and AI agents.

### Live data, every call

Each request reads Upwork at call time, and every job says when in `scraped_at`.

### Typed, consistent JSON

Same field names on every call; hourly range, category and client location come back as structured objects.

### One page per call

Set `max_items` for the page size; the endpoint is single-page, so `next_cursor` is always null.

### Search filters built in

Hourly or fixed price, payment-verified clients, clients with no hires, contract-to-hire, and sort order.

### MCP-ready for AI agents

The Scrapier MCP server reaches the Upwork endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### No browser to run

Public data only. Upwork search is gated by Cloudflare; Scrapier runs the browser side, so you send one GET with no Upwork login.

### Maintained for you

When Upwork changes its pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

2 credits per call, however many jobs the page holds. Failed calls are never billed.

Why Scrapier

## Why choose this Upwork Scraper?

Upwork's official API is built for approved apps that act on behalf of Upwork users, with an API key request, review and OAuth 2.0. Scrapier reads public Upwork job search results with one API key, at a price you know before the call runs.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$2.39**Per 1,000 calls on Scale

At 2 credits a call. Flat per-call pricing, no compute units or bandwidth to estimate.

**0**Upwork app reviews

No API key request, app review or OAuth flow on Upwork's side.

**1 key**For 35 platforms

The same key and JSON envelope cover LinkedIn, Glassdoor, Seek, Google and more.

| Feature | Scrapier Upwork Scraper | Upwork API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Public job posts | What your approved app and its users authorise | Public job posts |
| Setup | One API key | API key request, review, OAuth 2.0 | Browsers, Cloudflare handling, parsers |
| Maintenance | Handled by Scrapier | Token refresh, schema changes | Breaks on layout and bot-check changes |
| Cost | From $2.39 per 1,000 calls | Set by Upwork's API terms | Servers, proxies and engineering time |
| AI agents | MCP server included | Build your own | Build your own |

FAQ

## Frequently asked questions

### What Upwork data can I get?

upwork-jobs returns job posts for a keyword: job ID, title, description, category, contract type (Hourly or Fixed), hourly minimum and maximum, currency, contractor tier and level, status, client location, the search keyword and scraped\_at.

### Do I need an Upwork account?

No. upwork-jobs reads public job search results, so you send only your Scrapier key and a keyword. There is no Upwork login, cookie, OAuth app or API key request on Upwork's side.

### How many jobs does one call return?

Up to max\_items jobs (10 by default) in a single page. The endpoint is single-page, so next\_cursor is always null; to cover more ground, run more specific keywords or filters instead of paging.

### Can I filter Upwork jobs?

Yes. Set hourly or fixed to true for one contract type, payment\_verified for clients with a verified payment method, no\_hires for clients with no prior hires, contract\_to\_hire for those jobs, and sort to recency or relevance.

### Why does an Upwork call take longer?

Upwork search sits behind Cloudflare, so Scrapier loads it in a browser and may open job detail pages too (detail\_concurrency, 1 to 8). Give the request a client timeout of 210 seconds or more.

### Is it legal to scrape Upwork?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible job posts only. Check Upwork's terms before you republish posts or contact clients outside the platform.

### How much does the Upwork scraper cost?

upwork-jobs costs 2 credits per successful call, however many jobs the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### Can I connect Upwork data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON under data.

### Can I get Upwork data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the Upwork endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### Upwork Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

### What are the Upwork scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running calls need a client timeout of 210 seconds or more.

### How do I scrape Upwork with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/upwork-jobs/", headers={"X-API-Key": key}, params={"query": "python developer"}, timeout=210). The response is JSON, so read r.json()\["data"\]\["jobs"\] directly; there is no HTML to parse and no browser to run.

Other platforms

## You might also like

[### LinkedIn

8 endpoints](https://scrapier.io/scrapers/linkedin/)[### Glassdoor

1 endpoint](https://scrapier.io/scrapers/glassdoor/)[### Seek

1 endpoint](https://scrapier.io/scrapers/seek/)[### Google

12 endpoints](https://scrapier.io/scrapers/google/)[### Reddit

9 endpoints](https://scrapier.io/scrapers/reddit/)[### X (Twitter)

6 endpoints](https://scrapier.io/scrapers/x-twitter/)

Get started

## Start pulling Upwork data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 1 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/upwork/
Site index for AI agents: https://scrapier.io/llms.txt
