Jobs & Hiring

Guru.com API

The Guru.com API returns live freelance jobs and profiles as clean JSON.

4 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, a user and categories. It is built for freelance tools, market research and lead generation that need Guru.com 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/guru/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "limit": 8
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "guru",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 949.9,
    "record_count": 8,
    "bytes": 224127,
    "cache_hit": false,
    "method": "ssr_ldjson_bare_dc",
    "pii_redacted": true,
    "stop_reason": "limit_reached"
  },
  "data": {
    "projects": [
      {
        "id": "2119617",
        "source": "guru",
        "title": "Image Color Correction and Graphic",
        "description": "I have one image that needs to look polished and on-brand. First, please correct the overall colour balance—think cleaner whites, richer blacks, and natural, vibrant tones without over-saturation. Aft&hellip;",
        "preview": "I have one image that needs to look polished and on-brand. First, please correct the overall colour balance—think cleaner whites, richer blacks, and natural, vibrant tones without over-saturation. Aft&hellip;",
        "type": "fixed",
        "budget": {
          "type": "fixed",
          "min": null,
          "max": null,
          "currency": null,
          "label": "Fixed Price"
        },
        "skills": [
          {
            "name": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]"
          }
        ],
        "category": "Design & Art",
        "status": null,
        "bids_count": 5,
        "posted_at": 1784380801,
        "posted_relative": "Posted 4 hrs ago &middot; 5 Quotes Received",
        "client_country": null,
        "featured": false,
        "urgent": false,
        "nda": false,
        "url": "https://www.guru.com/jobs/image-color-correction-and-graphic/2119617",
        "seo_url": "/jobs/image-color-correction-and-graphic/2119617"
      },
      {
        "id": "2119591",
        "source": "guru",
        "title": "WordPress website development",
        "description": "Hi there! We need an estimate of the following job: We have a WordPress Website, and a \"specific page\" to work. We want to import data from an external source (like Excel) onto the \"specific page\" us&hellip;",
        "preview": "Hi there! We need an estimate of the following job: We have a WordPress Website, and a \"specific page\" to work. We want to import data from an external source (like Excel) onto the \"specific page\" us&hellip;",
        "type": "fixed",
        "budget": {
          "type": "fixed",
          "min": 250,
          "max": 250,
          "currency": "USD",
          "label": "Fixed Price | Under $250"
        },
        "skills": [
          {
            "name": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]"
          }
        ],
        "category": "Programming & Development",
        "status": null,
        "bids_count": 85,
        "posted_at": 1784395201,
        "posted_relative": "Posted on Jul 17, 2026 &middot; 85 Quotes Received",
        "client_country": null,
        "featured": false,
        "urgent": false,
        "nda": false,
        "url": "https://www.guru.com/jobs/wordpress-website-development/2119591",
        "seo_url": "/jobs/wordpress-website-development/2119591"
      },
      {
        "id": "2119585",
        "source": "guru",
        "title": "Performance-Based Email Marketing Expert",
        "description": "About BrightWebX Technology BrightWebX Technology is a digital solutions company providing: Custom Website Development E-commerce Development Mobile App Development SEO & Digital Marketing UI/UX Desig&hellip;",
        "preview": "About BrightWebX Technology BrightWebX Technology is a digital solutions company providing: Custom Website Development E-commerce Development Mobile App Development SEO & Digital Marketing UI/UX Desig&hellip;",
        "type": "fixed",
        "budget": {
          "type": "fixed",
          "min": null,
          "max": null,
          "currency": null,
          "label": "Fixed Price or Hourly"
        },
        "skills": [
          {
            "name": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]"
          },
          {
            "name": "[trimmed-depth]"
          }
        ],
        "category": "Programming & Development",
        "status": null,
        "bids_count": 22,
        "posted_at": 1784395201,
        "posted_relative": "Posted on Jul 17, 2026 &middot; 22 Quotes Received",
        "client_country": null,
        "featured": false,
        "urgent": false,
        "nda": false,
        "url": "https://www.guru.com/jobs/performance-based-email-marketing-expert/2119585",
        "seo_url": "/jobs/performance-based-email-marketing-expert/2119585"
      }
    ],
    "total_count": null,
    "returned": 8,
    "offset": 0,
    "source": "guru",
    "note": null
  }
}

Actions

What the Guru.com API does

Action	Description	Concrete use case	Key params
search	Search live freelance JOBS across the whole Guru.com board. `query` is served SERVER-SIDE via Guru's own skill/keyword path — known skills are canonicalised from the shipped slug dictionary (`nodejs` → `node.js`), unknown terms use Guru's free-text match, and `data.match` reports which. Also browsable by `category`/`skills` and paginated by `offset`. Returns title, description, budget{type,min,max,currency}, skills[], quote count (bids_count), posted date, and url. No client PII.	Recruiting teams call search to search live freelance JOBS across the whole Guru.com board.	query, category, skills, limit, offset
project	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.	Labor-market analysts call project to get full detail for one Guru.com job by URL, slug, or numeric id.	id
user	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.	Job boards call user to get pUBLIC business profile of a Guru.com freelancer/provider by profile URL or handle.	username
categories	List the top-level Guru.com freelance job categories (Programming, Design, Writing…) — the browse taxonomy for scoping a `search`.	Sales intelligence teams call categories to list the top-level Guru.com freelance job categories (Programming, Design, Writing…).	none

Code samples

Call search from your stack

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

import requests

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

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

MCP one-liner

Ask your MCP-connected assistant: call reefapi.guru.search with {"limit":8}.

Use cases

Who uses this API and why

Freelance tools call search to surface new Guru projects matching a user's skills.
Market researchers use categories 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 Guru.com API?

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

Is the Guru.com API free to try?

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

Do I need a Guru.com login or account?

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

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

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

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

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

Why does my Guru.com scraper keep getting blocked?

Most Guru.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 / guru

Guru.com

base /guru/v14 endpoints

post/guru/v1/search1 credit

Search live freelance JOBS across the whole Guru.com board. `query` is served SERVER-SIDE via Guru's own skill/keyword path — known skills are canonicalised from the shipped slug dictionary (`nodejs` → `node.js`), unknown terms use Guru's free-text match, and `data.match` reports which. Also browsable by `category`/`skills` and paginated by `offset`. 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	—	What to search Guru's whole job board for, SERVER-SIDE — a skill (`wordpress`, `nodejs`, `data entry`) or any free-text term (`excel`, `translation`). Known skills are canonicalised first (`nodejs` → `node.js`); anything else is handed to Guru's own keyword match. `data.match` says which of the two happened. A term Guru finds nothing for returns NOT_FOUND, never an empty 200.
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 server-side, with or without a `category` (e.g. skills=['php'], or category=programming-development + skills=['php']). First value used. When BOTH `skills` and `query` are sent, `skills` picks the server-side path and `query` is applied on top as a client-side filter.
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. Works with `query`/`skills`/`category` (Guru pages the skill path too). Ignored only in the client-side fallback (`match`=`recent_feed_filter`), which always scans from the newest posting.

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: the full Guru job URL or the `<slug>/<id>` path (both are returned by `search` as `url` / `seo_url`). A BARE numeric id will not work — Guru serves the detail page only at /jobs/<slug>/<id> and answers a bare id with its login wall.

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
}