# Hirist API — India tech jobs from hirist.tech: search by skill, city, experience, date and company cluster; full job ads with skills, salary, applications and the recruiter's name; similar jobs, skill and category feeds, jobs for women, company pages with AmbitionBox ratings, recruiter profiles and their jobs, the company directory, skills with live job counts and Hirist Learning courses — no login

> Search Hirist jobs (tech and IT jobs in India) with the site's own filters: keywords, location, experience range, date posted, category, company cluster. Real pagination with the site's total (up to 100 per page). Rows carry recruiter name, views and application counts, salary when published, skills and the company's AmbitionBox rating.
> ReefAPI engine `hirist` · 20 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/hirist/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/hirist/v1/search — 1 credit
Search Hirist jobs (tech and IT jobs in India) with the site's own filters: keywords, location, experience range, date posted, category, company cluster. Real pagination with the site's total (up to 100 per page). Rows carry recruiter name, views and application counts, salary when published, skills and the company's AmbitionBox rating.

**Parameters:**
- `query` (string, required) — Job title, skill or company words (required by the site).
- `location` (array, optional) — City / state / country name or id; several comma-separated. Common spellings work (Bengaluru, Gurugram, Kochi, Vizag, Bombay, Remote, Anywhere in India). Unknown names fail with INVALID_PARAM and a suggestion. Ids: `locations` action.
- `min_experience` (integer, optional) — Years of experience, lower end (0-30). Jobs whose range overlaps min..max are returned.
- `max_experience` (integer, optional) — Years of experience, upper end (0-30).
- `posted_within` (enum, optional) — Only jobs posted in the last N days (the site's own choices: 3, 7, 15, 30). [one of: 3, 7, 15, 30]
- `category` (array, optional) — Hirist job category, by id or name (1 Backend Development, 2 Frontend Development, 3 Others, 4 Semiconductor/VLSI/EDA, 5 Mobile Applications, 6 Platform Engineering/SAP/Oracle, 7 Data Analytics & BI, 8 DevOps/SRE, 9 Emerging Technologies, 10 UI & Design, 11 Quality Assurance, 12 Product Management, 13 Business Analysis and Project Management, 14 AI/ML, 15 Data Engineering, 16 Full Stack, 17 CyberSecurity). Several comma-separated.
- `company_cluster` (string, optional) — Only jobs at companies in this ONE cluster (id or name): 1 FMCG Companies, 2 FMCD Companies, 3 Consulting Companies, 4 Financial Services Companies, 5 Banking Companies, 6 Pharmaceuticals/Medical Companies, 7 Internet / eCommerce Companies, 8 Retail Companies, 9 IT Service Companies, 10 IT Product Companies, 11 Unicorns/Soonicorns, 12 Electronics/Semiconductors Companies, 13 Global Capability Centers, 14 Manufacturing Companies, 15 Real Estate Companies, 16 BPO Companies, 17 Fortune 500, 18 Procurement & Supply Chain, 19 Oil, Gas, Energy Companies, 20 Start-ups. The site takes a single cluster (two comma-separated ids are ignored by it, measured).
- `page` (integer, optional, default 1) — Result page (1 = first). meta.pagination says how many there are. Deepest reachable row: 10 000 (the site's own limit).
- `page_size` (integer, optional, default 20) — Rows per page (1-100; the site's own default is 20).

**Returns:** jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...} + total + meta.pagination

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

### POST https://api.reefapi.com/hirist/v1/ai-search — 2 credits
Hirist's own AI search: a plain-English request ("product manager in Bangalore, 5 years, fintech, posted this week") is turned by the site into filters, then those filters are searched. Returns the filters the site understood and the jobs.

**Parameters:**
- `text` (string, required) — What you are looking for, in plain words.
- `page` (integer, optional, default 1) — Result page (1 = first). meta.pagination says how many there are. Deepest reachable row: 10 000 (the site's own limit).
- `page_size` (integer, optional, default 20) — Rows per page (1-100; the site's own default is 20).

**Returns:** understood{query, skills[], job_titles[], company_names[], locations[], industries[], experience, posted_within, clusters[]} + jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...} + total + meta.pagination

**Example request body:**
```json
{
  "text": "senior react developer in Bangalore, 3 to 5 years, posted this week"
}
```

### POST https://api.reefapi.com/hirist/v1/detail — 2 credits
Full Hirist job: description (text + HTML), skills (mandatory or not), experience, salary when published, locations, category, posting date, application count, recruiter (name, designation, photo, organisation, last active) and the company block with AmbitionBox rating, reviews, benefits and top job profiles.

**Parameters:**
- `job_id` (string, optional) — Hirist job id — job_id from any list, or the number at the end of https://www.hirist.tech/j/<slug>-<id>. A job URL also works.
- `url` (string, optional) — A Hirist job URL instead of job_id.

**Returns:** job{... same as a search row ..., description_text, description_html, recruiter{id, name, designation, organisation, profile_url, last_active}, applications, recruiter_action_count, has_expired, masked_on_detail[]}

**Example request body:**
```json
{
  "job_id": "1682947"
}
```

### POST https://api.reefapi.com/hirist/v1/similar-jobs — 2 credits
The jobs Hirist recommends next to a job (its 'Similar jobs' list): the site matches on the job's skills, category, experience and functional area. One list of up to 20 jobs (measured), no further pages; views/applications are null where the list carries the site's 0/0 filler.

**Parameters:**
- `job_id` (string, optional) — Hirist job id — job_id from any list, or the number at the end of https://www.hirist.tech/j/<slug>-<id>. A job URL also works.
- `url` (string, optional) — A Hirist job URL instead of job_id.

**Returns:** source_job{job_id,title} + jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...}

**Example request body:**
```json
{
  "job_id": "1682947"
}
```

### POST https://api.reefapi.com/hirist/v1/category-jobs — 1 credit
Every open Hirist job in one category (the site's category pages), with location, experience, date-posted filters. Real pagination with the site's total.

**Parameters:**
- `category` (string, required) — Hirist job category, by id or name (1 Backend Development, 2 Frontend Development, 3 Others, 4 Semiconductor/VLSI/EDA, 5 Mobile Applications, 6 Platform Engineering/SAP/Oracle, 7 Data Analytics & BI, 8 DevOps/SRE, 9 Emerging Technologies, 10 UI & Design, 11 Quality Assurance, 12 Product Management, 13 Business Analysis and Project Management, 14 AI/ML, 15 Data Engineering, 16 Full Stack, 17 CyberSecurity).
- `location` (array, optional) — City / state / country name or id; several comma-separated. Common spellings work (Bengaluru, Gurugram, Kochi, Vizag, Bombay, Remote, Anywhere in India). Unknown names fail with INVALID_PARAM and a suggestion. Ids: `locations` action.
- `min_experience` (integer, optional) — Years of experience, lower end (0-30). Jobs whose range overlaps min..max are returned.
- `max_experience` (integer, optional) — Years of experience, upper end (0-30).
- `posted_within` (enum, optional) — Only jobs posted in the last N days (the site's own choices: 3, 7, 15, 30). [one of: 3, 7, 15, 30]
- `page` (integer, optional, default 1) — Result page (1 = first). meta.pagination says how many there are. Deepest reachable row: 10 000 (the site's own limit).
- `page_size` (integer, optional, default 20) — Rows per page (1-100; the site's own default is 20).

**Returns:** jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...} + total + meta.pagination

**Example request body:**
```json
{
  "category": 14
}
```

### POST https://api.reefapi.com/hirist/v1/skill-jobs — 2 credits
Every open Hirist job tagged with one skill (the site's /k/<skill>-jobs pages), with location, experience and date-posted filters, real pagination with the site's total, and the skill's own description and live job count.

**Parameters:**
- `skill` (string, required) — Skill / tag by name, slug or id (e.g. 'Python', 'machine-learning', 9). `skills` lists them with job counts.
- `location` (array, optional) — City / state / country name or id; several comma-separated. Common spellings work (Bengaluru, Gurugram, Kochi, Vizag, Bombay, Remote, Anywhere in India). Unknown names fail with INVALID_PARAM and a suggestion. Ids: `locations` action.
- `min_experience` (integer, optional) — Years of experience, lower end (0-30). Jobs whose range overlaps min..max are returned.
- `max_experience` (integer, optional) — Years of experience, upper end (0-30).
- `posted_within` (enum, optional) — Only jobs posted in the last N days (the site's own choices: 3, 7, 15, 30). [one of: 3, 7, 15, 30]
- `page` (integer, optional, default 1) — Result page (1 = first). meta.pagination says how many there are. Deepest reachable row: 10 000 (the site's own limit).
- `page_size` (integer, optional, default 20) — Rows per page (1-100; the site's own default is 20).

**Returns:** skill{id,name,slug,jobs_count,description,categories[]} + jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...} + total + meta.pagination

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

### POST https://api.reefapi.com/hirist/v1/women-jobs — 1 credit
Hirist's jobs for women: roles whose recruiters prefer women candidates (the site's Women at Work list), with location, experience and category filters; full rows with descriptions.

**Parameters:**
- `location` (array, optional) — City / state / country name or id; several comma-separated. Common spellings work (Bengaluru, Gurugram, Kochi, Vizag, Bombay, Remote, Anywhere in India). Unknown names fail with INVALID_PARAM and a suggestion. Ids: `locations` action.
- `min_experience` (integer, optional) — Years of experience, lower end (0-30). Jobs whose range overlaps min..max are returned.
- `max_experience` (integer, optional) — Years of experience, upper end (0-30).
- `category` (array, optional) — Hirist job category, by id or name (1 Backend Development, 2 Frontend Development, 3 Others, 4 Semiconductor/VLSI/EDA, 5 Mobile Applications, 6 Platform Engineering/SAP/Oracle, 7 Data Analytics & BI, 8 DevOps/SRE, 9 Emerging Technologies, 10 UI & Design, 11 Quality Assurance, 12 Product Management, 13 Business Analysis and Project Management, 14 AI/ML, 15 Data Engineering, 16 Full Stack, 17 CyberSecurity). Several comma-separated.
- `page` (integer, optional, default 1) — Result page (1 = first). meta.pagination says how many there are.
- `page_size` (integer, optional, default 20) — Rows per page (1-50; the site's own default is 20).

**Returns:** jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...} + total + meta.pagination

**Example request body:**
```json
{
  "location": "Bangalore"
}
```

### POST https://api.reefapi.com/hirist/v1/company — 2 credits
Hirist company page: name, domains, the company's ids on the site, cluster, AmbitionBox rating and review count, about text, founded year, employee band, type, industry, HQ, offices, benefits with how many employees reported each, top job profiles with their ratings.

**Parameters:**
- `company` (string, required) — Company slug as in https://www.hirist.tech/company/<slug> (e.g. 'nagarro-software'), or that URL. `companies` lists slugs.

**Returns:** company{slug, url, name, centralised_company_id, company_ids, domains[], location_ids, description, ambitionbox{rating, reviews_count, about_text, founded_year, employees, employees_india, company_type, primary_industry, headquarters, office_locations[], benefits[], top_job_profiles[]}}

**Example request body:**
```json
{
  "company": "nagarro-software"
}
```

### POST https://api.reefapi.com/hirist/v1/company-jobs — 1 credit
Every open Hirist job at one company (the company page's job list), newest first, 15 per page with the site's total. Full rows with descriptions.

**Parameters:**
- `company` (string, required) — Company slug as in https://www.hirist.tech/company/<slug> (e.g. 'nagarro-software'), or that URL. `companies` lists slugs.
- `page` (integer, optional, default 1) — Result page (15 jobs per page — fixed by the site).

**Returns:** jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...} + total + meta.pagination

**Example request body:**
```json
{
  "company": "nagarro-software"
}
```

### POST https://api.reefapi.com/hirist/v1/companies — 2 credits
Hirist's company directory: search companies by name, or page through all of them (optionally by location). Each row: slug, name, domains, clusters, AmbitionBox rating, reviews and benefits.

**Parameters:**
- `name` (string, optional) — Words of the company name. Empty = browse the whole directory.
- `page` (integer, optional, default 1) — Directory page (50 companies per page, fixed by the site). Ignored with `name` — name search returns every match on one page.
- `location` (array, optional) — Directory only: companies with an office in this city/state (name or id, see `locations`).

**Returns:** companies[]{slug, url, name, centralised_company_id, company_ids, domains[], clusters[], sub_clusters[], ambitionbox{...}, showcase} + meta.pagination

**Example request body:**
```json
{
  "name": "tech"
}
```

### POST https://api.reefapi.com/hirist/v1/recruiter — 1 credit
Hirist recruiter profile as the site publishes it: name, organisation, designation, location, about, photo, last login / last active / last job posted dates, LinkedIn / Facebook / Twitter / website links when given, and the skills they hire for with job counts.

**Parameters:**
- `recruiter_id` (string, required) — Recruiter id — recruiter.id on any job, or a /r/<id>-<name> profile URL.

**Returns:** recruiter{recruiter_id, name, organisation, designation, profile_url, photo_url, location, about, last_login, last_active, last_job_posted, linkedin_url, facebook_url, twitter_url, website, hires_for_skills[]{id,name,jobs_count}}

**Example request body:**
```json
{
  "recruiter_id": "68563"
}
```

### POST https://api.reefapi.com/hirist/v1/recruiter-jobs — 1 credit
Every open Hirist job posted by one recruiter, newest first, 20 per page with the site's total. Full rows with descriptions.

**Parameters:**
- `recruiter_id` (string, required) — Recruiter id — recruiter.id on any job, or a /r/<id>-<name> profile URL.
- `page` (integer, optional, default 1) — Result page (20 jobs per page — fixed by the site).

**Returns:** jobs[]{job_id, url, title, designation, company{name, company_id, centralised_company_id, logo_url, clusters[], sub_clusters[], ambitionbox{rating, reviews_count, ...}}, recruiter{id, name, designation, photo_url, actions_count}, locations[]{id,name}, experience{min_years,max_years}, salary{published, min_lpa, max_lpa, label, currency}, skills[]{id,name,is_mandatory}, category{id,name}, functional_area, industries[], posted_date, posted_at, views, applications, is_premium, work_from_home, women_preferred, external_apply_url, ...} + total + meta.pagination

**Example request body:**
```json
{
  "recruiter_id": "68563"
}
```

### POST https://api.reefapi.com/hirist/v1/skills — 1 credit
Every skill tag Hirist groups under its categories, with the live number of open jobs per skill (ids work in skill-jobs).

**Parameters:**
- `category` (string, optional) — Only this category (id or name). Empty = all.

**Returns:** categories[]{id, name, skills[]{id, name, jobs_count}} + total_skills (entries; a skill can sit in several categories) + unique_skills

### POST https://api.reefapi.com/hirist/v1/autocomplete — 1 credit
Hirist's search-box suggestions for the first letters of a skill or job title.

**Parameters:**
- `query` (string, required) — Start of a skill or job title.

**Returns:** suggestions[]

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

### POST https://api.reefapi.com/hirist/v1/categories — 0 credits
Hirist's 17 job categories with ids (for search, category-jobs, skills) and its 54 functional areas. No upstream call.

**Parameters:** none

**Returns:** categories[]{id, name} + functional_areas[]{id, name}

### POST https://api.reefapi.com/hirist/v1/locations — 0 credits
The 164 location ids Hirist filters by (Indian cities, states, metros, overseas regions, Remote), with the extra spellings the engine accepts. No upstream call.

**Parameters:** none

**Returns:** locations[]{id, name}, groups{metros, anywhere_in_india, overseas}, aliases{}

### POST https://api.reefapi.com/hirist/v1/clusters — 0 credits
The company clusters Hirist files employers under (Fortune 500, Start-ups, Banking, GCCs...) with ids for the company_cluster filter, and the sub-cluster labels jobs and companies carry. No upstream call.

**Parameters:** none

**Returns:** clusters[]{id,name}, sub_clusters[]{id,name}

### POST https://api.reefapi.com/hirist/v1/course-categories — 1 credit
Hirist Learning: the course categories with ids and the courses each one features.

**Parameters:** none

**Returns:** categories[]{id, name, featured_courses[]{course_id, title, institute, fee, duration, delivery_method, work_experience, url}}

### POST https://api.reefapi.com/hirist/v1/courses — 1 credit
Hirist Learning courses in one category (executive programmes, online MBAs, certificates): institute, fee, duration, delivery method, required experience, overview, eligibility and highlights.

**Parameters:**
- `category` (string, required) — Course category id from course-categories.
- `page` (integer, optional, default 1) — Result page.

**Returns:** courses[]{course_id, title, institute, fee, duration, delivery_method, work_experience, categories[], overview_text, desired_candidate_text, highlights_text, views} + total + meta.pagination

**Example request body:**
```json
{
  "category": 14
}
```

### POST https://api.reefapi.com/hirist/v1/course — 1 credit
One Hirist Learning course in full: fee, duration, delivery, experience band, registration and start dates, full details, curriculum highlights, units, schedule, study centre and candidate profile.

**Parameters:**
- `course_id` (string, required) — Course id (course_id from courses / course-categories).

**Returns:** course{course_id, title, institute, fee, duration, delivery_method, work_experience, details_text, highlights_text, desired_candidate_text, ...}

**Example request body:**
```json
{
  "course_id": 936
}
```

## 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=hirist
- Human docs page: https://reefapi.com/docs/hirist
- Overview page: https://reefapi.com/hirist-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
