# Upwork Jobs Scraper — Budgets, Client Spend & Proposals (`foxlabs/upwork-jobs-scraper`) Actor

Scrape Upwork freelance jobs by keyword, search URL, or job URL. Extracts full job descriptions, hourly and fixed budgets, skills, exact applicant and interview counts, buyer last-active time, client total spend, hire rate, rating, and country. No login required.

- **URL**: https://apify.com/foxlabs/upwork-jobs-scraper.md
- **Developed by:** [Berkan Kaplan](https://apify.com/foxlabs) (community)
- **Categories:** Jobs, Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 upwork job listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

<p align="center">
  <img src="https://img.shields.io/badge/Pay--Per--Event-Jobs_%2B_Client_Spend_Leads-00C853?style=for-the-badge" alt="Pay-Per-Event" />&nbsp;
  <img src="https://img.shields.io/badge/B2B_Buyer_Signals-Spend_%C2%B7_Hires_%C2%B7_Proposals-2962FF?style=for-the-badge" alt="B2B Buyer Signals" />&nbsp;
  <img src="https://img.shields.io/badge/AI_Agent_Ready-MCP_%26_x402-7C4DFF?style=for-the-badge" alt="MCP & x402 Ready" />&nbsp;
  <img src="https://img.shields.io/badge/Dual_Runtime-Batch_%2B_Standby_API-FF6D00?style=for-the-badge" alt="Batch + Standby API" />
</p>

## Upwork Jobs Scraper — Budgets, Client Spend & Proposals 🚀

**foXLabs Jobs, Freelance & B2B Lead Intelligence Series:** [SEEK Jobs Scraper](https://apify.com/foxlabs/seek-jobs-scraper) · [Whop Marketplace Scraper](https://apify.com/foxlabs/whop-marketplace-scraper) · [Skool Community Scraper](https://apify.com/foxlabs/skool-community-scraper) · [Shopify App Store Scraper](https://apify.com/foxlabs/shopify-app-store-scraper) · [Yelp Business Leads Scraper](https://apify.com/foxlabs/yelp-business-scraper)

🎉 Turn any **Upwork keyword search, custom `/nx/search/jobs/` filter URL, or direct job posting URL** into structured **51-column freelance demand & B2B buyer-intent intelligence** — extracting **full job descriptions, fixed & hourly budgets, required skills, experience tiers, exact applicant & interview counts, buyer last-active timestamps, client lifetime USD spend, total hires, effective hourly rates paid, payment verification, feedback ratings and client country/city** with **zero Upwork login and zero cookies**.

Built for software & AI automation agencies, freelance BD teams, outbound B2B lead scoring pipelines, staffing & talent-marketplace analysts and autonomous job-scouting AI agents.

### 🔍 What is the Upwork Jobs Scraper — and when should you use it?

Every minute, funded startups, SMBs and enterprise teams post live RFPs on Upwork describing the exact technical bottleneck they are ready to pay to solve right now — complete with verified historical spend (`$10K–$1M+`), effective hourly rates paid and real-time hiring activity. Yet Upwork shut down its legacy public RSS feeds, gates API access behind app reviews, and blocks standard scrapers at the edge.

This Actor unlocks clean, real-time Upwork job & buyer telemetry inside a fast `256 MB` runtime:

- **Keyword Queries, Filtered Search URLs & Direct Job URLs** — run multi-keyword monitors (`queries: ["ai automation", "n8n", "nextjs"]`), paste advanced Upwork search links (`searchUrls`), or enrich specific `/freelance-jobs/apply/...` and `/jobs/...` URLs (`jobUrls`).
- **Two-Tier Depth Control (`job` vs. `job-detail`)** — run fast search sweeps (`enrichClientDetails: false`, `$0.0025`/job) for full descriptions, budgets, skills and timestamps, or enable **B2B Agency Buyer Enrichment (`enrichClientDetails: true`, `$0.0055`/job)** to add `clientTotalSpentUsd`, `clientTotalHires`, `clientEffectiveHourlyRateUsd`, `clientPaymentVerified`, `clientScore`, `clientCountry`/`clientCity`, `clientCompanySize`, `clientIndustry`, exact `totalApplicants`, `totalInvitedToInterview`, `totalHired` and `lastBuyerActivity`.
- **High-Ticket Client Qualification (`minClientSpendUsd`)** — automatically drop `$0`-spend tire-kickers and deliver only verified buyers who have already spent e.g. `$5,000+` or `$25,000+` on Upwork.

**Use it when you need:** real-time Slack/Telegram/CRM alerts for newly posted high-budget agency leads; B2B buyer qualification by verified historical spend & low proposal competition; freelance skill-rate market research; or autonomous AI proposal triage.

**Use something else when:** you need **freelancer talent profiles** rather than client job postings, or full-time salaried corporate job boards in APAC (use [SEEK Jobs Scraper](https://apify.com/foxlabs/seek-jobs-scraper) for salaried ANZ/APAC employer listings with salary bands).

### 🤖 Use with AI agents (MCP, Claude, Cursor & x402)

**Already connected to the Apify MCP server?** Ask your AI assistant to call `foxlabs/upwork-jobs-scraper`.

- **Hosted MCP URL (zero install):** `https://mcp.apify.com?tools=foxlabs/upwork-jobs-scraper`
- **Local stdio config (Claude Desktop, Cursor, Cline, Windsurf):**

```json
{
  "mcpServers": {
    "upwork-jobs-scraper": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--tools", "foxlabs/upwork-jobs-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

**Your agent can pay for its own runs.** This Actor uses mutually exclusive pay-per-event pricing (`$0.0025` per `job`, `$0.0055` per `job-detail` when enriched, `$0.00` for diagnostic `status` rows) and supports autonomous agentic micropayments via **x402 (USDC on Base)** or **Skyfire** alongside standard Apify tokens.

Copy-paste prompt for Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
Use the Apify Actor `foxlabs/upwork-jobs-scraper` to find live Upwork freelance jobs, budgets, proposal competition and verified client spend history.

Input fields:
- `queries`: array of skill or keyword searches (e.g. ["ai automation", "web scraping"])
- `searchUrls`: optional array of https://www.upwork.com/nx/search/jobs/?q=... URLs
- `jobUrls`: optional array of direct Upwork job URLs
- `sortBy`: "recency" (default) | "relevance"
- `jobType`: "all" (default) | "hourly" | "fixed"
- `experienceLevel`: "all" (default) | "entry" | "intermediate" | "expert"
- `enrichClientDetails`: boolean (default false) — fetches client spend ($), hires, rating, country, exact applicant/interview counts & buyer last-active time
- `minClientSpendUsd`: integer >= 0 (default 0; filter when enrichClientDetails is true)
- `maxJobsPerQuery`: integer 1..200 (default 10)

Start with:
{"queries":["ai agent","n8n automation"],"sortBy":"recency","experienceLevel":"expert","enrichClientDetails":true,"minClientSpendUsd":5000,"maxJobsPerQuery":15}
```

**Things you can ask your AI agent:**

- *"Find the 15 newest Expert-level `ai automation` jobs on Upwork from verified clients with at least `$5,000` lifetime spend and fewer than `10` applicants (`totalInvitedToInterview == 0`), and rank the best 5 to pitch."*
- *"Compare hourly budget ranges (`hourlyBudgetMin`–`hourlyBudgetMax`) across `nextjs`, `python` and `rust` Upwork postings today."*
- *"Inspect these 3 direct Upwork `jobUrls` and check `lastBuyerActivity`, `totalHired`, `clientEffectiveHourlyRateUsd` and `clientScore` before we spend Connects."*

The machine-readable Actor summary, MCP metadata and schema live at `https://apify.com/foxlabs/upwork-jobs-scraper.md`.

### 📋 Overview

Everything needed to replace Upwork's retired RSS feeds with structured job, competition and buyer-spend telemetry — in one 51-column schema.

| Property | Details |
|---|---|
| **Public data source** | Public Upwork job search & posting pages (`upwork.com`) |
| **Authentication required** | None — zero Upwork freelancer/agency account, API keys or cookies |
| **Container footprint** | Lightweight `256 MB` HTTP runtime (~8.9s for 20 search jobs on platform QA) |
| **Output row types (`rowType`)** | `job` (`$0.0025` search-tier · `$0.0055` `job-detail` when enriched), `status` (`$0.00`) |
| **Deduplication & restart safety** | Deterministic `rowKey` (`upwork:job:<jobUid>`) across overlapping keywords & restarts |
| **Execution modes** | Standard Batch Dataset runs + synchronous Standby HTTP API (`GET /`, `GET /health`, `POST /scrape`) |

**Why agencies & growth teams pick this Actor:**

- 💰 **Verified client financial history (`enrichClientDetails: true`)** — see exact `clientTotalSpentUsd`, `clientTotalHires`, `clientTotalHours`, `clientEffectiveHourlyRateUsd`, `clientPaymentVerified` and `clientScore` before spending a single Connect.
- 👀 **Live proposal & buyer-activity telemetry** — know exact `totalApplicants`, `totalInvitedToInterview`, `invitationsSent`, `unansweredInvites`, `totalHired` and `lastBuyerActivity` (avoiding dead jobs where the client already hired or went ghost).
- ⚡ **Sub-10-second RSS replacement** — default `enrichClientDetails: false` mode pulls 20 fresh jobs with full descriptions, budgets and skills in ~9 seconds at `$2.50 / 1,000`.
- ⚖️ **Zero double-charging** — enriched rows fire `job-detail` (`$0.0055`) instead of `job` (`$0.0025`), never both.
- 🛡️ **Strict `null` integrity** — hourly jobs emit `fixedBudgetUsd: null` and fixed-price jobs emit `hourlyBudgetMin: null` / `hourlyBudgetMax: null` (never fake `0`s).

### ✨ Key Features

- 🔎 **Multi-Keyword & Custom Search URL Ingestion** — Run dozens of niche skill keywords in `queries` (`sortBy: "recency"` or `"relevance"`) or paste complex `/nx/search/jobs/?...` URLs with custom budget/location/category parameters intact.
- 🏢 **Client Firmographics & Spend Qualification** — Captures `clientCountry`, `clientCity`, `clientTimezone`, `clientMemberSince`, `clientIndustry`, `clientCompanySize` and filters automatically via `minClientSpendUsd`.
- 📋 **Complete Scope & Contract Metadata** — Extracts full `description`, `contractType` (`HOURLY` / `FIXED`), `fixedBudgetUsd`, `hourlyBudgetMin`/`Max`, `experienceLevel`, `durationLabel`, `workload`, `skills[]`, `category`, `categoryGroup`, `isContractToHire`, `isEnterpriseJob` and `freelancersToHire`.
- 🔌 **Real-Time Standby HTTP Server** — Call `POST /scrape` synchronously from n8n, Make, Clay or Slack/Discord proposal-drafting bots.

### 🎬 Quick Start (API & Standby HTTP)

**1. Synchronous Batch API call (returns JSON array directly):**

```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~upwork-jobs-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["ai automation","web scraping"],"sortBy":"recency","maxJobsPerQuery":10,"enrichClientDetails":false}'
```

**2. Real-time Standby HTTP API (`POST /scrape`):**

```bash
curl -X POST "https://foxlabs--upwork-jobs-scraper.apify.actor/scrape?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["n8n"],"sortBy":"recency","enrichClientDetails":true,"minClientSpendUsd":1000,"maxJobsPerQuery":5}'
```

### 🚀 Getting Started (3 steps)

1. **Enter skill keywords or Upwork URLs** — Add search phrases in **Queries** (`"ai automation"`, `"shopify plus"`), filtered `/nx/search/jobs/` URLs in **Search URLs**, or individual job links in **Job URLs**.
2. **Choose contract filters & buyer enrichment** — Pick `sortBy`, `jobType`, `experienceLevel`, and enable `enrichClientDetails: true` (+ optional `minClientSpendUsd`) if you want full client spend & applicant counts.
3. **Run & automate** — Click **Start** (or put it on a 15-minute Apify Schedule) and stream qualified leads into Slack, Clay, HubSpot or Airtable.

### 📥 Input & Filters

```json
{
  "queries": ["ai automation", "n8n workflow"],
  "searchUrls": [],
  "jobUrls": [],
  "sortBy": "recency",
  "jobType": "all",
  "experienceLevel": "intermediate",
  "enrichClientDetails": true,
  "minClientSpendUsd": 2000,
  "maxJobsPerQuery": 15
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `queries` | `array<string>` | `["ai automation", "web scraping"]` | Keywords or skill phrases to search on Upwork. |
| `searchUrls` | `array<string>` | `[]` | Direct `https://www.upwork.com/nx/search/jobs/?...` URLs (all custom URL query filters preserved). |
| `jobUrls` | `array<string>` | `[]` | Direct `/freelance-jobs/apply/...` or `/jobs/...` URLs (automatically enriches full client & applicant telemetry). |
| `sortBy` | `string` | `"recency"` | `"recency"` (newest jobs first — best for scheduled alerts) or `"relevance"`. |
| `jobType` | `string` | `"all"` | Contract billing model filter: `"all"`, `"hourly"`, or `"fixed"`. |
| `experienceLevel` | `string` | `"all"` | Contractor tier filter: `"all"`, `"entry"`, `"intermediate"`, or `"expert"`. |
| `enrichClientDetails` | `boolean` | `false` | Fetch each job's detail page to add client lifetime spend (`$`), hires, rating, country, exact applicant/interview counts & buyer last-active time (`job-detail` tier). |
| `minClientSpendUsd` | `integer` | `0` | Minimum client lifetime Upwork spend in USD (applied when `enrichClientDetails: true` or scraping `jobUrls`). |
| `maxJobsPerQuery` | `integer` | `10` | Maximum jobs collected per keyword or search URL (`1`–`200`). |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Managed automatically via Apify Proxy. |

**Copy-paste input recipes:**

- **High-ticket agency lead radar (`$10K+` verified client spend, newest first):**
  `{"queries":["ai agent","rag pipeline","langchain"],"sortBy":"recency","experienceLevel":"expert","enrichClientDetails":true,"minClientSpendUsd":10000,"maxJobsPerQuery":15}`
- **Ultra-fast RSS replacement across 5 dev stacks (`$2.50 / 1K` search tier):**
  `{"queries":["nextjs","supabase","python fastapi","playwright","cloudflare workers"],"sortBy":"recency","enrichClientDetails":false,"maxJobsPerQuery":20}`
- **Pre-bid Connect audit on specific `jobUrls`:**
  `{"queries":[],"jobUrls":["https://www.upwork.com/freelance-jobs/apply/ChatGPT-Data-Export-and-Google-Drive-Backup-Specialist_~022120901278311801968/"]}`

### 📤 Output Schema & Real Sample Record

Each item includes `rowType` (`"job"` or free diagnostic `"status"`), `clientDetailsEnriched` (`boolean`), and deterministic `rowKey` (`upwork:job:<jobUid>`).

| Field Group | Fields (51 Columns Total) |
|---|---|
| **Job Identity & Timing** | `rowKey`, `rowType`, `jobUid`, `ciphertext`, `title`, `description`, `url`, `searchQuery`, `createdAt`, `publishedAt`, `renewedAt`, `scrapedAt` |
| **Budget & Contract Scope** | `contractType` (`HOURLY` / `FIXED`), `fixedBudgetUsd`, `hourlyBudgetMin`, `hourlyBudgetMax`, `currency`, `experienceLevel`, `durationLabel`, `workload`, `isContractToHire`, `isEnterpriseJob`, `isFeatured`, `freelancersToHire` |
| **Taxonomy & Qualifications** | `skills[]`, `category`, `categoryGroup`, `minJobSuccessScore` *(detail)*, `risingTalentAccepted` *(detail)* |
| **Proposal & Buyer Activity** *(detail)* | `proposalsTier`, `totalApplicants`, `totalInvitedToInterview`, `invitationsSent`, `unansweredInvites`, `totalHired`, `lastBuyerActivity` |
| **Client Spend & Firmographics** *(detail)* | `clientDetailsEnriched`, `clientPaymentVerified`, `clientTotalSpentUsd`, `clientTotalHires`, `clientActiveContracts`, `clientTotalHours`, `clientEffectiveHourlyRateUsd`, `clientScore`, `clientFeedbackCount`, `clientCountry`, `clientCity`, `clientTimezone`, `clientMemberSince`, `clientCompanySize`, `clientIndustry` |

#### Real sample record (from verified platform pre-publish run `7SdELvBM1RyNkT0pd`, 2026-11-14)

```json
{
  "rowType": "job",
  "rowKey": "upwork:job:2120901278311801968",
  "jobUid": "2120901278311801968",
  "ciphertext": "~022120901278311801968",
  "title": "ChatGPT Data Export and Google Drive Backup Specialist",
  "description": "I am looking for an experienced IT specialist or Python developer to help me back up and organize several years of ChatGPT work...",
  "url": "https://www.upwork.com/freelance-jobs/apply/ChatGPT-Data-Export-and-Google-Drive-Backup-Specialist_~022120901278311801968/",
  "contractType": "FIXED",
  "fixedBudgetUsd": 150,
  "hourlyBudgetMin": null,
  "hourlyBudgetMax": null,
  "currency": "USD",
  "experienceLevel": "Entry Level",
  "durationLabel": "Less than 1 month",
  "workload": null,
  "skills": [
    "Data Entry",
    "Python",
    "Data Extraction"
  ],
  "category": "Network & System Administration",
  "categoryGroup": "IT & Networking",
  "isFeatured": false,
  "isEnterpriseJob": false,
  "isContractToHire": false,
  "freelancersToHire": 1,
  "createdAt": "2026-11-12T15:27:24.323Z",
  "publishedAt": "2026-11-12T15:28:47.551Z",
  "renewedAt": null,
  "proposalsTier": null,
  "totalApplicants": 15,
  "totalInvitedToInterview": 0,
  "invitationsSent": 0,
  "unansweredInvites": 0,
  "totalHired": 0,
  "lastBuyerActivity": "2026-11-12T15:50:24.437Z",
  "clientPaymentVerified": false,
  "clientTotalSpentUsd": null,
  "clientTotalHires": 0,
  "clientActiveContracts": 0,
  "clientTotalHours": 0,
  "clientEffectiveHourlyRateUsd": null,
  "clientScore": null,
  "clientFeedbackCount": 0,
  "clientCountry": "United States",
  "clientCity": null,
  "clientTimezone": "America/Chicago (UTC-06:00)",
  "clientMemberSince": "2026-11-12T00:00:00.000Z",
  "clientDetailsEnriched": true,
  "scrapedAt": "2026-11-14T05:08:14.112Z"
}
```

Every completed run also writes a `SOURCE_REPORT` telemetry object to the default Key-Value Store.

### 🧪 Data Quality — Measured

Verified on the Apify platform across QA runs (`1VxkcUVQAkRS6D6bs`, `Si4fs4MMmqBzxS6SS`, `oH1zX3qnRu1w5PCbm`) and pre-publish live billing verification (`7SdELvBM1RyNkT0pd` on 2026-11-14):

- **100% job uniqueness across multi-keyword sweeps:** Deduplicated by `upwork:job:<jobUid>` (`0` duplicate postings even when `"ai automation"` and `"n8n"` surface overlapping jobs).
- **51 structured columns with strict `null` discipline:** Search-tier runs (`1VxkcUVQAkRS6D6bs`, `20` jobs) populated `jobUid`, `ciphertext`, `title`, full `description`, `url`, `contractType`, `experienceLevel`, `skills[]` and `publishedAt` at `100%`; enriched runs (`7SdELvBM1RyNkT0pd`, `Si4fs4MMmqBzxS6SS`) populated buyer activity and client firmographics cleanly without fake zeros.
- **Verified two-tier PPE billing:** Settled `chargedEventCounts` across `job`, `job-detail` and empty-input `status` runs matched delivered rows `100%`.

### ⏱️ Performance — Measured

Measured on the Apify platform at the default **`256 MB`** memory tier:

- **8.9 seconds for 20 search jobs:** Platform run `1VxkcUVQAkRS6D6bs` (`queries: ["ai automation", "web scraping"]`, `maxJobsPerQuery: 10`, `enrichClientDetails: false`) finished in **`8.9s`** inside `256 MB` RAM.
- **Restart-idempotent delivery:** Hydrates existing `upwork:job:<jobUid>` keys from the Dataset on startup so container migrations never re-emit or re-bill jobs.

### 💼 Use Cases

1. **Real-Time Agency Speed-to-Lead Alerts (Under 15 Minutes)**
   - *Input:* `{"queries":["ai automation","voice ai","n8n"],"sortBy":"recency","enrichClientDetails":true,"minClientSpendUsd":5000,"maxJobsPerQuery":10}`
   - *Output:* Newly published jobs where `totalHired == 0`, `totalInvitedToInterview == 0` and `clientTotalSpentUsd >= 5000`.
   - *Business action:* Trigger an instant Slack alert + LLM-drafted cover letter while the buyer is still online (`lastBuyerActivity` within the last 10 minutes).

2. **Connect-ROI Optimization Before Bidding**
   - *Input:* Pass candidate `jobUrls` before spending 16–24 Upwork Connects.
   - *Output:* Exact `totalApplicants`, `totalInvitedToInterview`, `totalHired`, `lastBuyerActivity` and `clientEffectiveHourlyRateUsd`.
   - *Business action:* Skip stale jobs where `totalHired >= freelancersToHire` or where the client historically pays `$8/hr` (`clientEffectiveHourlyRateUsd`).

3. **B2B Outbound Buyer-Intent Signal Enrichment**
   - *Input:* `{"queries":["salesforce migration","hubspot revops","snowflake dbt"],"enrichClientDetails":true,"minClientSpendUsd":10000,"maxJobsPerQuery":30}`
   - *Output:* `clientIndustry`, `clientCompanySize`, `clientCountry`, `clientCity`, `clientTimezone` + detailed technical stack pain points in `description`.
   - *Business action:* Spot funded mid-market companies actively budgeting for RevOps/Data migrations in specific US/EU cities.

4. **Freelance Skill Demand & Hourly Rate Benchmarking**
   - *Input:* Weekly scheduled search across 25 tech/creative categories (`enrichClientDetails: false`).
   - *Output:* Volume of postings, `hourlyBudgetMin`/`Max` medians, `fixedBudgetUsd` distributions and co-occurring `skills[]`.
   - *Business action:* Track fastest-growing AI/engineering niches and price agency retainers against real market rates.

### 🔗 Integrations (Node.js, Python, n8n, Make & Clay)

#### JavaScript / Node.js (`apify-client`)

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('foxlabs/upwork-jobs-scraper').call({
    queries: ['ai automation', 'web scraping'],
    sortBy: 'recency',
    enrichClientDetails: true,
    minClientSpendUsd: 2500,
    maxJobsPerQuery: 15,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} qualified Upwork jobs`, items[0]);
```

#### Python (`apify-client` v3)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("foxlabs/upwork-jobs-scraper").call(
    run_input={
        "queries": ["ai automation", "python fastapi"],
        "sortBy": "recency",
        "enrichClientDetails": True,
        "minClientSpendUsd": 2500,
        "maxJobsPerQuery": 15,
    }
)

for item in client.dataset(run.default_dataset_id).iterate_items():
    if item["rowType"] == "job":
        print(item["title"], "| Spend: $", item["clientTotalSpentUsd"], "| Applicants:", item["totalApplicants"])
```

*(Written for `apify-client` v3 where `call()` returns a `Run` object exposing `run.default_dataset_id`; on `apify-client` v1/v2 use `run["defaultDatasetId"]`.)*

#### n8n, Make, Zapier & Clay

- **15-minute Upwork RSS replacement (n8n / Make):** Schedule every 15–30 minutes (`sortBy: "recency"`, `maxJobsPerQuery: 15`), deduplicate by `jobUid` in Google Sheets / Supabase / Redis, and send high-fit jobs to Slack with an OpenAI/Claude proposal draft.
- **Standby synchronous API:** POST to `https://foxlabs--upwork-jobs-scraper.apify.actor/scrape` from custom agentic pipelines or Clay tables.

### 📊 Pricing (Pay-Per-Event)

Mutually exclusive two-tier **Pay-Per-Event (PPE)** billing — pay fast search rates for broad monitoring or detail rates only when enriching full client spend & applicant telemetry:

| Event Name | Trigger | Price per Item | Price per 1,000 |
|---|---|---|---|
| `job` | Once per unique search-tier job record (`enrichClientDetails: false`) | **$0.0025** | **$2.50 / 1,000** |
| `job-detail` | Once per unique client-enriched job record (`enrichClientDetails: true` or `jobUrls`) | **$0.0055** | **$5.50 / 1,000** |
| `status` *(diagnostic)* | Empty input, invalid URL, or zero-match filter note | **$0.00 (Free)** | **$0.00** |

**Worked cost examples:**

- **100 fresh search-tier jobs across 5 keywords (`enrichClientDetails: false`):** `100 × $0.0025` = **$0.25**
- **50 client-enriched agency leads (`enrichClientDetails: true`):** `50 × $0.0055` = **$0.275** *(never billed `job` + `job-detail` together!)*
- **1,000 search-tier jobs for market rate analysis:** `1,000 × $0.0025` = **$2.50**

**Billing guarantees:**

- **Filtered-out low-spend jobs cost $0.00:** When you set `minClientSpendUsd: 5000`, jobs whose clients fall below `$5,000` lifetime spend are dropped before Dataset delivery and **are not charged**.
- **Proxy protection included:** Managed Apify Proxy traffic is included inside the per-event price above.
- **Exact spend cap support:** Configure **Maximum cost per run** in Apify options; `ChargingManager` stops cleanly at your budget cap. *(Note: if Apify applies its platform `apify-actor-start` fee on your plan, that start event applies when a run starts, including zero-result runs.)*

### ❓ Frequently Asked Questions (FAQ)

#### Do I need an Upwork account, OAuth API keys, session cookies, or my own proxies?

No. Upwork requires zero credentials or app approvals from you here. All public job search feeds and job detail pages are collected keylessly on our managed infrastructure with automatic proxy handling — your personal or agency Upwork account is never logged into, exposed, or put at risk.

#### Can this Actor replace Upwork's discontinued RSS / Atom job feeds?

Yes — and with far richer structured fields than Upwork's old RSS ever offered. Set `sortBy: "recency"` on an Apify Schedule (for example every 15 or 30 minutes) and send the Dataset webhook to n8n, Make, Zapier, Slack or Discord. Even at `enrichClientDetails: false` (`$0.0025`/job), you get full untruncated `description` text, exact `hourlyBudgetMin`/`Max` or `fixedBudgetUsd`, `experienceLevel` and structured `skills[]` arrays.

#### What is the exact difference between `enrichClientDetails: false` and `enrichClientDetails: true`?

With `enrichClientDetails: false` (`job` tier, `$2.50 / 1K`), the Actor extracts everything on Upwork's search payload (~10–20 jobs per page in seconds): `jobUid`, `ciphertext`, `title`, full `description`, `url`, `contractType`, `fixedBudgetUsd` / `hourlyBudgetMin`–`Max`, `experienceLevel`, `durationLabel`, `workload`, `skills[]`, `category` and `publishedAt`. Enabling `enrichClientDetails: true` (`job-detail` tier, `$5.50 / 1K`) additionally fetches each posting's detail page to attach `clientTotalSpentUsd`, `clientTotalHires`, `clientEffectiveHourlyRateUsd`, `clientPaymentVerified`, `clientScore`, `clientCountry`/`clientCity`, `clientIndustry`, `clientCompanySize`, exact `totalApplicants`, `totalInvitedToInterview`, `totalHired` and `lastBuyerActivity`.

#### Am I charged for jobs rejected by `minClientSpendUsd`?

No. `minClientSpendUsd` is evaluated inside the pipeline before Dataset delivery. Any posting whose buyer has spent less than your configured USD threshold (or has `null` spend as a brand-new buyer) is discarded cleanly without writing to the Dataset and without triggering a `job-detail` event charge.

#### Why is `clientTotalSpentUsd` `null` on a brand-new client even when `enrichClientDetails: true`?

When a first-time buyer creates a brand-new Upwork account and has `0` completed hires or historical invoices (`clientTotalHires: 0`), Upwork records no historical spend figure (`clientTotalSpentUsd: null`) rather than `$0.00` spent across completed contracts. Keeping `null` distinguishes brand-new unverified buyers (`clientPaymentVerified: false`) from established buyers cleanly.

#### How can I use `searchUrls` to apply advanced Upwork filters not listed as top-level inputs?

Open `https://www.upwork.com/nx/search/jobs/` in your browser, configure any combination of Upwork sidebar filters (such as project length, specific subcategories, client location regions, or proposals `< 5`), copy the browser URL, and paste it into `searchUrls` (setting `"queries": []` if you only want that custom URL). The Actor preserves all query parameters while handling pagination automatically.

#### How do I spot "ghost jobs" where the buyer already hired someone or abandoned the post?

Enable `enrichClientDetails: true` (or pass `jobUrls`) and inspect three fields together: `totalHired` (if `>= freelancersToHire`, the role is already filled), `totalInvitedToInterview` (if `> 5`, the client is already deep in interviews), and `lastBuyerActivity` (shows the exact ISO timestamp when the client last viewed proposals on that job).

#### What happens if the same job matches multiple keywords in `queries`?

In-memory and Dataset-backed `rowKey` deduplication (`upwork:job:<jobUid>`) guarantees that if a posting matches multiple search queries in the same run (for example `"ai automation"`, `"n8n"` and `"python"`), it is written to the Dataset and billed **only once**, keeping your Slack alerts and CRM pipelines completely duplicate-free.

#### Why are `hourlyBudgetMin` and `hourlyBudgetMax` `null` on some `HOURLY` jobs?

Upwork allows clients to post hourly jobs under *"Not sure / Open to freelancer hourly rates"* without specifying a min/max hourly range. In those cases `contractType` is `"HOURLY"` and `hourlyBudgetMin` / `hourlyBudgetMax` are honestly `null` rather than `0`.

#### Can I enrich only specific `jobUrls` without running keyword searches?

Yes. Clear the default Queries in the Console UI or pass `"queries": []` in your JSON input alongside `"jobUrls": ["https://www.upwork.com/freelance-jobs/apply/..."]` (or `/jobs/~02...` URLs). Direct `jobUrls` automatically perform full client financial and applicant activity enrichment (`job-detail` tier).

#### Can AI agents call this Actor autonomously via MCP or Standby HTTP?

Yes. Point Claude, Cursor or your custom agent framework at `https://mcp.apify.com?tools=foxlabs/upwork-jobs-scraper`, or `POST` JSON directly to `https://foxlabs--upwork-jobs-scraper.apify.actor/scrape` in Standby mode for synchronous JSON responses.

#### Does the Actor reveal the private company name or personal email of the Upwork client?

No. Upwork anonymizes buyer identities on job postings by design to enforce platform non-circumvention. The Actor extracts all publicly exposed firmographic signals (`clientCountry`, `clientCity`, `clientTimezone`, `clientIndustry`, `clientCompanySize`, `clientMemberSince`, `clientTotalSpentUsd` and `clientScore`), never private account data.

### 🐛 Troubleshooting

- **Dataset contains only `rowType: "status"` (`EMPTY_INPUT`):** `queries`, `searchUrls` and `jobUrls` were all empty. Add at least one keyword, search URL or job URL.
- **Zero jobs returned when `minClientSpendUsd` is set:** Did you leave `enrichClientDetails: false`? Client spend lives on job detail pages — set `"enrichClientDetails": true` whenever filtering by `minClientSpendUsd > 0`.
- **Default `"ai automation"` and `"web scraping"` ran alongside `searchUrls` or `jobUrls`:** Pass `"queries": []` in JSON input (or clear the prefilled Queries list in Console) when using only URLs.
- **Private / invite-only job URL returned a `status` row:** Invite-only Upwork jobs (`isPrivate`) are hidden from public visitors and cannot be viewed without the invited freelancer's account; public jobs in the same batch still succeed.

### 🚧 What It Does Not Do

- Does **not** log into Upwork accounts, submit proposals, or spend Upwork Connects.
- Does **not** scrape invite-only/private jobs or deanonymize private client contact emails.
- Does **not** scrape freelancer talent profiles (`upwork.com/freelancers/...`).

### ⚠️ Trademark Notice

This Actor is an independent software tool developed by **foXLabs** and is not affiliated with, endorsed by, or sponsored by Upwork Inc. "Upwork" is a registered trademark of Upwork Inc., used strictly to identify compatibility with publicly accessible web pages.

### ⚖️ Is It Legal to Scrape Public Upwork Job Postings?

This Actor reads only publicly accessible job postings and aggregate anonymous buyer statistics visible to unauthenticated visitors — with zero login, zero credential sharing and zero personal freelancer/buyer PII collected. Users are responsible for complying with applicable laws in their jurisdiction.

### 🤝 Support, Custom Data & Contact

- 🌐 **Website & full portfolio:** [data.foxlabs.com.tr](https://data.foxlabs.com.tr)
- 📧 **Custom data & enterprise inquiries:** info@foxlabs.com.tr
- 🐛 **Bug reports & feature requests:** open an issue in the Actor's **Issues** tab on Apify Store (include your Run ID)
- 🧰 **Browse all foXLabs Actors:** [apify.com/foxlabs](https://apify.com/foxlabs)

### Changelog

#### 0.1.2 (2026-11-14)

- Upgraded Store README to full SIÁN standard with MCP & x402 AI agent configuration, Standby HTTP `POST /scrape` examples, verified platform dataset sample & QA metrics, worked PPE cost tables, and expanded 12-question FAQ.

#### 0.1.0 (2026-11-13)

- Initial release of `foxlabs/upwork-jobs-scraper` supporting `queries`, `searchUrls` and `jobUrls`, optional B2B client spend & proposal enrichment (`enrichClientDetails`), `minClientSpendUsd` filtering, and Batch + Standby HTTP modes.

# Changelog

This Actor's version history is a separate document: https://apify.com/foxlabs/upwork-jobs-scraper/changelog.md

# Actor input Schema

## `queries` (type: `array`):

Keywords or skill phrases to search on Upwork (e.g. 'ai automation', 'web scraping', 'nextjs developer').

## `searchUrls` (type: `array`):

Optional direct Upwork search URLs (https://www.upwork.com/nx/search/jobs/?q=...). Custom URL parameters are preserved.

## `jobUrls` (type: `array`):

Optional direct Upwork job URLs (/freelance-jobs/apply/... or /jobs/...) for full client spend & applicant activity extraction.

## `sortBy` (type: `string`):

Sort order for keyword searches.

## `jobType` (type: `string`):

Filter keyword searches by contract billing model.

## `experienceLevel` (type: `string`):

Optional contractor tier filter for keyword searches.

## `enrichClientDetails` (type: `boolean`):

Fetches each job's detail page to add client total spend ($), total hires, feedback score, payment verification, country/city, exact applicant count, interviews, and buyer last-active timestamp. Billed at the job-detail tier.

## `minClientSpendUsd` (type: `integer`):

Optional minimum client lifetime Upwork spend filter (applied when enrichClientDetails is enabled or scraping jobUrls). Set 0 for all.

## `maxJobsPerQuery` (type: `integer`):

Maximum number of Upwork jobs to collect per keyword or search URL.

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

Apify Proxy settings. Automatically uses Apify Unblocker when left on default.

## Actor input object example

```json
{
  "queries": [
    "ai automation",
    "web scraping"
  ],
  "searchUrls": [],
  "jobUrls": [],
  "sortBy": "recency",
  "jobType": "all",
  "experienceLevel": "all",
  "enrichClientDetails": false,
  "minClientSpendUsd": 0,
  "maxJobsPerQuery": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

## `sourceReport` (type: `string`):

No description

# 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 = {
    "queries": [
        "ai automation",
        "web scraping"
    ],
    "maxJobsPerQuery": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/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 = {
    "queries": [
        "ai automation",
        "web scraping",
    ],
    "maxJobsPerQuery": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/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 '{
  "queries": [
    "ai automation",
    "web scraping"
  ],
  "maxJobsPerQuery": 10
}' |
apify call foxlabs/upwork-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/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/zIDl9DyMGjK3ftd4R/builds/8Zteovy49aTKBwo8e/openapi.json
