Jobs & Hiring

Truelancer.com API

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

3 actionsLive JSON1,000 free creditsMCP-ready

🤖 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, category and bid count, and you can pull a project and a user. It is built for freelance tools, market research and lead generation that need Truelancer 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 Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/truelancer/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "design",
    "limit": 8
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "truelancer",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2027.4,
    "record_count": 8,
    "bytes": 277014,
    "cache_hit": false,
    "method": "next_data_bare_dc",
    "pii_redacted": true,
    "stop_reason": "limit_reached"
  },
  "data": {
    "projects": [
      {
        "id": 651287,
        "source": "truelancer",
        "title": "3D Rhino Lamp Design for Study Room",
        "description": "Saya memerlukan seorang pereka 3D yang mahir menggunakan Rhino untuk mereka bentuk lampu khas untuk bilik belajar.Reka bentuk akan diberikan kemudian untuk dija...",
        "preview": "Saya memerlukan seorang pereka 3D yang mahir menggunakan Rhino untuk mereka bentuk lampu khas untuk bilik belajar.Reka bentuk akan diberikan kemudian untuk dija...",
        "type": "fixed",
        "budget": {
          "type": "fixed",
          "min": 20,
          "max": 20,
          "currency": "USD"
        },
        "skills": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "category": null,
        "status": "Active",
        "bids_count": 4,
        "posted_at": 1784390446,
        "client_country": null,
        "client": null,
        "featured": true,
        "urgent": false,
        "nda": false,
        "url": "https://www.truelancer.com/freelance-project/3d-rhino-lamp-design-for-study-room-651287",
        "seo_url": "https://www.truelancer.com/freelance-project/3d-rhino-lamp-design-for-study-room-651287"
      },
      {
        "id": 651231,
        "source": "truelancer",
        "title": "Junior Architect for FarmHouse Project Drawings",
        "description": "We are seeking a Junior Architect to assist with our FarmHouse project. The ideal candidate will be responsible for conducting site visits and providing detaile...",
        "preview": "We are seeking a Junior Architect to assist with our FarmHouse project. The ideal candidate will be responsible for conducting site visits and providing detaile...",
        "type": "fixed",
        "budget": {
          "type": "fixed",
          "min": 2500,
          "max": 2500,
          "currency": "USD"
        },
        "skills": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "category": null,
        "status": "Active",
        "bids_count": 7,
        "posted_at": 1784359311,
        "client_country": null,
        "client": null,
        "featured": false,
        "urgent": false,
        "nda": false,
        "url": "https://www.truelancer.com/freelance-project/junior-architect-for-farmhouse-project-drawings-651231",
        "seo_url": "https://www.truelancer.com/freelance-project/junior-architect-for-farmhouse-project-drawings-651231"
      },
      {
        "id": 650939,
        "source": "truelancer",
        "title": "Packing Design For E   commerce Platform Development",
        "description": "We are looking for a skilled professional to create innovative packing designs and develop an e-commerce platform for our business.The ideal candidate should ha...",
        "preview": "We are looking for a skilled professional to create innovative packing designs and develop an e-commerce platform for our business.The ideal candidate should ha...",
        "type": "fixed",
        "budget": {
          "type": "fixed",
          "min": 3,
          "max": 3,
          "currency": "USD"
        },
        "skills": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]"
          }
        ],
        "category": null,
        "status": "Active",
        "bids_count": 13,
        "posted_at": 1784145282,
        "client_country": null,
        "client": null,
        "featured": false,
        "urgent": false,
        "nda": false,
        "url": "https://www.truelancer.com/freelance-project/packing-design-for-e-commerce-platform-development-650939",
        "seo_url": "https://www.truelancer.com/freelance-project/packing-design-for-e-commerce-platform-development-650939"
      }
    ],
    "total_count": 15,
    "returned": 8,
    "offset": 0,
    "source": "truelancer"
  }
}

Actions

What the Truelancer.com API does

