Jobs & Hiring

Freelancer.com API

The Freelancer.com API returns live freelance projects and profiles as clean JSON.

6 actionsLive JSON1,000 free creditsMCP-ready
Get a free keyOpen in playground

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

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "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
  }
}
Captured response
{
  "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"
  }
}
Actions

What the Freelancer.com API does

ActionDescriptionConcrete use caseKey params
searchSearch 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, ...
projectFull 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
userPUBLIC 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
contestsBrowse 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
skillsResolve 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
categoriesList 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
Code samples

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}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.freelancer.search with {"query":"python","limit":10}.
Use cases

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

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.

docs / freelancer

Freelancer.com

Freelancer.com

base /freelancer/v16 endpoints
post/freelancer/v1/project1 credit

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.

ParameterAllowed / rangeDescription
idrequiredThe project to fetch: a numeric project id (40505996), a project URL (https://www.freelancer.com/projects/<slug>), or the SEO slug itself.
Try in playground →
post/freelancer/v1/user1 credit

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.

ParameterAllowed / rangeDescription
usernamerequiredThe freelancer/employer to fetch: a Freelancer username (fmsiddique) or a numeric user id. Returns the PUBLIC business profile only — no email / phone / legal-name / address (those are never returned).
Try in playground →
post/freelancer/v1/contests1 credit

Browse live OPEN Freelancer.com design/creative CONTESTS (accepting entries) — prize, currency, entry count, skills, and deadlines. Filter by keyword and skills.

ParameterAllowed / rangeDescription
queryoptionalKeyword to match in the project title/description — e.g. 'logo design', 'React developer', 'mobile app'. Omit to browse the newest projects.
skillsoptionalFilter to projects requiring these skill IDs (use the `skills` action to resolve a skill name → id, e.g. 'PHP'→13). Multiple = OR.
limit = 20optional1–50How many contests to return (1–50).
offset = 0optional0–5000Pagination offset (0–5000); skip this many results before returning `limit`.
Try in playground →
post/freelancer/v1/skills1 credit

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.

ParameterAllowed / rangeDescription
queryoptionalSkill name (or fragment) to resolve to Freelancer skill id(s) you can feed to search's `skills` filter (e.g. 'php' → {id:13,name:'PHP'}). Omit to list the most-popular skills.
limit = 60optional1–200Max skills to return (1–200, default 60).
Try in playground →
post/freelancer/v1/categories1 credit

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.

Try in playground →