Freelancer API

Search Freelancer.com projects and pull bids, skills and freelancer profiles as JSON.

The API.SH Freelancer API turns public Freelancer.com pages into structured JSON. Search open projects by keyword, skill, project type, budget, hourly rate and client country, then read a project in full with its budget, bid statistics and, on request, every public bid. Look up freelancer profiles and search the directory by skill, country and hourly rate. Profiles include rating, reviews, jobs completed, completion, on-time and on-budget rates.

Get a free API key Try it in the playground

5 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Freelancer project search

GET https://api.api.sh/freelancer/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Freelancer API

Lead generation for agencies and developers

Search open projects by skill, budget range and client country, sorted by latest, and route fresh matching jobs to your team.

/search /project

Pricing and demand research

Compare budget ranges, average bids and hourly commitments for a skill to price your own services or track what clients pay.

/search /skills

Bid analysis

Add include=bids to a project to see the public bid amounts, delivery days, proposal text and each bidder's rating and completion rates.

/project

Freelancer sourcing

Search the directory by skill, country and hourly rate, then rank candidates by rating, reviews and jobs completed.

/users /user

Skills demand tracking

List skills with their ids and number of active projects, then feed the ids into project search to follow a category over time.

/skills /search

Freelancer data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Freelancer API endpoints and prices

Every Freelancer endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

Freelancer project search /freelancer/v1/search	$1 · $2 PAYG 1 credit
Freelancer directory search /freelancer/v1/users	$1 · $2 PAYG 1 credit

Profiles and accounts1

Freelancer public profile

/freelancer/v1/user

$1 · $2 PAYG

1 credit

Posts and media2

Freelancer project /freelancer/v1/project	$1 · $2 PAYG 1 credit
Freelancer skills /freelancer/v1/skills	$1 · $2 PAYG 1 credit

Call the Freelancer API

Freelancer project search: GET https://api.api.sh/freelancer/v1/search

curl "https://api.api.sh/freelancer/v1/search?q=python" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/freelancer/v1/search",
    params={"q": "python"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/freelancer/v1/search");
url.searchParams.set("q", "python");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/freelancer/v1/search", "q", "python")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Freelancer" and "Freelancer project search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Freelancer data

Public data only: no Freelancer login, cookies or account needed
One key and one response shape for Freelancer and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Freelancer API

Freelancer.com has an official developer platform and SDKs, documented at developers.freelancer.com, and it uses authentication. API.SH needs no developer setup: one key returns public project, bid and profile data in the same JSON format as every other site.

Skip writing and maintaining your own Freelancer.com scraper or paying for a single-site Apify actor: API.SH gives you one key, one JSON shape and a fixed price per 1,000 calls.

Freelancer API questions

What Freelancer data can I get?+

Open project search (/freelancer/v1/search), one project with budget, bid statistics and optional bids (/freelancer/v1/project), skills with ids and active project counts (/freelancer/v1/skills), a public freelancer profile (/freelancer/v1/user) and directory search (/freelancer/v1/users).

How much does the Freelancer API cost?+

Every Freelancer endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /freelancer/v1/project at 1 credit each.

Is there an official Freelancer API?+

Yes. Freelancer.com publishes a developer platform and SDKs at developers.freelancer.com, with authentication. API.SH is a separate option that reads public pages, so you do not set up developer access, and the JSON format matches every other site you query.

Do I need a Freelancer account or login?+

No. API.SH reads public Freelancer pages only. No endpoint uses a login, cookies or anyone's account.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /freelancer/v1/search with q set to a keyword, for example a skill you offer. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Can I see the bids on a project?+

Yes, the public ones. Call /freelancer/v1/project with include=bids and, optionally, bids_limit. You get amount (hidden for sealed bids), delivery days, status and proposal text, plus each bidder's username, country, hourly rate, rating and completion rates.

Can I use the Freelancer API from Python?+

Yes. It is a plain HTTPS API, so requests, the API.SH Python SDK or any HTTP client works. Pass next_page back as page to walk through search and directory results. Output can be JSON, CSV or NDJSON.