Upwork Jobs Scraper — Budgets, Client Spend & Proposals
Pricing
from $2.50 / 1,000 upwork job listings
Upwork Jobs Scraper — Budgets, Client Spend & Proposals
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.
Pricing
from $2.50 / 1,000 upwork job listings
Rating
0.0
(0)
Developer
Berkan Kaplan
Maintained by CommunityActor stats
0
Bookmarked
3
Total users
2
Monthly active users
3 days ago
Last modified
Categories
Features
Share
Upwork Jobs Scraper — Budgets, Client Spend & Proposals 🚀
foXLabs Jobs, Freelance & B2B Lead Intelligence Series: SEEK Jobs Scraper · Whop Marketplace Scraper · Skool Community Scraper · Shopify App Store Scraper · Yelp Business Leads 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 (
jobvs.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 addclientTotalSpentUsd,clientTotalHires,clientEffectiveHourlyRateUsd,clientPaymentVerified,clientScore,clientCountry/clientCity,clientCompanySize,clientIndustry, exacttotalApplicants,totalInvitedToInterview,totalHiredandlastBuyerActivity. - 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 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):
{"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:
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 automationjobs on Upwork from verified clients with at least$5,000lifetime spend and fewer than10applicants (totalInvitedToInterview == 0), and rank the best 5 to pitch." - "Compare hourly budget ranges (
hourlyBudgetMin–hourlyBudgetMax) acrossnextjs,pythonandrustUpwork postings today." - "Inspect these 3 direct Upwork
jobUrlsand checklastBuyerActivity,totalHired,clientEffectiveHourlyRateUsdandclientScorebefore 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 exactclientTotalSpentUsd,clientTotalHires,clientTotalHours,clientEffectiveHourlyRateUsd,clientPaymentVerifiedandclientScorebefore spending a single Connect. - 👀 Live proposal & buyer-activity telemetry — know exact
totalApplicants,totalInvitedToInterview,invitationsSent,unansweredInvites,totalHiredandlastBuyerActivity(avoiding dead jobs where the client already hired or went ghost). - ⚡ Sub-10-second RSS replacement — default
enrichClientDetails: falsemode 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 ofjob($0.0025), never both. - 🛡️ Strict
nullintegrity — hourly jobs emitfixedBudgetUsd: nulland fixed-price jobs emithourlyBudgetMin: null/hourlyBudgetMax: null(never fake0s).
✨ 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,clientCompanySizeand filters automatically viaminClientSpendUsd. - 📋 Complete Scope & Contract Metadata — Extracts full
description,contractType(HOURLY/FIXED),fixedBudgetUsd,hourlyBudgetMin/Max,experienceLevel,durationLabel,workload,skills[],category,categoryGroup,isContractToHire,isEnterpriseJobandfreelancersToHire. - 🔌 Real-Time Standby HTTP Server — Call
POST /scrapesynchronously from n8n, Make, Clay or Slack/Discord proposal-drafting bots.
🎬 Quick Start (API & Standby HTTP)
1. Synchronous Batch API call (returns JSON array directly):
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):
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)
- 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. - Choose contract filters & buyer enrichment — Pick
sortBy,jobType,experienceLevel, and enableenrichClientDetails: true(+ optionalminClientSpendUsd) if you want full client spend & applicant counts. - 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
{"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 / 1Ksearch 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)
{"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>(0duplicate postings even when"ai automation"and"n8n"surface overlapping jobs). - 51 structured columns with strict
nulldiscipline: Search-tier runs (1VxkcUVQAkRS6D6bs,20jobs) populatedjobUid,ciphertext,title, fulldescription,url,contractType,experienceLevel,skills[]andpublishedAtat100%; enriched runs (7SdELvBM1RyNkT0pd,Si4fs4MMmqBzxS6SS) populated buyer activity and client firmographics cleanly without fake zeros. - Verified two-tier PPE billing: Settled
chargedEventCountsacrossjob,job-detailand empty-inputstatusruns matched delivered rows100%.
⏱️ 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 in8.9sinside256 MBRAM. - 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
-
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 == 0andclientTotalSpentUsd >= 5000. - Business action: Trigger an instant Slack alert + LLM-drafted cover letter while the buyer is still online (
lastBuyerActivitywithin the last 10 minutes).
- Input:
-
Connect-ROI Optimization Before Bidding
- Input: Pass candidate
jobUrlsbefore spending 16–24 Upwork Connects. - Output: Exact
totalApplicants,totalInvitedToInterview,totalHired,lastBuyerActivityandclientEffectiveHourlyRateUsd. - Business action: Skip stale jobs where
totalHired >= freelancersToHireor where the client historically pays$8/hr(clientEffectiveHourlyRateUsd).
- Input: Pass candidate
-
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 indescription. - Business action: Spot funded mid-market companies actively budgeting for RevOps/Data migrations in specific US/EU cities.
- Input:
-
Freelance Skill Demand & Hourly Rate Benchmarking
- Input: Weekly scheduled search across 25 tech/creative categories (
enrichClientDetails: false). - Output: Volume of postings,
hourlyBudgetMin/Maxmedians,fixedBudgetUsddistributions and co-occurringskills[]. - Business action: Track fastest-growing AI/engineering niches and price agency retainers against real market rates.
- Input: Weekly scheduled search across 25 tech/creative categories (
🔗 Integrations (Node.js, Python, n8n, Make & Clay)
JavaScript / Node.js (apify-client)
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)
import osfrom apify_client import ApifyClientclient = 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 byjobUidin 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/scrapefrom 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 billedjob+job-detailtogether!) - 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,000lifetime 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;
ChargingManagerstops cleanly at your budget cap. (Note: if Apify applies its platformapify-actor-startfee 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,searchUrlsandjobUrlswere all empty. Add at least one keyword, search URL or job URL. - Zero jobs returned when
minClientSpendUsdis set: Did you leaveenrichClientDetails: false? Client spend lives on job detail pages — set"enrichClientDetails": truewhenever filtering byminClientSpendUsd > 0. - Default
"ai automation"and"web scraping"ran alongsidesearchUrlsorjobUrls: Pass"queries": []in JSON input (or clear the prefilled Queries list in Console) when using only URLs. - Private / invite-only job URL returned a
statusrow: 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
- 📧 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
Changelog
0.1.2 (2026-11-14)
- Upgraded Store README to full SIÁN standard with MCP & x402 AI agent configuration, Standby HTTP
POST /scrapeexamples, 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-scrapersupportingqueries,searchUrlsandjobUrls, optional B2B client spend & proposal enrichment (enrichClientDetails),minClientSpendUsdfiltering, and Batch + Standby HTTP modes.