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

> Search iimjobs jobs (management, MBA and senior jobs in India) with the site's own filters: keywords, location, experience range, date posted, category, company cluster, industry. 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 `iimjobs` · 21 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/iimjobs/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/iimjobs/v1/search — 1 credit
Search iimjobs jobs (management, MBA and senior jobs in India) with the site's own filters: keywords, location, experience range, date posted, category, company cluster, industry. 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) — iimjobs job category, by id or name (13 Banking & Finance, 14 Sales & Marketing, 15 IT & Systems, 16 Consulting, 17 HR & IR, 19 SCM & Operations, 21 Legal, 22 BPO, 25 GenAI). 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).
- `industry` (array, optional) — iimjobs industry by id or name; several comma-separated. Includes the site's trending groups t-1 FinTech, t-2 Internet / Online Marketplaces, t-3 Ed-Tech, t-5 Delivery / Transport Tech, t-6 B2B SaaS. Ids: `industries` action.
- `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": "marketing"
}
```

### POST https://api.reefapi.com/iimjobs/v1/ai-search — 2 credits
iimjobs'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": "product manager in Bangalore with 5 years experience in fintech posted last week"
}
```

### POST https://api.reefapi.com/iimjobs/v1/detail — 2 credits
Full iimjobs 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) — iimjobs job id — job_id from any list, or the number at the end of https://www.iimjobs.com/j/<slug>-<id>. A job URL also works.
- `url` (string, optional) — A iimjobs 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": "1745715"
}
```

### POST https://api.reefapi.com/iimjobs/v1/similar-jobs — 2 credits
The jobs iimjobs 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 50 jobs (measured), no further pages; views/applications are null where the list carries the site's 0/0 filler.

**Parameters:**
- `job_id` (string, optional) — iimjobs job id — job_id from any list, or the number at the end of https://www.iimjobs.com/j/<slug>-<id>. A job URL also works.
- `url` (string, optional) — A iimjobs 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": "1745715"
}
```

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

**Parameters:**
- `category` (string, required) — iimjobs job category, by id or name (13 Banking & Finance, 14 Sales & Marketing, 15 IT & Systems, 16 Consulting, 17 HR & IR, 19 SCM & Operations, 21 Legal, 22 BPO, 25 GenAI).
- `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]
- `industry` (array, optional) — iimjobs industry by id or name; several comma-separated. Includes the site's trending groups t-1 FinTech, t-2 Internet / Online Marketplaces, t-3 Ed-Tech, t-5 Delivery / Transport Tech, t-6 B2B SaaS. Ids: `industries` action.
- `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
{
  "category": 14
}
```

### POST https://api.reefapi.com/iimjobs/v1/skill-jobs — 2 credits
Every open iimjobs job tagged with one skill (the site's /k/<skill>-jobs pages), with location, experience and date-posted filters plus industry, 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]
- `industry` (array, optional) — iimjobs industry by id or name; several comma-separated. Includes the site's trending groups t-1 FinTech, t-2 Internet / Online Marketplaces, t-3 Ed-Tech, t-5 Delivery / Transport Tech, t-6 B2B SaaS. Ids: `industries` action.
- `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": "marketing"
}
```

### POST https://api.reefapi.com/iimjobs/v1/women-jobs — 1 credit
iimjobs'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) — iimjobs job category, by id or name (13 Banking & Finance, 14 Sales & Marketing, 15 IT & Systems, 16 Consulting, 17 HR & IR, 19 SCM & Operations, 21 Legal, 22 BPO, 25 GenAI). 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/iimjobs/v1/company — 2 credits
iimjobs 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.iimjobs.com/company/<slug> (e.g. 'amgen'), 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": "amgen"
}
```

### POST https://api.reefapi.com/iimjobs/v1/company-jobs — 1 credit
Every open iimjobs 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.iimjobs.com/company/<slug> (e.g. 'amgen'), 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": "amgen"
}
```

### POST https://api.reefapi.com/iimjobs/v1/companies — 2 credits
iimjobs'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": "bank"
}
```

### POST https://api.reefapi.com/iimjobs/v1/recruiter — 1 credit
iimjobs 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": "259103"
}
```

### POST https://api.reefapi.com/iimjobs/v1/recruiter-jobs — 1 credit
Every open iimjobs 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": "259103"
}
```

### POST https://api.reefapi.com/iimjobs/v1/skills — 1 credit
Every skill tag iimjobs 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/iimjobs/v1/autocomplete — 1 credit
iimjobs'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": "marketing"
}
```

### POST https://api.reefapi.com/iimjobs/v1/categories — 0 credits
iimjobs's 9 job categories with ids (for search, category-jobs, skills). No upstream call.

**Parameters:** none

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

### POST https://api.reefapi.com/iimjobs/v1/locations — 0 credits
The 164 location ids iimjobs 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/iimjobs/v1/clusters — 0 credits
The company clusters iimjobs 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/iimjobs/v1/industries — 1 credit
iimjobs's industry list for the industry filter, live from the site (66 industries + the trending groups FinTech, Internet, Ed-Tech, Delivery/Transport Tech, B2B SaaS).

**Parameters:** none

**Returns:** industries[]{id, name}, trending[]{id, name}

### POST https://api.reefapi.com/iimjobs/v1/course-categories — 1 credit
iimjobs 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/iimjobs/v1/courses — 1 credit
iimjobs 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/iimjobs/v1/course — 1 credit
One iimjobs 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": 2921
}
```

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