💼 Upwork Freelance Jobs & Projects Scraper

High-yield, HTTP-only reverse-engineered scraper for Upwork freelance jobs, projects, and client intelligence. Extracts job titles, full descriptions, budgets, hourly rate ranges, required skills, proposal counts, and client hiring history with zero browser overhead and minimal memory consumption (< 256MB).

---

⚡ Key Features

• Blazing Fast HTTP Extraction: Direct HTTP extraction powered by curl_cffi with Chrome 124 TLS (JA3/JA4) fingerprinting and HTTP/2 framing.
• Client Intelligence: Extracts valuable client data including feedback rating, total spend ($ spent), total past hires count, verification status, and country.
• Dual Pipeline Architecture:
  • Pipeline A (GraphQL Engine): Optional direct high-speed GraphQL querying when a masterAccessToken cookie is provided.
  • Pipeline B (HTTP Residential Pipeline): Automated web search scraping using Apify Residential Proxy (US) to bypass Cloudflare Managed Challenges without requiring a login.
• Rich Filtering: Filter by search keywords, contract types (Hourly / Fixed), rate ranges ($/hr and fixed budget), experience levels (Entry, Intermediate, Expert), and payment verification.
• Pay-Per-Event (PPE) Ready: Extremely cost-efficient execution with negligible platform usage, perfect for competitive marketplace pricing.

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
queries	Array of Strings	No	["python"]	List of keywords or job titles to search on Upwork.
sort	String (Select)	No	"recency"	Result ordering: "recency" (Newest first) or "relevance".
jobType	String (Select)	No	"all"	Filter by contract type: "all", "hourly", or "fixed".
hourlyMin	Integer	No	None	Minimum hourly rate in USD (e.g. 25).
hourlyMax	Integer	No	None	Maximum hourly rate in USD (e.g. 100).
fixedMin	Integer	No	None	Minimum fixed budget in USD (e.g. 500).
fixedMax	Integer	No	None	Maximum fixed budget in USD (e.g. 5000).
experienceLevel	Array	No	[]	Filter by ["entry", "intermediate", "expert"].
paymentVerifiedOnly	Boolean	No	false	Only return jobs from clients with verified payment methods.
masterAccessToken	String	No	None	Optional Upwork session token (master_access_token cookie) for direct GraphQL querying.
maxItems	Integer	No	50	Maximum number of job postings to scrape.
proxyConfiguration	Object	No	{"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US"}	Proxy configuration (Apify Residential Proxy US strongly recommended).

---

📤 Output Schema Example

Each dataset item pushed to the default Apify Dataset matches the following JSON structure:

{
  "id": "~01a2b3c4d5e6f7g8",
  "title": "Senior Python & AI Agent Engineer Needed",
  "description": "We are seeking an experienced Python engineer to develop autonomous LangGraph/LlamaIndex agents with tool-calling capabilities...",
  "url": "https://www.upwork.com/jobs/~01a2b3c4d5e6f7g8",
  "jobType": "Hourly",
  "budget": "$45.00 - $80.00 / hr",
  "hourlyBudgetMin": 45.0,
  "hourlyBudgetMax": 80.0,
  "fixedPrice": null,
  "currency": "USD",
  "experienceLevel": "Expert",
  "duration": "1 to 3 months",
  "workload": "Less than 30 hrs/week",
  "skills": [
    "Python",
    "FastAPI",
    "Artificial Intelligence",
    "Web Scraping",
    "API Development"
  ],
  "category": "Software Development",
  "subcategory": "Back-End Development",
  "clientCountry": "United States",
  "clientCity": "San Francisco",
  "clientRating": 4.95,
  "clientReviewsCount": 38,
  "clientTotalSpent": "$40K+",
  "clientTotalHires": 25,
  "clientPaymentVerified": true,
  "proposalsTier": "5 to 10",
  "publishedDate": "2026-09-06T14:30:00Z",
  "scrapedAt": "2026-09-06T15:15:00.000000+00:00"
}

---

🚀 Use Cases

1. Freelancer Job Hunting: Monitor high-ticket freelance gigs within minutes of posting and receive instant alerts.
2. Talent & Recruitment Intel: Analyze competitive salary/hourly rate trends and demand for specific technology stacks.
3. Lead Generation: Identify high-spending corporate clients hiring for recurring enterprise software projects.