Freelancer.com Scraper

Extract project listings from Freelancer.com — the world's largest freelance marketplace with 6,700+ active projects posted across every category. Filter by keyword, skill, category, budget, language, or date. No API key, no proxy, and no account required.

---

Why this scraper?

🌍 Full platform coverage — all 100+ categories

Scrapes every active project across all categories: IT & Software, Design, Writing, Engineering, Sales, Trades & Services, AI, and more. No category is off-limits.

🔍 Richest output in its class

Returns 28+ structured fields per project — including bid count, average bid, bidding deadline, sealed/NDA/IP-contract flags, escrow status, hourly commitment, duration, skill categories, and more. Competitors return 8–12 fields.

💸 Cheapest option — no proxy overhead

The platform's public API works directly from datacenter IPs. No residential proxy costs are passed through — ever. Our competitors explicitly warn users to purchase proxies separately.

⚡ Fast — 1,000 projects in ~5 minutes

Retrieves 100 projects per request with no browser required. Scales to the full platform (6,700+ projects) in under 35 minutes.

🔄 Daily feed ready

Built-in cross-run deduplication with a 90-day fingerprint cache. Run on a schedule with daysOld: 1 + skipReposts: true to receive only new projects daily.

🛡️ Self-healing architecture

Automatic retry with exponential backoff, circuit breaker, and per-run health monitoring. Every run writes HEALTH and OUTPUT keys to the key-value store.

---

Input parameters