Action	Description	Concrete use case	Key params
search	Search live freelance PROJECTS on Truelancer.com by keyword. Returns title, description, budget{type,min,max,currency}, skills[], category, proposal count, posted_at, coarse client signals (country, verified, total spent), and the project url. No client PII (the poster's name is dropped).	Recruiting teams call search to search live freelance PROJECTS on Truelancer.com by keyword.	query, limit, offset
project	Full detail for one Truelancer.com project by URL or slug — everything from `search` plus views, end-date, tags, payment-verified flag, and proposal breakdown (received/active/shortlisted). No client PII.	Labor-market analysts call project to get full detail for one Truelancer.com project by URL or slug.	id
user	PUBLIC business profile of a Truelancer.com freelancer by handle or profile URL: display name, headline, country, hourly rate, skills, ratings (avg rating, reviews, five-star %, projects delivered, total earnings), membership and availability. PII (email/phone/legal-name/address) is NEVER returned.	Job boards call user to get pUBLIC business profile of a Truelancer.com freelancer by handle or profile URL.	username

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/truelancer/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"design","limit":8}'

import requests

r = requests.post(
    "https://api.reefapi.com/truelancer/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "design",
  "limit": 8
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/truelancer/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "design",
  "limit": 8
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.truelancer.search with {"query":"design","limit":8}.

Use cases

Who uses this API and why

Freelance tools call search to surface new Truelancer projects matching a user's skills.
Market researchers use search to size demand and budgets for a service.
Lead-gen products use project and user to find clients posting relevant work.

FAQ

Questions developers ask before integrating

What is the Truelancer.com API?

Truelancer.com API is a ReefAPI endpoint group for truelancer.com It returns live JSON through POST requests under /truelancer/v1.

Is the Truelancer.com API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Truelancer.com calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Truelancer.com login or account?

No login to Truelancer.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 Truelancer.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 Truelancer.com API use?

Truelancer.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 Truelancer.com from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call truelancer actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Truelancer.com API a Truelancer.com scraper?

It is the managed alternative to a DIY Truelancer.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 truelancer.com back as clean JSON.

Why does my Truelancer.com scraper keep getting blocked?

Most Truelancer.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 / truelancer

Truelancer.com

base /truelancer/v13 endpoints

post/truelancer/v1/search1 credit

Search live freelance PROJECTS on Truelancer.com by keyword. Returns title, description, budget{type,min,max,currency}, skills[], category, proposal count, posted_at, coarse client signals (country, verified, total spent), and the project url. No client PII (the poster's name is dropped).

Parameter		Allowed / range	Description
query	optional	—	Keyword to search Truelancer projects (title/skills) — e.g. 'logo design', 'wordpress', 'data entry'. Omit to browse the newest projects.
limit = 30	optional	1–75	How many projects to return (1–75). Use `offset` to page.
offset = 0	optional	0–5000	Pagination offset (0–5000); skip this many results before returning `limit`.

Try in playground →

post/truelancer/v1/project1 credit

Full detail for one Truelancer.com project by URL or slug — everything from `search` plus views, end-date, tags, payment-verified flag, and proposal breakdown (received/active/shortlisted). No client PII.

Parameter		Allowed / range	Description
id	required	—	The project to fetch: a Truelancer project URL or SEO slug ('freelance-project/<slug>-<id>'). A bare numeric id is not resolvable unauthenticated (the slug is required).

Try in playground →

post/truelancer/v1/user1 credit

PUBLIC business profile of a Truelancer.com freelancer by handle or profile URL: display name, headline, country, hourly rate, skills, ratings (avg rating, reviews, five-star %, projects delivered, total earnings), membership and availability. PII (email/phone/legal-name/address) is NEVER returned.

Parameter		Allowed / range	Description
username	required	—	The freelancer to fetch: a Truelancer profile handle or profile URL. Returns the PUBLIC business profile only — no email / phone / legal-name / address (those are never returned).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/truelancer/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"design","limit":8}'

Response shape

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