# Himalayas API — remote jobs from himalayas.app: search remote jobs by keyword, country, worldwide, seniority, employment type, company, timezone, salary, market and benefits; the full jobs feed; job detail with salary, location and timezone restrictions, skills and apply link; related jobs and jobs by region; company profiles, jobs, salaries and benefits; company search; remote talent search and profiles; salary benchmarks and remote-work statistics — no login

> Search Himalayas remote jobs (the site's own JSON search) by keyword with every filter it takes: country (worldwide jobs included unless exclude_worldwide), worldwide-only, seniority, employment type, company, hiring timezone and sort (relevance, newest, salary high/low). 20 full jobs a page with description, salary range + currency + period, location and timezone restrictions and apply link; total = the site's count (a keyword search stops at 5 000 results = 250 pages). Himalayas pins paid 'sticky' jobs to the top of page 1, so page 1's first rows are not in sort order; the search is served from Himalayas' CDN cache (refreshed daily), so with sort=recent consecutive pages fetched minutes apart can repeat a few jobs (measured 9 of 20) — de-duplicate on job_id, or use feed for a complete walk without repeats.
> ReefAPI engine `himalayas` · 20 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/himalayas/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 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). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/himalayas/v1/search — 1 credit
Search Himalayas remote jobs (the site's own JSON search) by keyword with every filter it takes: country (worldwide jobs included unless exclude_worldwide), worldwide-only, seniority, employment type, company, hiring timezone and sort (relevance, newest, salary high/low). 20 full jobs a page with description, salary range + currency + period, location and timezone restrictions and apply link; total = the site's count (a keyword search stops at 5 000 results = 250 pages). Himalayas pins paid 'sticky' jobs to the top of page 1, so page 1's first rows are not in sort order; the search is served from Himalayas' CDN cache (refreshed daily), so with sort=recent consecutive pages fetched minutes apart can repeat a few jobs (measured 9 of 20) — de-duplicate on job_id, or use feed for a complete walk without repeats.

**Parameters:**
- `keyword` (string, optional) — Job title, skill or company words, matched the way himalayas.app search does.
- `country` (string, optional) — Country the job must be open to: ISO code (US, DE, GB), name (Germany) or Himalayas slug (united-states). Worldwide jobs are included unless exclude_worldwide=true. 250 countries (locations action, kind=countries).
- `worldwide` (boolean, optional) — true = only jobs open to every country (no location restriction). Overrides country.
- `exclude_worldwide` (boolean, optional) — With country: drop worldwide jobs, keep only jobs that name that country.
- `seniority` (array, optional) — One or more experience levels (OR). [one of: entry-level, mid-level, senior, manager, director, executive]
- `employment_type` (array, optional) — One or more employment types (OR). [one of: full-time, part-time, contractor, temporary, intern, volunteer, other]
- `company` (string, optional) — Only this company's jobs (company slug from any row, e.g. 'gitlab'). One company per call (the API ignores a second one).
- `timezone` (string, optional) — Only jobs that hire in this UTC offset (hours): -5, 0, 5.5, 'UTC+1', '+05:30'.
- `sort` (enum, optional, default "relevant") — Result order. [one of: relevant, recent, salary_desc, salary_asc]
- `page` (integer, optional, default 1) — Result page (20 jobs a page). A KEYWORD search stops at 5 000 results = page 250 (page 251 is empty); without a keyword every page is served (country=US page 400 answered 20 rows).

**Returns:** jobs[]{job_id, job_slug, company_slug, title, url, apply_url, company{name,slug,logo_url,url}, employment_type, seniority[], salary{min,max,currency,period,listed}, location_restrictions[], worldwide, timezone_restrictions[] (UTC offsets), categories[], parent_categories[], excerpt, description_text, description_html, updated_at (the API's pubDate = last update), updated_timestamp, apply_before, apply_before_timestamp} + total + page + pages + has_more

**Example request body:**
```json
{
  "keyword": "python"
}
```

### POST https://api.reefapi.com/himalayas/v1/search-advanced — 1 credit
Himalayas' live search with the filters the JSON search does not have: salary range (yearly USD; hourly/monthly pay is converted by Himalayas), salary listed or not, company markets (fintech, saas…), company benefits, several companies at once — plus keyword, country, worldwide, one seniority, one employment type and sort. 20 jobs a page with title, company (+verified badge), employment type, countries, posting date, salary as printed and parsed, categories and key skills. Use job for the full description.

**Parameters:**
- `keyword` (string, optional) — Job title, skill or company words, matched the way himalayas.app search does.
- `country` (string, optional) — Country the job must be open to: ISO code (US, DE, GB), name (Germany) or Himalayas slug (united-states). Worldwide jobs are included unless exclude_worldwide=true. 250 countries (locations action, kind=countries).
- `worldwide` (boolean, optional) — true = only jobs open to every country (no location restriction). Overrides country.
- `exclude_worldwide` (boolean, optional) — With country: drop worldwide jobs, keep only jobs that name that country.
- `seniority` (enum, optional) — One experience level. [one of: entry-level, mid-level, senior, manager, director, executive]
- `employment_type` (enum, optional) — One employment type. [one of: full-time, part-time, contractor, temporary, intern, volunteer, other]
- `salary_min` (number, optional) — Minimum yearly pay in USD (Himalayas converts hourly x2080, monthly x12).
- `salary_max` (number, optional) — Maximum yearly pay in USD.
- `salary_required` (boolean, optional, default true) — With salary_min/max: false also keeps jobs that list no salary.
- `markets` (array, optional) — Company market slugs (OR): fintech, saas, healthcare, ai, ecommerce…
- `benefits` (array, optional) — Company benefit slugs: healthcare-benefits, retirement-benefits, equity-benefits, 4-day-workweeks, unlimited-time-off, learning-and-development-budget…
- `companies` (array, optional) — Company slugs (OR).
- `sort` (enum, optional, default "relevant") — Result order. [one of: relevant, recent, salary_desc, salary_asc]
- `page` (integer, optional, default 1) — Result page (20 jobs a page).

**Returns:** jobs[]{job_id, job_slug, company_slug, title, url, company{name,slug,verified,url}, employment_type, location_restrictions[], worldwide, posted_on, salary{label,min,max,currency,period,annual_min,annual_max}, categories[], skills[], skills_not_shown} + total + page

**Example request body:**
```json
{
  "keyword": "python"
}
```

### POST https://api.reefapi.com/himalayas/v1/feed — 1 credit
The whole Himalayas jobs feed, most recently updated first, with the site's own cursor: pass next_cursor back to walk every open job (119 538 on 2026-11-16) without repeats (3 consecutive pages: 0 repeats). 1-20 full jobs per call (same fields as search). Himalayas' API docs say the feed is refreshed once a day.

**Parameters:**
- `limit` (integer, optional, default 20) — Jobs per call (the API's maximum is 20).
- `cursor` (string, optional) — next_cursor from the previous call (opaque).

**Returns:** jobs[]{job_id, job_slug, company_slug, title, url, apply_url, company{name,slug,logo_url,url}, employment_type, seniority[], salary{min,max,currency,period,listed}, location_restrictions[], worldwide, timezone_restrictions[] (UTC offsets), categories[], parent_categories[], excerpt, description_text, description_html, updated_at (the API's pubDate = last update), updated_timestamp, apply_before, apply_before_timestamp} + total + next_cursor + has_more

**Example request body:**
```json
{
  "limit": 5
}
```

### POST https://api.reefapi.com/himalayas/v1/job — 2 credits
One Himalayas job in full: title, company, description (text + HTML + Himalayas' markdown), salary min/max + currency + period, location restrictions, hiring timezones, seniority, employment type, categories, skills, education and experience requirement, the page's 'Posted on' date, the last-update date, apply-before date, apply link and whether the job is still open. A closed job answers NOT_FOUND with the date it closed.

**Parameters:**
- `job_id` (string, optional) — 'company-slug/job-slug' — job_id from any search row. A himalayas.app job URL (url) or company + job_slug also work.
- `url` (string, optional) — A himalayas.app job URL instead of job_id.
- `company` (string, optional) — Company slug, with job_slug.
- `job_slug` (string, optional) — Job slug, used together with company.

**Returns:** job{job_id, job_slug, company_slug, title, url, apply_url, company{name,slug,logo_url,url}, employment_type, seniority[], salary{min,max,currency,period,listed}, location_restrictions[], worldwide, timezone_restrictions[] (UTC offsets), categories[], parent_categories[], excerpt, description_text, description_html, updated_at (the API's pubDate = last update), updated_timestamp, apply_before, apply_before_timestamp, status, posted_on (the page's 'Posted on'), skills[], education_requirement, experience_requirement{label,required,years_min}, company_verified, description_markdown, salary_label}

**Example request body:**
```json
{
  "job_id": "codurance/delivery-manager-and-business-analyst"
}
```

### POST https://api.reefapi.com/himalayas/v1/related-jobs — 1 credit
Jobs Himalayas lists as similar to one job (skills, location, category) — 10 jobs with company, employment type, countries and salary.

**Parameters:**
- `job_id` (string, optional) — 'company-slug/job-slug' — job_id from any search row. A himalayas.app job URL (url) or company + job_slug also work.
- `url` (string, optional) — A himalayas.app job URL instead of job_id.
- `company` (string, optional) — Company slug, with job_slug.
- `job_slug` (string, optional) — Job slug, used together with company.

**Returns:** jobs[]{job_id, title, url, company{name,slug,url}, employment_type, location_restrictions[], worldwide, salary{label,min,max,currency,period}}

**Example request body:**
```json
{
  "job_id": "codurance/delivery-manager-and-business-analyst"
}
```

### POST https://api.reefapi.com/himalayas/v1/region-jobs — 2 credits
Remote jobs open to a world region, continent or sub-region (europe, latam, emea, apac, na, asia, south-america…; list in locations kind=regions), optionally narrowed to a role or skill (python, software-engineer, sales…). 20 jobs a page with salary as printed, location requirements and posting date; total = the site's count.

**Parameters:**
- `region` (string, required) — Region slug: europe, latam, emea, apac, na, asia, africa, south-america, north-america, oceania… (locations kind=regions).
- `role` (string, optional) — Role, skill or category as the site files it (python, sales, software-engineer, customer-service, data-science…).
- `page` (integer, optional, default 1) — Result page (20 jobs a page).

**Returns:** jobs[]{job_id, title, url, company{name,slug,url}, salary{label,min,max,currency,period}, location_restrictions[], worldwide, posted_on} + total + page + pages

**Example request body:**
```json
{
  "region": "europe"
}
```

### POST https://api.reefapi.com/himalayas/v1/company — 1 credit
A Himalayas company profile: name, verified badge, employee range, founding year, CEO, employee countries, markets, open remote positions, about text, full tech stack by category, benefits by category, website, social links and the links to its jobs / salaries / benefits pages.

**Parameters:**
- `company` (string, required) — Company slug (company_slug on any row, e.g. 'gitlab') or a himalayas.app company URL.

**Returns:** company{company_slug, name, verified, size{label,min,max}, founded, ceo, locations[], markets[], open_positions, about, tech_stack[]{category,items[]}, tech_stack_count, benefits[]{category,items[]}, benefits_count, website, url, social_links[]{network,url}}

**Example request body:**
```json
{
  "company": "gitlab"
}
```

### POST https://api.reefapi.com/himalayas/v1/company-jobs — 1 credit
Every open remote job of one company, in full (same fields as search), 20 a page, newest first, with the company's total.

**Parameters:**
- `company` (string, required) — Company slug (company_slug on any row, e.g. 'gitlab') or a himalayas.app company URL.
- `page` (integer, optional, default 1) — Result page (20 jobs a page).

**Returns:** jobs[]{job_id, job_slug, company_slug, title, url, apply_url, company{name,slug,logo_url,url}, employment_type, seniority[], salary{min,max,currency,period,listed}, location_restrictions[], worldwide, timezone_restrictions[] (UTC offsets), categories[], parent_categories[], excerpt, description_text, description_html, updated_at (the API's pubDate = last update), updated_timestamp, apply_before, apply_before_timestamp} + total + page + pages

**Example request body:**
```json
{
  "company": "gitlab"
}
```

### POST https://api.reefapi.com/himalayas/v1/company-salaries — 2 credits
What one company pays on its remote job posts: typical range and median (USD), the highest- and lowest-paying role, and every role with its salary range, currency and countries. Himalayas estimates these from the company's posts; companies that list no salary answer has_data=false.

**Parameters:**
- `company` (string, required) — Company slug (company_slug on any row, e.g. 'gitlab') or a himalayas.app company URL.

**Returns:** typical_min_usd, typical_max_usd, median_usd, highest_and_lowest[], roles[]{job_title, salary_range_label, min, max, currency, countries[]}, last_updated, has_data

**Example request body:**
```json
{
  "company": "gitlab"
}
```

### POST https://api.reefapi.com/himalayas/v1/company-benefits — 2 credits
Every employee benefit a company lists on Himalayas, with its category and the company's own description of it.

**Parameters:**
- `company` (string, required) — Company slug (company_slug on any row, e.g. 'gitlab') or a himalayas.app company URL.

**Returns:** benefits[]{benefit, category, description}

**Example request body:**
```json
{
  "company": "gitlab"
}
```

### POST https://api.reefapi.com/himalayas/v1/company-search — 1 credit
Search Himalayas' remote-friendly companies (~35 000) by keyword, employee country, technology in their stack, or sort by open jobs / name / newest. 20 companies a page with markets, open positions, tech-stack / benefit / salary counts and an about excerpt.

**Parameters:**
- `keyword` (string, optional) — Company name, industry or description words.
- `country` (string, optional) — Companies with employees in this country (code, name or slug). Measured: with a country the keyword also matches company descriptions, so the count can grow (software: 47 → 417 with Germany; fintech: 450 → 93).
- `tech_stack` (array, optional) — Technology slugs in the company's stack (react, python, typescript…).
- `sort` (enum, optional, default "relevant") — Result order. [one of: relevant, recent, jobs, name_asc, name_desc]
- `page` (integer, optional, default 1) — Result page (20 companies a page).

**Returns:** companies[]{company_slug, name, verified, url, location, open_positions, markets[], markets_not_shown, tech_stack_count, benefits_count, salary_insights_count, about_excerpt} + total + page

**Example request body:**
```json
{
  "keyword": "fintech"
}
```

### POST https://api.reefapi.com/himalayas/v1/company-directory — 2 credits
Himalayas' company directory for ONE market (fintech, saas, healthcare…), technology (react, python…), benefit (healthcare-benefits, 4-day-workweeks…) or employee country — most open remote jobs first, 20 a page with summary, open jobs and employee range; total = the site's count. No filter = all ~35 000 companies.

**Parameters:**
- `market` (string, optional) — Market slug (fintech, saas, ai, healthcare…).
- `technology` (string, optional) — Technology slug.
- `benefit` (string, optional) — Benefit slug.
- `country` (string, optional) — Employee country (code, name or slug).
- `page` (integer, optional, default 1) — Result page (20 companies a page).

**Returns:** companies[]{company_slug, name, url, summary, open_jobs, employees{label,min,max}} + total + page + pages

**Example request body:**
```json
{
  "market": "fintech"
}
```

### POST https://api.reefapi.com/himalayas/v1/talent-search — 2 credits
Himalayas' public remote-talent marketplace (~636 000 people): filter by role / skill category (python, product-designer…) and/or country (based in or authorized to work in). 20 people a page with name, profile slug, role, country, salary expectations and intro; total = the site's count.

**Parameters:**
- `role` (string, optional) — Role or skill category as the site files it (python, react-developer, product-designer, data-analyst…).
- `country` (string, optional) — Country (code, name or slug). Himalayas' own country list: people based there OR authorized to work there (measured: python+Canada 88 people, 11 of the first 20 based elsewhere, each listing Canada in authorized_to_work_in).
- `page` (integer, optional, default 1) — Result page (20 people a page).

**Returns:** talent[]{talent_slug, name, url, role, location, salary_expectations{label,min,max,currency,open_ended}, intro} + total + page + pages

**Example request body:**
```json
{
  "role": "python"
}
```

### POST https://api.reefapi.com/himalayas/v1/talent-profile — 1 credit
One public Himalayas talent profile (himalayas.app/@slug): headline, availability, location, work authorization, salary expectations, job categories, skills, portfolio / LinkedIn / GitHub links, what they are looking for, about, full experience (company, period, description, skills), education, tech stack and 'people also viewed'.

**Parameters:**
- `talent` (string, required) — Profile slug (talent_slug from talent-search) or himalayas.app/@slug URL.

**Returns:** profile{talent_slug, name, headline, summary, availability, location, authorized_to_work_in[], salary_expectations, job_categories[], skills[], links[], looking_for, about, experience[], education[], tech_stack[], people_also_viewed[]}

**Example request body:**
```json
{
  "talent": "jasonhead"
}
```

### POST https://api.reefapi.com/himalayas/v1/salaries — 1 credit
Himalayas salary benchmarks for a job title: min, median and max yearly pay in USD with the number of data points, per seniority and country (fuzzy title match). Filter to one seniority and/or one country.

**Parameters:**
- `job_title` (string, required) — Job title (software engineer, product manager, data scientist…).
- `seniority` (enum, optional) — One seniority level. [one of: entry-level, mid-level, senior, manager, director, executive]
- `country` (string, optional) — Country (code, name or slug).

**Returns:** benchmarks[]{job_title, seniority, country, min, median, max, currency, period, data_points}

**Example request body:**
```json
{
  "job_title": "software engineer"
}
```

### POST https://api.reefapi.com/himalayas/v1/salary-countries — 1 credit
Average, minimum and maximum remote pay per country (USD per year, rounded to $1k by Himalayas) with the number of reported salaries — every country Himalayas has salaries for.

**Parameters:** none

**Returns:** countries[]{country, country_slug, min_usd, max_usd, average_usd, salaries} + summary

### POST https://api.reefapi.com/himalayas/v1/salary-country — 1 credit
Remote salaries in one country: the country's average and range (USD per year) and every role x seniority Himalayas has salaries for there, with min / max / average and the number of salaries. role_slug opens salary-role.

**Parameters:**
- `country` (string, required) — Country (code, name or slug).

**Returns:** average_usd, range_min_usd, range_max_usd, salaries, roles[]{job_title, role_slug, seniority, min_usd, max_usd, average_usd, salaries}

**Example request body:**
```json
{
  "country": "germany"
}
```

### POST https://api.reefapi.com/himalayas/v1/salary-role — 1 credit
One role's remote salaries in one country, in the local currency: average per month and per year, minimum, range midpoint, maximum, number of salaries, the USD median, and every past salary (year, job type, amount, company size, company location).

**Parameters:**
- `country` (string, required) — Country (code, name or slug).
- `role` (string, required) — role_slug from salary-country (seniority + title, e.g. senior-software-engineer).

**Returns:** currency, average_per_month, average_per_year, minimum, range_midpoint, maximum, salaries, median_usd, past_salaries[]{year, job_type, salary_label, salary, currency, company_size, company_location}, last_updated

**Example request body:**
```json
{
  "country": "united-states",
  "role": "senior-software-engineer"
}
```

### POST https://api.reefapi.com/himalayas/v1/statistics — 1 credit
Himalayas remote-work statistics: ranked skills, job categories (grouped by department) or countries by number of open jobs, or countries / industries by number of remote companies — the site's full ranked lists (200 skills, 250 countries…), optionally for one country.

**Parameters:**
- `record` (enum, optional, default "jobs") — Count jobs or companies. [one of: jobs, companies]
- `type` (enum, optional, default "skills") — What to rank. [one of: skills, categories, countries, industries]
- `country` (string, optional) — Only jobs/companies in this country (record=jobs, type=skills or categories).
- `page` (integer, optional, default 1) — Page of a long ranking (200 rows a page; skills run to ~58 pages).

**Returns:** sections[]{heading, dimension, metric, rows[]{rank, name, url, count}} + summary + page + pages + total_entries

### POST https://api.reefapi.com/himalayas/v1/locations — 2 credits
The location lists Himalayas files remote jobs under: countries (249 on 2026-11-16, with the number of open remote jobs, the world region and the ISO code), world regions / continents / sub-regions (34 slugs for region-jobs), or timezones (201: name, slug and UTC offset for search timezone).

**Parameters:**
- `kind` (enum, optional, default "countries") — Which list. [one of: countries, regions, timezones]

**Returns:** countries[]{code, name, slug, jobs, region} | regions[]{group, name, slug} | timezones[]{name, slug, utc_offset, utc_offset_label}

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

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