# Upwork Jobs Scraper (`scraptivo/upwork-jobs-scraper`) Actor

Scrapes Upwork freelance job listings by keyword with full search filters (sort, experience, job type, budget, hourly rate, client history, location, timezone, project duration, workload).

- **URL**: https://apify.com/scraptivo/upwork-jobs-scraper.md
- **Developed by:** [Scraptivo](https://apify.com/scraptivo) (community)
- **Categories:** Jobs, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**Upwork Jobs Scraper** collects freelance job listings from Upwork and turns them into structured data for lead generation, market research, and competitive analysis. Provide search keywords, run the Actor, and export job titles, budgets, hourly rates, experience levels, skills, and full descriptions to JSON, CSV, Excel, or your preferred integration. Use it to find qualified projects, monitor demand for your services, and study freelance market rates. Each job result costs $0.002.

### What can you automate with Upwork Jobs Scraper?

- **Find qualified freelance projects** — search keywords and filter by budget, experience level, job type, and client history.
- **Monitor demand for your services** — schedule recurring keyword searches to catch new projects early.
- **Study market rates** — export hourly and fixed-price budgets to benchmark freelance pricing.
- **Build lead lists** — collect job URLs, skills, and descriptions for outreach.
- **Feed a pipeline** — export to CSV or a CRM and deduplicate by job ID.

### Who is this scraper for?

| Team | Workflow |
|---|---|
| Freelancers and agencies | Find and filter projects that match skills and budget. |
| Market researchers | Track demand and rates across freelance categories. |
| Sales and recruiting teams | Build lists of active buyers and open requirements. |
| Competitor analysts | Watch which skills and projects clients are posting. |

### What data can you collect from Upwork?

| Data group | Example fields | How it helps |
|---|---|---|
| Job identity | title, url, id, searchQuery | Identify and link the posting. |
| Budget signals | jobType, fixedPriceAmount, hourlyBudgetMin, hourlyBudgetMax | Assess project value. |
| Requirements | skills, contractorTier, description | Match skills and experience. |
| Timing | publishTime, projectDuration | Gauge urgency and length. |

### How to use Upwork Jobs Scraper

1. Open the Actor in the Scraptivo account.
2. Enter one or more search keywords.
3. Optionally apply filters for budget, experience, job type, and location.
4. Run the Actor.
5. Export the dataset to JSON, CSV, Excel, or your integration.

```json
{ "searchQueries": ["scraping"], "sort": "newest", "maxItems": 20 }
```

### Example workflow

#### Get new web-scraping projects every morning

1. Run a "scraping" search every morning with `sort: newest`.
2. Keep fixed-price jobs above $500 or hourly jobs over $30/hour.
3. Send new records to a CRM or Google Sheet.
4. Deduplicate using the stable `id`.

### Automate and integrate your results

- **Schedule** hourly or daily runs per keyword using Apify's Scheduler or the API.
- **Webhooks** after a successful run to trigger your downstream pipeline.
- **Export** to Google Sheets, Make, Zapier, Slack, or a database.
- **Deduplicate** using the stable `id` field.

```shell
curl "https://api.apify.com/v2/acts/scraptivo~upwork-jobs-scraper/run-sync" -H "Content-Type: application/json" -d '{"searchQueries":["scraping"],"maxItems":20}'
```

### Input reference

| Field | Type | Required | Default | What it controls |
|---|---|---|---:|---|
| searchQueries | array | yes | — | Keywords to search on Upwork job listings. |
| sort | string | no | relevance | Sort by relevance or newest. |
| jobTypes | array | no | \[] | Filter by hourly and/or fixed-price jobs. |
| experienceLevels | array | no | \[] | Filter by entry, intermediate, or expert. |
| category2Uids | array | no | \[] | Upwork category UID values (optional). |
| locations | array | no | \[] | Client location country names. |
| timezones | array | no | \[] | Client time-zone codes (e.g. EST, PST). |
| clientHires | array | no | \[] | Filter by client hire history (0, 1-9, 10+). |
| budgetRanges | array | no | \[] | Fixed-price budget filters. |
| hourlyRate | string | no | "" | Hourly rate range in Upwork format (e.g. 20-50). |
| hourlyRateMin | integer | no | — | Minimum hourly rate in USD. |
| hourlyRateMax | integer | no | — | Maximum hourly rate in USD. |
| projectDurations | array | no | \[] | Project duration filters. |
| workloads | array | no | \[] | Weekly workload filters. |
| contractToHire | boolean | no | false | Only return contract-to-hire jobs. |
| pageSize | integer | no | 10 | Jobs per API page (max 50). |
| maxItems | integer | no | 0 | Max job records to scrape (0 = unlimited). |
| proxyConfiguration | object | no | RESIDENTIAL | Residential proxy for GraphQL API requests. |

### Output example

```json
{
  "id": "2075247703436095883",
  "title": "Fix Cloudflare Bypass & Cookie Expiration in Existing Web Scraper",
  "url": "https://www.upwork.com/jobs/~022075247703436095883",
  "searchQuery": "scraping",
  "jobType": "FIXED",
  "contractorTier": "ExpertLevel",
  "fixedPriceAmount": "50.0",
  "projectDuration": "Less than 1 month",
  "publishTime": "2026-07-09T16:00:42.559Z",
  "skills": ["Data Scraping", "Python", "Node.js", "Cloudflare"]
}
```

### How much does it cost to scrape Upwork?

Upwork Jobs Scraper uses pay-per-event billing on Apify:

- **$0.002 per job result** (the headline result event).
- **$0.00005 per run** for the actor-start event.

Examples: 100 jobs cost about $0.20; 1,000 jobs cost about $2.00 plus the start fee. Free Apify plan users are limited to 10 jobs per run. Residential proxy traffic is billed separately by Apify according to your plan.

### Reliability and responsible use

- A residential proxy is used for all requests and enabled by default.
- Filter fields are optional; leave them empty to return all matching jobs.
- `hourlyBudgetMin` and `hourlyBudgetMax` apply only when `hourlyRate` is empty.
- Scrape only public job data and follow Upwork's terms of service.

### Frequently asked questions

#### Can I filter Upwork jobs by budget?

Yes. Use `budgetRanges` for fixed-price jobs and `hourlyRate` (or `hourlyRateMin`/`hourlyRateMax`) for hourly jobs.

#### Can I schedule Upwork Jobs Scraper to run automatically?

Yes. Use Apify's Scheduler or the API to run keywords on an hourly or daily cadence.

#### What counts as one result?

One job listing. The dataset records each job as a single `dataset-item` event.

#### Why did my run stop at 10 jobs?

Free Apify plan users are limited to 10 jobs per run. Upgrade your plan to scrape more.

#### How do I avoid duplicate records?

Deduplicate on the stable `id` field before writing to your CRM or spreadsheet.

#### Do I need a proxy?

A residential proxy is enabled by default for the GraphQL API requests.

### Related Scraptivo automations

- [LinkedIn Job Scraper](https://apify.com/scraptivo/linkedin-job-scraper) — job postings from LinkedIn.
- [Glassdoor Jobs Scraper](https://apify.com/scraptivo/glassdoor-jobs-scraper) — job listings and employer ratings from Glassdoor.

### Support and custom workflows

Need a different field, source, or delivery workflow? Contact Scraptivo at scraptivo@gmail.com. Include the Actor name, a sample URL, the required fields, and expected volume so we can assess the request.

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords to search on Upwork job listings (e.g. scraping, python developer).

## `sort` (type: `string`):

How to sort results.

## `jobTypes` (type: `array`):

Filter by hourly and/or fixed-price jobs.

## `experienceLevels` (type: `array`):

Required freelancer experience level.

## `category2Uids` (type: `array`):

Upwork category2\_uid values from the site (optional). Example: 531770282584862721 for Web Scraping.

## `locations` (type: `array`):

Client location country names (e.g. United States, Germany).

## `timezones` (type: `array`):

Client time zone codes (e.g. EST, EET, PST).

## `clientHires` (type: `array`):

Filter by how many hires the client has made on Upwork.

## `budgetRanges` (type: `array`):

Fixed-price budget filters.

## `hourlyRate` (type: `string`):

Hourly rate filter in Upwork format (e.g. 20-50, 20-, -30). Overrides hourlyRateMin/Max when set.

## `hourlyRateMin` (type: `integer`):

Minimum hourly rate in USD (used when hourlyRate is empty).

## `hourlyRateMax` (type: `integer`):

Maximum hourly rate in USD (used when hourlyRate is empty).

## `projectDurations` (type: `array`):

Project duration filters.

## `workloads` (type: `array`):

Weekly workload filters.

## `contractToHire` (type: `boolean`):

Only return contract-to-hire opportunities.

## `pageSize` (type: `integer`):

Number of jobs per API page (Upwork default is 10).

## `maxItems` (type: `integer`):

Maximum number of job records to scrape (0 = unlimited). Free Apify plan users are limited to 10 jobs per run.

## `proxyConfiguration` (type: `object`):

Residential proxy used for all GraphQL API requests.

## Actor input object example

```json
{
  "searchQueries": [
    "scraping"
  ],
  "sort": "relevance",
  "jobTypes": [],
  "experienceLevels": [],
  "category2Uids": [],
  "locations": [],
  "timezones": [],
  "clientHires": [],
  "budgetRanges": [],
  "hourlyRate": "",
  "projectDurations": [],
  "workloads": [],
  "contractToHire": false,
  "pageSize": 10,
  "maxItems": 0,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset containing scraped Upwork job listings

## `kvsRecords` (type: `string`):

Run statistics stored in the key-value store

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "scraping"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraptivo/upwork-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["scraping"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("scraptivo/upwork-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "scraping"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call scraptivo/upwork-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraptivo/upwork-jobs-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AFNuWMXbSaf0dBwZ4/builds/kM5EfLHKGjVq1ixuQ/openapi.json