# Instahyre API — India tech jobs from instahyre.com: search jobs by skill or title, city (Bangalore, Delhi / NCR, Hyderabad, Pune, Mumbai, remote…), years of experience, experience level, full-time or internship, company size, job function, category, industry and company; full job ads with description, experience band, skills, recruiter, posting date and internship stipend; employer pages with ratings, benefits, tech stack, socials, photos and every open job; similar jobs, company and skill suggestions, filter lists — no login

> Search Instahyre jobs (India tech and business roles) with every filter the site's search has: skills or title, location (cities, regions, remote, countries), years of experience, experience level, full-time / internship, company size, job function, job category, industry and company. 35 jobs per page with the exact total and the site's facet counts; an Instahyre search or job-listing link works too.
> ReefAPI engine `instahyre` · 12 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/instahyre/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/instahyre/v1/search — 1 credit
Search Instahyre jobs (India tech and business roles) with every filter the site's search has: skills or title, location (cities, regions, remote, countries), years of experience, experience level, full-time / internship, company size, job function, job category, industry and company. 35 jobs per page with the exact total and the site's facet counts; an Instahyre search or job-listing link works too.

**Parameters:**
- `keywords` (array, optional) — Skills or job title — Instahyre's 'Skills or Title' box (e.g. python, react, 'data scientist'). Several values = jobs matching ANY of them. Optional: empty lists every job matching the other filters.
- `url` (string, optional) — An Instahyre search link (instahyre.com/search-jobs/?skills=…) or a job-listing page (…/python-jobs-in-bangalore/, …/jobs-in-pune/, …/work-from-home-jobs/). Its filters are used; other params you pass are added on top.
- `location` (array, optional) — City, region or country from Instahyre's location picker: Bangalore (Bengaluru works), Gurgaon (Gurugram works), Delhi / NCR, Pune, Hyderabad, Mumbai, Chennai, Noida…, 'Work From Home' (or 'remote'), 'Anywhere in India', North/South/East/West India, 'Anywhere outside India', or a country (Singapore, United States…). Several = any of them. Unknown names are refused with the closest values; the full list is the locations action.
- `experience_years` (integer, optional) — The candidate's years of experience: keeps the jobs whose experience band admits it (0 = jobs open to freshers). The site's slider.
- `experience_level` (enum, optional) — Instahyre's experience-level band (one value; the site takes only one). [one of: internship, entry_level, associate, mid_senior, senior]
- `job_type` (enum, optional, default "all") — Full-time jobs, internships, or both (default). [one of: all, full_time, internship]
- `company_size` (enum, optional) — Employer size as Instahyre groups it (Small / Medium / Large). [one of: small, medium, large]
- `job_function` (array, optional) — Job function id, slug or name (e.g. 10, backend-development, 'Backend Development'). Several = any. 107 functions — see the job-functions action.
- `job_category` (array, optional) — Job category id or name (e.g. 1 = Software Engineering, 8 = Data Science & Analytics). Several = any. See the job-functions action.
- `industry` (array, optional) — Employer industry id or name (e.g. 13 = Computer Software / IT / Internet). Several = any. See the industries action.
- `company` (array, optional) — Company name as Instahyre lists it (e.g. Amazon, Deloitte). Several = any. Instahyre matches the name family: 'Amazon' also returns Amazon Ads / Amazon Web Services rows.
- `page` (integer, optional, default 1) — Result page, 35 jobs each (the site's fixed page size). Instahyre serves the first 10,000 results of a search, so page 285 is the last.

**Returns:** total, total_is_exact, page, per_page, last_page, has_next, jobs[{job_id, url, title, candidate_title, locations[], skills[], accepts_other_cities, gender_preference, is_sourced, external_apply_url, company{company_id, name, tagline, founded_year, employee_count{code,label,min,max}, about, about_short, logo_url, is_diversity_employer, is_featured_employer}}], facets{job_type, company_size, top_job_functions[], top_industries[], top_companies[], top_locations[], experience_level_sitewide}

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

### POST https://api.reefapi.com/instahyre/v1/stats — 1 credit
How many Instahyre jobs match a search, broken down the way the site's filter panel shows it: full-time vs internship, company size, top job functions, top industries, top companies, top locations (same filters as search, no job rows).

**Parameters:**
- `keywords` (array, optional) — Skills or job title — Instahyre's 'Skills or Title' box (e.g. python, react, 'data scientist'). Several values = jobs matching ANY of them. Optional: empty lists every job matching the other filters.
- `url` (string, optional) — An Instahyre search link (instahyre.com/search-jobs/?skills=…) or a job-listing page (…/python-jobs-in-bangalore/, …/jobs-in-pune/, …/work-from-home-jobs/). Its filters are used; other params you pass are added on top.
- `location` (array, optional) — City, region or country from Instahyre's location picker: Bangalore (Bengaluru works), Gurgaon (Gurugram works), Delhi / NCR, Pune, Hyderabad, Mumbai, Chennai, Noida…, 'Work From Home' (or 'remote'), 'Anywhere in India', North/South/East/West India, 'Anywhere outside India', or a country (Singapore, United States…). Several = any of them. Unknown names are refused with the closest values; the full list is the locations action.
- `experience_years` (integer, optional) — The candidate's years of experience: keeps the jobs whose experience band admits it (0 = jobs open to freshers). The site's slider.
- `experience_level` (enum, optional) — Instahyre's experience-level band (one value; the site takes only one). [one of: internship, entry_level, associate, mid_senior, senior]
- `job_type` (enum, optional, default "all") — Full-time jobs, internships, or both (default). [one of: all, full_time, internship]
- `company_size` (enum, optional) — Employer size as Instahyre groups it (Small / Medium / Large). [one of: small, medium, large]
- `job_function` (array, optional) — Job function id, slug or name (e.g. 10, backend-development, 'Backend Development'). Several = any. 107 functions — see the job-functions action.
- `job_category` (array, optional) — Job category id or name (e.g. 1 = Software Engineering, 8 = Data Science & Analytics). Several = any. See the job-functions action.
- `industry` (array, optional) — Employer industry id or name (e.g. 13 = Computer Software / IT / Internet). Several = any. See the industries action.
- `company` (array, optional) — Company name as Instahyre lists it (e.g. Amazon, Deloitte). Several = any. Instahyre matches the name family: 'Amazon' also returns Amazon Ads / Amazon Web Services rows.

**Returns:** total, total_is_exact, facets{…} (search's facets)

**Example request body:**
```json
{
  "url": "https://www.instahyre.com/python-jobs-in-bangalore/"
}
```

### POST https://api.reefapi.com/instahyre/v1/detail — 2 credits
Full Instahyre job ad: title, company, locations with state and country, experience band (min-max years), skills, job category and functions, full description (HTML + text), posting date, employment type, active / closed, recruiter (name, designation, photo), internship stipend and duration, and (include_company) the employer's profile with ratings, benefits and tech stack. Instahyre publishes no salary for full-time jobs.

**Parameters:**
- `job` (string, required) — Instahyre job id (441980) or job link (https://www.instahyre.com/job-441980-python-developer-at-nineleaps-2-bangalore/).
- `include_company` (boolean, optional, default true) — Add the employer's profile (company action fields, without its job list). false = one request less.

**Returns:** job{job_id, url, title, candidate_title, is_active, is_internship, employment_type, date_posted, valid_through, locations[], location_details[{city, region, country}], experience{min_years, max_years}, salary (always null — not published), skills[], job_category, job_functions[{id,name}], job_functions_by_category, description_html, description_text, accepts_other_cities, gender_preference, is_sourced, internship{stipend_inr_per_month, stipend_hidden, is_paid, duration_months, start_date}, recruiter{name, designation, company_name, photo_url}, company{company_id, name, logo_url, website}} + company_profile (include_company)

**Example request body:**
```json
{
  "job": "441980"
}
```

### POST https://api.reefapi.com/instahyre/v1/similar-jobs — 1 credit
The jobs Instahyre lists as similar to a job ad (10, the site's fixed number).

**Parameters:**
- `job` (string, required) — Instahyre job id (441980) or job link (https://www.instahyre.com/job-441980-python-developer-at-nineleaps-2-bangalore/).

**Returns:** job_id, jobs[{job_id, url, title, candidate_title, locations[], company{company_id, name, logo_url}}]

**Example request body:**
```json
{
  "job": "441980"
}
```

### POST https://api.reefapi.com/instahyre/v1/company — 2 credits
Instahyre employer page: name, tagline, founding year, size band, industries, headquarters, website and social links, about / why-us / interview-process text, tech stack, benefits, employee ratings (overall, work-life balance, salary & benefits, culture, career growth, diversity, recommend), office photos, press coverage, open-jobs total, jobs per department, and its open jobs with full descriptions (paged).

**Parameters:**
- `company` (string, required) — Employer id (377), company page link (https://www.instahyre.com/jobs-at-amazon/), its slug (amazon / jobs-at-amazon) or the company name (resolved through Instahyre's own company suggestions; exact name match).
- `jobs_page` (integer, optional, default 1) — Page of the company's own job list.
- `jobs_per_page` (integer, optional, default 10) — Jobs per page, 0-50 (the page itself shows 10; 0 = profile only).

**Returns:** company{company_id, slug, url, name, tagline, logo_url, founded_year, employee_count, industries[], locations[], website, social{}, about_*, why_us_*, interview_process_*, tech_stack[], benefits[], ratings{overall, work_life_balance, salary_and_benefits, company_culture, career_growth, diversity_and_inclusion, recommend_to_friends}, office_photos[], media_coverage[], video_link, is_diversity_employer, is_featured_employer, open_jobs_total, jobs_search_count, job_categories[], jobs[] (with description)}

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

### POST https://api.reefapi.com/instahyre/v1/company-jobs — 2 credits
Every open job of one company through Instahyre's job search (the page's 'view all jobs'), with the search filters, the exact total and 35 jobs per page. Rows from same-name sibling employers (Amazon → Amazon Ads) are kept and flagged.

**Parameters:**
- `company` (string, required) — Employer id (377), company page link (https://www.instahyre.com/jobs-at-amazon/), its slug (amazon / jobs-at-amazon) or the company name (resolved through Instahyre's own company suggestions; exact name match).
- `keywords` (array, optional) — Skills or job title — Instahyre's 'Skills or Title' box (e.g. python, react, 'data scientist'). Several values = jobs matching ANY of them. Optional: empty lists every job matching the other filters.
- `location` (array, optional) — City, region or country from Instahyre's location picker: Bangalore (Bengaluru works), Gurgaon (Gurugram works), Delhi / NCR, Pune, Hyderabad, Mumbai, Chennai, Noida…, 'Work From Home' (or 'remote'), 'Anywhere in India', North/South/East/West India, 'Anywhere outside India', or a country (Singapore, United States…). Several = any of them. Unknown names are refused with the closest values; the full list is the locations action.
- `experience_years` (integer, optional) — The candidate's years of experience: keeps the jobs whose experience band admits it (0 = jobs open to freshers). The site's slider.
- `experience_level` (enum, optional) — Instahyre's experience-level band (one value; the site takes only one). [one of: internship, entry_level, associate, mid_senior, senior]
- `job_type` (enum, optional, default "all") — Full-time jobs, internships, or both (default). [one of: all, full_time, internship]
- `company_size` (enum, optional) — Employer size as Instahyre groups it (Small / Medium / Large). [one of: small, medium, large]
- `job_function` (array, optional) — Job function id, slug or name (e.g. 10, backend-development, 'Backend Development'). Several = any. 107 functions — see the job-functions action.
- `job_category` (array, optional) — Job category id or name (e.g. 1 = Software Engineering, 8 = Data Science & Analytics). Several = any. See the job-functions action.
- `industry` (array, optional) — Employer industry id or name (e.g. 13 = Computer Software / IT / Internet). Several = any. See the industries action.
- `page` (integer, optional, default 1) — Result page, 35 jobs each (the site's fixed page size). Instahyre serves the first 10,000 results of a search, so page 285 is the last.

**Returns:** total, total_is_exact, page, per_page, last_page, has_next, jobs[{job_id, url, title, candidate_title, locations[], skills[], accepts_other_cities, gender_preference, is_sourced, external_apply_url, company{company_id, name, tagline, founded_year, employee_count{code,label,min,max}, about, about_short, logo_url, is_diversity_employer, is_featured_employer}}], facets{job_type, company_size, top_job_functions[], top_industries[], top_companies[], top_locations[], experience_level_sitewide} + company{company_id, name} + rows' is_this_company

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

### POST https://api.reefapi.com/instahyre/v1/company-search — 1 credit
Find Instahyre employers by name (the site's own company suggestions) → company_id for the company actions.

**Parameters:**
- `query` (string, required) — Company name or its beginning.
- `limit` (integer, optional, default 5) — Max suggestions (Instahyre answers at most 5 companies; measured on 'amaz', 'tata', 'infos').

**Returns:** companies[{company_id, name, name_nopunc, alternate_names_nopunc[]}]

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

### POST https://api.reefapi.com/instahyre/v1/autocomplete — 1 credit
Instahyre's search-box suggestions: skills (with alternate spellings), companies (with id), or locations (the site's picker values with alternate names).

**Parameters:**
- `query` (string, required) — What has been typed so far.
- `type` (enum, optional, default "skills") — What to suggest. [one of: skills, companies, locations]
- `limit` (integer, optional, default 10) — Max suggestions (Instahyre itself answers at most 5 companies; skills and locations can be more).

**Returns:** type, suggestions[]

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

### POST https://api.reefapi.com/instahyre/v1/job-functions — 0 credits
Every Instahyre job function (id, slug, name) grouped in its job category — the values the job_function / job_category filters take.

**Parameters:** none

**Returns:** job_functions[{id, slug, name, is_live, category{id, name, is_tech}}], job_categories[]

### POST https://api.reefapi.com/instahyre/v1/industries — 0 credits
Every Instahyre industry (id, name) — the values the industry filter takes.

**Parameters:** none

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

### POST https://api.reefapi.com/instahyre/v1/locations — 0 credits
Instahyre's location picker: remote, regions, every Indian city by state and the international locations, with alternate spellings — the values the location filter takes.

**Parameters:** none

**Returns:** locations[{value, name, group, alternate_names[], country_code}], groups[]

### POST https://api.reefapi.com/instahyre/v1/filters — 0 credits
The fixed filter values of Instahyre search (job type, company size, experience level) and the employee-count bands, with the site's labels.

**Parameters:** none

**Returns:** job_type[], company_size[], experience_level[], employee_count_bands[], limits{}

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