docs / global-jobs

Global Jobs

Job listings aggregated across many sources.

base /global-jobs/v12 endpoints

post/global-jobs/v1/jobs/search1 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.

Parameter		Allowed / range	Description
platform	required	naukri · gupy · catho · stepstone	The job board to search. Choose Naukri (India), Gupy or Catho (Brazil), or StepStone (Germany & Europe) — each is a different country's job market.
keyword	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	optional	—	City or region to filter jobs by — e.g. 'Bangalore', 'São Paulo', 'Berlin'. Naukri defaults to Bangalore; Catho searches nationwide.
max_pages = 10	optional	1–	How many result pages to fetch — each page returns more jobs. Default 10.
max_results	optional	1–	Optional cap on the total number of jobs returned across all pages.
page_size = 20	optional	1–	Number of jobs per page (Naukri and Gupy). Default 20.

Try in playground →

post/global-jobs/v1/jobs/detail1 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.

Parameter		Allowed / range	Description
platform	required	naukri · gupy · catho · stepstone	The job board to search. Choose Naukri (India), Gupy or Catho (Brazil), or StepStone (Germany & Europe) — each is a different country's job market.
job_id	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	optional	—	The full job posting / apply URL — used by Catho and StepStone (required) and Gupy. Example: a catho.com.br/vagas/… link.

Try in playground →

Example request · jobs/search

curl -X POST https://api.reefapi.com/global-jobs/v1/jobs/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"platform":"naukri","keyword":"software engineer","location":"bangalore","max_pages":3}'

Response shape

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