docs / guru

Guru.com API scraper

base /guru/v14 endpoints

post/guru/v1/search1 credit

Browse live freelance JOBS on Guru.com, scoped server-side by category and skill (and paginated). An optional `query` keyword is applied as a client-side filter over the recent feed (Guru's free-text search is POST-walled). Returns title, description, budget{type,min,max,currency}, skills[], quote count (bids_count), posted date, and url. No client PII.

Parameter		Allowed / range	Description
query	optional	—	Keyword to match over the recent feed (title/description/skills). NOTE: Guru's free-text search is POST-walled, so this is applied as a client-side filter — use `category`/`skills` for server-side scoping.
category	optional	programming-development · design-art · writing-translation · sales-marketing · business-finance · engineering-architecture · administrative-secretarial · legal · education-training · other	Top-level category slug for server-side scoping (see the `categories` action). One of: programming-development, design-art, writing-translation, sales-marketing, business-finance, engineering-architecture, administrative-secretarial, legal, education-training, other.
skills	optional	—	Skill slug to scope the search within a category (server-side, e.g. category=programming-development + skills=['php']). First value used.
limit = 30	optional	1–80	How many jobs to return (1–80). Use `offset` to page.
offset = 0	optional	0–5000	Pagination offset (0–5000); skip this many results. (Ignored when a keyword filter is active — keyword scans the recent feed.)

Try in playground →

post/guru/v1/project1 credit

Full detail for one Guru.com job by URL, slug, or numeric id — title, description, budget{type,min,max,currency}, skills[], employment type, posted date, valid-through, and the job's location requirement (country). No client PII.

Parameter		Allowed / range	Description
id	required	—	The job to fetch: a Guru job URL, slug, or numeric id.

Try in playground →

post/guru/v1/user1 credit

PUBLIC business profile of a Guru.com freelancer/provider by profile URL or handle: display name, headline, country, skills, and rating summary. PII (email/phone/legal-name/address) is NEVER returned.

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

Try in playground →

post/guru/v1/categories1 credit

List the top-level Guru.com freelance job categories (Programming, Design, Writing…) — the browse taxonomy for scoping a `search`.

Try in playground →

Example request · search

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

Response shape

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