Parameter	Type	Default	Description
searchQuery	String	""	Keyword(s) to search across project titles and descriptions
jobIds	Array	[]	Skill IDs to filter by (e.g. [190] for Automotive, [7] for JavaScript). Empty = all skills
categoryIds	Array	[]	Category IDs (e.g. [5] for Engineering & Science). Empty = all categories
projectType	String	"all"	"all", "fixed", or "hourly"
budgetMin	Integer	—	Only include projects with a budget ≥ this value (project's native currency)
budgetMax	Integer	—	Only include projects with a budget ≤ this value
languages	Array	[]	Language filter (e.g. ["en"], ["en","de"]). Empty = all languages
maxResults	Integer	100	Maximum number of projects to return
fetchDetails	Boolean	false	Fetch full description and owner location per project (one extra API call per project)
daysOld	Integer	0	Only return projects posted within N days. 0 = no date filter
skipReposts	Boolean	false	Skip projects already seen in previous runs (90-day cache)
startUrls	Array	[]	Specific Freelancer.com search or category URLs to scrape
requestDelayMs	Integer	500	Delay between API requests in milliseconds
respectRobotsTxt	Boolean	true	Apply crawl-delay from robots.txt if present

Skill ID reference (common values)

ID	Skill	Category
3	PHP	IT & Software
7	JavaScript	IT & Software
17	Website Design	IT & Software
20	Graphic Design	Design
21	Copywriting	Writing
26	Python	IT & Software
38	SEO	IT & Software
64	Sales	Sales & Marketing
190	Automotive	Engineering & Science
844	Machine Learning	IT & Software
1023	Digital Marketing	IT & Software
2228	Automotive Engineering	Engineering & Science

Category ID reference

ID	Category
1	Websites, IT & Software
2	Writing & Content
3	Design, Media & Architecture
4	Data Entry & Admin
5	Engineering & Science
6	Sales & Marketing
7	Business, Accounting, HR & Legal
8	Product Sourcing & Manufacturing
9	Mobile Phones & Computing
10	Translation & Languages
12	Trades & Services
100	Freight, Shipping & Transportation
104	Artificial Intelligence

---

Output schema

Always present

Field	Type	Description
id	Number	Freelancer.com project ID
title	String	Project title
url	String	Full URL to the project page
type	String	"fixed" or "hourly"
subStatus	String	Platform sub-status (null if not set)
budgetMin	Number	Minimum budget in the project's currency (null if not set)
budgetMax	Number	Maximum budget in the project's currency (null if not set)
currency	String	ISO currency code (USD, EUR, AUD, GBP, INR, etc.)
hourlyCommitmentHours	Number	For hourly projects: required hours per week (null if fixed)
hourlyCommitmentInterval	String	For hourly projects: commitment period ("week", null if fixed)
hourlyDuration	String	For hourly projects: duration classification (e.g. "unspecified", null if fixed)
skills	Array	Skill/job names attached to the project
skillCategories	Array	Unique top-level category names across all attached skills (e.g. ["Websites, IT & Software", "Mobile Phones & Computing"])
category	String	Primary category name (from the first attached skill)
previewDescription	String	~200-character description snippet
bidCount	Number	Number of bids placed on this project
bidAvg	Number	Average bid amount (null if no bids yet)
bidPeriodDays	Number	How many days the bidding window is open (typically 7)
biddingDeadline	String	ISO 8601 timestamp when bidding closes
postedAt	String	ISO 8601 posting timestamp
updatedAt	String	ISO 8601 last-updated timestamp
language	String	Project language code ("en", "de", "es", etc.)
frontendStatus	String	Display status as shown on the platform
isRepost	Boolean	true if this is a reposted project (accurate only with fetchDetails: true)
isFeatured	Boolean	true if the project has the Featured upgrade
isUrgent	Boolean	true if the project has the Urgent upgrade
isSealed	Boolean	true if bids are hidden from other bidders
isNDA	Boolean	true if an NDA is required to bid
isQualified	Boolean	true if only verified freelancers may bid
isIPContract	Boolean	true if an IP ownership contract is required
isEscrow	Boolean	true if payment is held in escrow
isBuyerKYCRequired	Boolean	true if the buyer must complete identity verification
isSellerKYCRequired	Boolean	true if bidders must complete identity verification
isHireMe	Boolean	true if this is a direct hire / HireMe project
isLocal	Boolean	true if the project requires in-person work
changeStatus	String	"NEW" or "SEEN" (when skipReposts: true)
contentHash	String	12-character MD5 fingerprint for cross-run deduplication

With fetchDetails: true

Field	Type	Description
description	String	Full project description text
countryCode	String	ISO country code of the project owner (null if not disclosed)
city	String	City of the project owner (null if not disclosed)
isRepost	Boolean	Accurate repost flag (fetched from detail endpoint)

Example output record

{
  "id": 40411253,
  "title": "Build a React dashboard for logistics tracking",
  "url": "https://www.freelancer.com/projects/javascript/Build-React-dashboard-logistics",
  "type": "fixed",
  "subStatus": null,
  "budgetMin": 250,
  "budgetMax": 750,
  "currency": "USD",
  "hourlyCommitmentHours": null,
  "hourlyCommitmentInterval": null,
  "hourlyDuration": null,
  "skills": ["React.js", "JavaScript", "Node.js", "API"],
  "skillCategories": ["Websites, IT & Software"],
  "category": "Websites, IT & Software",
  "previewDescription": "We need a React dashboard for real-time shipment tracking from our logistics API...",
  "bidCount": 18,
  "bidAvg": 487.50,
  "bidPeriodDays": 7,
  "biddingDeadline": "2026-05-08T08:34:21.000Z",
  "postedAt": "2026-05-01T08:34:21.000Z",
  "updatedAt": "2026-05-01T08:34:21.000Z",
  "language": "en",
  "frontendStatus": "open",
  "isRepost": false,
  "isFeatured": false,
  "isUrgent": true,
  "isSealed": false,
  "isNDA": false,
  "isQualified": false,
  "isIPContract": false,
  "isEscrow": false,
  "isBuyerKYCRequired": false,
  "isSellerKYCRequired": false,
  "isHireMe": false,
  "isLocal": false,
  "changeStatus": "NEW",
  "contentHash": "a3f1c8e2d094"
}

Hourly project example (new fields):

{
  "type": "hourly",
  "hourlyCommitmentHours": 40,
  "hourlyCommitmentInterval": "week",
  "hourlyDuration": "unspecified",
  "skillCategories": ["Websites, IT & Software", "Mobile Phones & Computing"]
}

---

Examples

All new projects from the last 24 hours (daily feed):

{
  "daysOld": 1,
  "skipReposts": true,
  "maxResults": 500
}

Fixed-price web design projects under $500:

{
  "searchQuery": "landing page",
  "projectType": "fixed",
  "budgetMax": 500,
  "maxResults": 100
}

Hourly IT projects with full descriptions:

{
  "categoryIds": [1],
  "projectType": "hourly",
  "languages": ["en"],
  "fetchDetails": true,
  "maxResults": 50
}

Automotive engineering projects — all types:

{
  "jobIds": [190, 2228],
  "maxResults": 100,
  "fetchDetails": true
}

---

💰 Pricing

$0.99 per 1,000 results — you only pay for successfully retrieved projects. Failed retries and filtered duplicates are never charged.

Results	Cost
100	~$0.10
1,000	~$0.99
10,000	~$9.90
100,000	~$99.00

Competing actors charge $1.00–$5.00 per 1,000 results and require you to pay for residential proxies on top. This actor needs no proxy.

---

Performance

Mode	Items	Approximate time
fetchDetails: false	1,000	~5–6 min
fetchDetails: false	Full platform (6,700+)	~30–35 min
fetchDetails: true	500	~10–15 min

---

Known limitations

• Projects marked nonpublic (client-hidden) are excluded by the platform
• Budget amounts are in the project's native currency — no conversion
• Owner country/city only available with fetchDetails: true and only if the owner has disclosed them
• isRepost is reliably populated only with fetchDetails: true (the list endpoint does not expose repost metadata for anonymous requests)
• The platform has ~6,700–7,000 active projects at any given time

---

Additional services

Need a custom actor, additional filters, scheduled runs, or integration support? Send an email to info@unfencedgroup.nl — we build on request.

---

Part of the Unfenced Group scraper portfolio — 100+ platforms covered. Built by unfenced-group · Issues? Open a ticket or send a message.