docs / truelancer

Truelancer.com API scraper

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
}