Freelancer.com API
The Freelancer.com API returns live freelance projects and profiles as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns projects with id, title, description, type, budget (min, max, currency), skills, status and bid count, and you can pull a project, a user, contests, skills and categories. It is built for freelance tools, market research and lead generation that need Freelancer.com data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/freelancer/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "python",
"limit": 10
}
}{
"ok": true,
"meta": {
"api": "freelancer",
"endpoint": "search",
"mode": "live",
"latency_ms": 827.3,
"record_count": 10,
"bytes": 46225,
"cache_hit": false,
"method": "internal_api_bare_dc_curl_cffi",
"pii_redacted": true,
"stop_reason": "limit_reached"
},
"data": {
"projects": [
{
"id": 40590421,
"source": "freelancer",
"title": "Develop 9-EMA VWAP Bot",
"description": "I need a clean, production-ready Python solution that trades automatically using a simple 9-period EMA + VWAP strategy. The script must:\n\n• Stream live market data, calculate the indicators in real time, and act instantly on the signals it generates. \n• Place, modify, and cancel orders through my broker’s REST API without manual intervention. \n• Run reliably inside an AWS environment (EC2 or Lambda). Environment variables should hold all keys and secrets, and logging must write to CloudWatch for easy monitoring. \n\nPlease structure the code for easy maintenance: clear functions, comments, an",
"preview": "I need a clean, production-ready Python solution that trades automatically using a simple 9-period E",
"type": "fixed",
"budget": {
"type": "fixed",
"min": 1500,
"max": 12500,
"currency": "INR",
"currency_sign": "₹"
},
"skills": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"status": "active",
"frontend_status": "open",
"bids_count": 9,
"bid_avg": 7111.111111111111,
"bid_period_days": 7,
"language": "en",
"featured": false,
"urgent": false,
"nda": false,
"upgrades": [],
"posted_at": 1784394725,
"updated_at": 1784394725,
"client_country": null,
"seo_url": "api/Develop-EMA-VWAP-Bot",
"url": "https://www.freelancer.com/projects/api/Develop-EMA-VWAP-Bot"
},
{
"id": 40590321,
"source": "freelancer",
"title": "Reddit & News Reply MVP",
"description": "I need a lean MVP that automatically hunts for conversations where my web app can be mentioned in a helpful, brand-building way. The workflow is straightforward:\n\n1. Crawler \n • Scan Reddit plus Google News (blogs and articles surfaced). \n • Harvest threads and comments. \n\n2. AI Scoring \n • Rank each conversation primarily on its relevance to the app and the overall popularity of the post or thread. \n • Ignore low-signal chatter; keep only high-potential mentions. \n\n3. Drafting Replies \n • Use an LLM to generate a concise, promotional reply that feels organic and value-adding,",
"preview": "I need a lean MVP that automatically hunts for conversations where my web app can be mentioned in a",
"type": "fixed",
"budget": {
"type": "fixed",
"min": 250,
"max": 750,
"currency": "USD",
"currency_sign": "$"
},
"skills": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"status": "active",
"frontend_status": "open",
"bids_count": 192,
"bid_avg": 443.16052083333335,
"bid_period_days": 7,
"language": "en",
"featured": false,
"urgent": false,
"nda": false,
"upgrades": [],
"posted_at": 1784390096,
"updated_at": 1784390096,
"client_country": null,
"seo_url": "python/Reddit-News-Reply-MVP",
"url": "https://www.freelancer.com/projects/python/Reddit-News-Reply-MVP"
},
{
"id": 40590308,
"source": "freelancer",
"title": "NFL Point Spread Prediction Model",
"description": "I'm seeking an expert in predictive modeling to develop a point spread prediction model for NFL games. This model will be crucial for making informed betting decisions.\n\nKey Requirements:\n- Develop a statistical model to predict point spreads\n- Use historical data and advanced algorithms\n- Provide clear documentation and usage guidelines\n\nIdeal Skills and Experience:\n- Strong background in statistics and machine learning\n- Experience with sports data, especially NFL\n- Proficiency in Python, R, or similar programming languages\n- Ability to deliver within a month",
"preview": "I'm seeking an expert in predictive modeling to develop a point spread prediction model for NFL game",
"type": "fixed",
"budget": {
"type": "fixed",
"min": 30,
"max": 250,
"currency": "USD",
"currency_sign": "$"
},
"skills": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"status": "active",
"frontend_status": "open",
"bids_count": 71,
"bid_avg": 125.98591549295774,
"bid_period_days": 7,
"language": "en",
"featured": false,
"urgent": false,
"nda": false,
"upgrades": [],
"posted_at": 1784389329,
"updated_at": 1784389329,
"client_country": null,
"seo_url": "data-science/NFL-Point-Spread-Prediction-Model",
"url": "https://www.freelancer.com/projects/data-science/NFL-Point-Spread-Prediction-Model"
}
],
"total_count": 159,
"returned": 10,
"offset": 0,
"source": "freelancer"
}
}What the Freelancer.com API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search live freelance PROJECTS on Freelancer.com by keyword, skills, category, budget/hourly band, freshness, country, and language; sorted by recency, bids, or bid-deadline. Returns title, description, budget{type,min,max,currency}, skills[], bids_count (proposals), posted_at, client_country, and url. No client PII. | Recruiting teams call search to search live freelance PROJECTS on Freelancer.com by keyword, skills, category, budget/hourly…. | query, skills, category, project_types, budget_min, ... |
| project | Full detail for one Freelancer.com project by numeric id, project URL, or SEO slug — everything from `search` plus hourly-commitment, timeframe, qualifications, escrow status and selected-bid count. No client PII. | Labor-market analysts call project to get full detail for one Freelancer.com project by numeric id, project URL, or SEO slug. | id |
| user | PUBLIC business profile of a Freelancer.com freelancer or employer by username/handle or id: display name, country, role, hourly rate, reputation (rating/reviews/completion/repeat-hire), skills, membership, badges, portfolio and registration year. PII (email/phone/legal-name/address) is NEVER returned. | Job boards call user to get pUBLIC business profile of a Freelancer.com freelancer or employer by username/handle or id. | username |
| contests | Browse live OPEN Freelancer.com design/creative CONTESTS (accepting entries) — prize, currency, entry count, skills, and deadlines. Filter by keyword and skills. | Sales intelligence teams call contests to get browse live OPEN Freelancer.com design/creative CONTESTS (accepting entries). | query, skills, limit, offset |
| skills | Resolve a skill name to Freelancer.com skill id(s) (for search's `skills` filter), or list the most-popular skills with their active-project counts — the marketplace's skill taxonomy. | Recruiting teams call skills to resolve a skill name to Freelancer.com skill id(s) (for search's `skills` filter), or list th…. | query, limit |
| categories | List the top-level Freelancer.com job categories (Websites/IT, Design, Writing, Mobile…) with their active-project counts — the browse taxonomy for scoping a search. | Labor-market analysts call categories to list the top-level Freelancer.com job categories (Websites/IT, Design, Writing, Mobile…) with…. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/freelancer/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"python","limit":10}'import requests
r = requests.post(
"https://api.reefapi.com/freelancer/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "python",
"limit": 10
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/freelancer/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "python",
"limit": 10
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.freelancer.search with {"query":"python","limit":10}.Who uses this API and why
- Freelance tools call search to surface new projects matching a user's skills and budget.
- Market researchers use categories and search to size demand and rates for a skill.
- Lead-gen products use project and user to find clients posting relevant work.
Questions developers ask before integrating
What is the Freelancer.com API?
Freelancer.com API is a ReefAPI endpoint group for freelancer.com It returns live JSON through POST requests under /freelancer/v1.
Is the Freelancer.com API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Freelancer.com calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Freelancer.com login or account?
No login to Freelancer.com is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Freelancer.com data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Freelancer.com API use?
Freelancer.com actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Freelancer.com from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call freelancer actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Freelancer.com API a Freelancer.com scraper?
It is the managed alternative to a DIY Freelancer.com scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same freelancer.com back as clean JSON.
Why does my Freelancer.com scraper keep getting blocked?
Most Freelancer.com scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.