docs / freelancer

Freelancer.com API scraper

base /freelancer/v16 endpoints

post/freelancer/v1/search1 credit

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.

Parameter		Allowed / range	Description
query	optional	—	Keyword to match in the project title/description — e.g. 'logo design', 'React developer', 'mobile app'. Omit to browse the newest projects.
skills	optional	—	Filter to projects requiring these skill IDs (use the `skills` action to resolve a skill name → id, e.g. 'PHP'→13). Multiple = OR.
category	optional	—	Top-level category SEO slug to scope the search (see the `categories` action for the full list, e.g. 'design-media-architecture').
project_types	optional	fixed · hourly	Restrict to 'fixed' (fixed-price) and/or 'hourly' projects. Omit for both.
budget_min	optional	0–	Minimum average project budget (in the project's own currency). For hourly projects this is the hourly-rate floor.
budget_max	optional	0–	Maximum average project budget (project currency). Pair with budget_min.
posted_within	optional	1h · 24h · 3d · 7d · 30d	Only projects posted within this window (server-side from_time filter). Great for a fresh-leads feed.
countries	optional	—	Filter by project country name(s) (e.g. 'United States', 'United Kingdom'). Multiple = OR. (Unauthenticated: client identity is not exposed — only the project's listed country is used.)
languages	optional	—	Filter by the project's language code(s) (ISO-639, e.g. 'en', 'es').
sort = time_updated	optional	time_updated · time_submitted · bid_count · bid_enddate	Result ordering.
limit = 30	optional	1–100	How many projects to return (1–100). Use `offset` to page.
offset = 0	optional	0–5000	Pagination offset (0–5000); skip this many results before returning `limit`.

Try in playground →

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.

Parameter		Allowed / range	Description
id	required	—	The 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.

Parameter		Allowed / range	Description
username	required	—	The 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.

Parameter		Allowed / range	Description
query	optional	—	Keyword to match in the project title/description — e.g. 'logo design', 'React developer', 'mobile app'. Omit to browse the newest projects.
skills	optional	—	Filter to projects requiring these skill IDs (use the `skills` action to resolve a skill name → id, e.g. 'PHP'→13). Multiple = OR.
limit = 20	optional	1–50	How many contests to return (1–50).
offset = 0	optional	0–5000	Pagination 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.

Parameter		Allowed / range	Description
query	optional	—	Skill 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 = 60	optional	1–200	Max 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 →

Example request · search

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}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}