# Global Jobs API — Naukri (India), Gupy & Catho (Brazil), StepStone (Germany) job search

> Search live job listings on Naukri (India), Gupy and Catho (Brazil), or StepStone (Germany & Europe) by job title, keyword and city. Returns each job's title, company, location and link.
> ReefAPI engine `global-jobs` · 2 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/global-jobs/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed or blocked calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http, `Authorization: Bearer <key>`) and your assistant can call these actions directly.

## Endpoints

### POST /global-jobs/v1/jobs/search — 1 credit
Search live job listings on Naukri (India), Gupy and Catho (Brazil), or StepStone (Germany & Europe) by job title, keyword and city. Returns each job's title, company, location and link.

**Parameters:**
- `platform` (enum, required) — The job board to search. Choose Naukri (India), Gupy or Catho (Brazil), or StepStone (Germany & Europe) — each is a different country's job market. [one of: naukri, gupy, catho, stepstone]
- `keyword` (string, optional) — Job title or keyword to search for — e.g. 'software engineer', 'data analyst', or 'desenvolvedor' (Portuguese) on the Brazilian boards Gupy and Catho.
- `location` (string, optional) — City or region to filter jobs by — e.g. 'Bangalore', 'São Paulo', 'Berlin'. Naukri defaults to Bangalore; Catho searches nationwide.
- `max_pages` (integer, optional, default 10) — How many result pages to fetch — each page returns more jobs. Default 10.
- `max_results` (integer, optional) — Optional cap on the total number of jobs returned across all pages.
- `page_size` (integer, optional, default 20) — Number of jobs per page (Naukri and Gupy). Default 20.

**Returns:** jobs[] (title, company_name, location, url, …), count, and the platform searched. Personal data is redacted unless you request it.

**Example request body:**
```json
{
  "platform": "naukri",
  "keyword": "software engineer",
  "location": "bangalore",
  "max_pages": 3
}
```

### POST /global-jobs/v1/jobs/detail — 1 credit
Get the full details of a single job posting from Naukri, Gupy, Catho or StepStone — job title, company, full description, salary, location and how to apply.

**Parameters:**
- `platform` (enum, required) — The job board to search. Choose Naukri (India), Gupy or Catho (Brazil), or StepStone (Germany & Europe) — each is a different country's job market. [one of: naukri, gupy, catho, stepstone]
- `job_id` (string, optional) — The job's id on the board — used by Naukri (required) and Gupy. Provide either job_id or job_url, depending on the board.
- `job_url` (string, optional) — The full job posting / apply URL — used by Catho and StepStone (required) and Gupy. Example: a catho.com.br/vagas/… link.

**Returns:** job{} — the full posting: title, company, description, salary, location and more. Personal data is redacted unless you request it.

**Example request body:**
```json
{
  "platform": "naukri"
}
```

## More
- Try it live, no code: https://reefapi.com/playground?engine=global-jobs
- Human docs page: https://reefapi.com/docs/global-jobs
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt