> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Naukri Jobs API

> Pull details for a specified number of Naukri job postings, including title, company, and experience

`POST /v1/data/naukri/job/run`

**Pricing:** $0.002 per job ($2.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**inputs** `string` *required*

A search keyword (e.g. 'software developer') or a Naukri search URL to scrape job listings from.

Format e.g. `https://www.naukri.com/job-listings-data-analyst-qualitest-bengaluru-0-to-7-years-130826501142`.

**maxResults** `integer`

Number of jobs to return (minimum 50). Use 0 for all.

Min `50`.

**freshness** `string` (default: all)

Filter to recently-posted jobs.

Allowed values: `all` (All Time), `30` (Last 30 Days), `15` (Last 15 Days), `7` (Last 7 Days), `3` (Last 3 Days), `1` (Last 24 Hours).

**sortBy** `string` (default: relevance)

Sort order for results.

Allowed values: `relevance` (Relevance), `date` (Date).

**experience** `string` (default: all)

Required years of experience.

32 allowed values, for example `all` (All), `0` (0 Year), `1` (1 Year), `2` (2 Years), `3` (3 Years), `4` (4 Years), `5` (5 Years), `6` (6 Years), `7` (7 Years), `8` (8 Years). Fetch the full list with `GET /v1/data/naukri/job?expand=options`.

**workMode** `string[]`

Filter by work arrangement.

Allowed values: `office` (Work from Office), `temporary_wfh` (Temporary WFH), `remote` (Remote), `hybrid` (Hybrid).

**department** `string[]`

Filter by department.

37 allowed values, for example `1` (BFSI, Investments & Trading), `2` (Customer Success, Service & Operations), `3` (Data Science & Analytics), `4` (Engineering - Hardware & Networks), `5` (Engineering - Software & QA), `6` (Finance & Accounting), `7` (Human Resources), `8` (IT & Information Security), `9` (Marketing & Communication), `10` (Product Management). Fetch the full list with `GET /v1/data/naukri/job?expand=options`.

**salaryRange** `string[]`

Filter by salary band (Indian Lakhs per Annum).

Allowed values: `0to3` (0-3 Lakhs), `3to6` (3-6 Lakhs), `6to10` (6-10 Lakhs), `10to15` (10-15 Lakhs), `15to25` (15-25 Lakhs), `25to50` (25-50 Lakhs), `50to75` (50-75 Lakhs), `75to100` (75-100 Lakhs), `100to500` (1-5 Cr), `501` (5+ Cr).

**companyType** `string[]`

Filter by company type.

Allowed values: `213` (Foreign MNC), `211` (Corporate), `217` (Indian MNC), `62` (Startup), `63` (Others), `215` (Govt/PSU), `60` (MNC).

**roleCategory** `string[]`

Filter by job role.

164 allowed values, for example `1028` (Software Development), `1067` (Retail & B2C Sales), `1065` (BD / Pre Sales), `1027` (Quality Assurance and Testing), `1066` (Enterprise & B2B Sales), `1029` (Accounting & Taxation), `1025` (DBA / Data warehousing), `1167` (Other), `1072` (Other Design), `1016` (Voice / Blended). Fetch the full list with `GET /v1/data/naukri/job?expand=options`.

**industry** `string[]`

Filter by industry.

83 allowed values, for example `2` (BFSI), `101` (Analytics / KPO / Research), `102` (BPM / BPO), `103` (Electronic Components / Semiconductors), `104` (Electronics Manufacturing), `105` (Emerging Technologies), `107` (Hardware & Networking), `108` (Internet), `109` (IT Services & Consulting), `110` (Software Product). Fetch the full list with `GET /v1/data/naukri/job?expand=options`.

**topCompanies** `string[]`

Filter to specific top companies.

1083 allowed values, for example `242` (Bajaj Finance), `292` (Bikanervala), `314` (Blue Star), `788` (Eureka Forbes), `944` (Godrej & Boyce (G\&B)), `1240` (JSW Steel), `1288` (Capgemini), `1364` (LG Soft India), `1396` (LG Electronics India), `1422` (Randstad). Fetch the full list with `GET /v1/data/naukri/job?expand=options`.

**postedBy** `string[]`

Filter by who posted the listing.

Allowed values: `1` (Company Jobs), `2` (Consultant Jobs).

**stipend** `string[]`

Internship stipend range.

Allowed values: `unpaid` (Unpaid), `0To10` (0-10k), `10To20` (10k-20k), `20To30` (20k-30k), `30To40` (30k-40k), `40To50` (40k-50k), `50To1` (50k and above).

**duration** `string[]`

Internship duration.

Allowed values: `1` (1 Month), `2` (2 Months), `3` (3 Months), `4` (4 Months), `5` (5 Months), `6` (6 Months), `-1` (Flexible).

**ugCourse** `string[]`

Required undergraduate course.

Allowed values: `18` (Any Graduate), `11` (B.Tech/B.E.), `14` (Diploma), `10` (B.Sc), `17` (Graduation Not Required), `5` (B.Com), `3` (BCA), `4` (B.B.A / B.M.S), `1` (B.A), `13` (MBBS), `6` (B.Ed), `9` (B.Pharma), `12` (LLB), `2` (B.Arch), `8` (BHM), `16` (Other Graduate), `7` (BDS), `36` (BHMS), `40` (B.Des.), `35` (BAMS), `41` (BFA), `42` (B.U.M.S), `15` (BVSC), `37` (B.El.Ed), `38` (B.P.Ed).

**pgCourse** `string[]`

Required postgraduate course.

Allowed values: `19` (Any Postgraduate), `20` (Post Graduation Not Required), `13` (MBA/PGDM), `12` (M.Tech), `14` (MCA), `1` (CA), `11` (MS/M.Sc(Science)), `8` (M.Com), `15` (Medical-MS/MD), `16` (PG Diploma), `10` (M.Pharma), `6` (M.A), `5` (LLM), `3` (ICWA (CMA)), `9` (M.Ed), `2` (CS), `18` (Other), `37` (DM), `7` (M.Arch), `4` (Integrated PG), `38` (M.Ch), `36` (M.Des.), `34` (MDS), `17` (MVSC), `35` (MFA).

**cities** `string[]`

Filter results to specific cities.

**fetchDetails** `boolean` (default: false)

Pull full job description, requirements, etc. for each result. Slower but richer data.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/naukri/job/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "inputs": "data analyst",
    "maxResults": 50,
    "fetchDetails": true
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/naukri/job/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "inputs": "data analyst",
    "maxResults": 50,
    "fetchDetails": True
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/naukri/job/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "inputs": "data analyst",
  "maxResults": 50,
  "fetchDetails": true
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one job, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `jobUrl` | Job URL | url |
| `jobId` | Job ID | text |
| `jobTitle` | Job Title | text |
| `company` | Company | text |
| `companyId` | Company ID | text |
| `location` | Location | text |
| `minExperienceYrs` | Min Experience (Yrs) | number |
| `maxExperienceYrs` | Max Experience (Yrs) | number |
| `salaryMin` | Salary Min | currency |
| `salaryMax` | Salary Max | currency |
| `skills` | Skills | text |
| `description` | Description | text |
| `requirementsSummary` | Requirements Summary | text |
| `jobType` | Job Type | text |
| `posted` | Posted | text |
| `vacancies` | Vacancies | number |
| `views` | Views | number |
| `applicants` | Applicants | number |
| `applyUrl` | Apply URL | url |
| `appliesOnCompanySite` | Applies On Company Site | boolean |
| `hasQuestionnaire` | Has Questionnaire | boolean |
| `workplaceType` | Workplace Type | text |
| `hybridDetail` | Hybrid Detail | text |
| `industry` | Industry | text |
| `department` | Department | text |
| `roleCategory` | Role Category | text |
| `role` | Role | text |
| `educationUg` | Education UG | text |
| `educationPg` | Education PG | text |
| `listingSource` | Listing Source | text |
| `postedByConsultant` | Posted By Consultant | boolean |
| `hiringFor` | Hiring For | text |
| `companyDetails` | Company Details | object |
| `benchmarkRole` | Benchmark Role | text |
| `benchmarkMinCtcLakhs` | Benchmark Min CTC (Lakhs) | number |
| `benchmarkAvgCtcLakhs` | Benchmark Avg CTC (Lakhs) | number |
| `benchmarkMaxCtcLakhs` | Benchmark Max CTC (Lakhs) | number |
| `benchmarkSalariesUrl` | Benchmark Salaries URL | url |
| `benefits` | Benefits | text |
| `employeeReviews` | Employee Reviews | object\_array |
| `diversityTags` | Diversity Tags | text |
| `walkInJob` | Walk-In Job | boolean |
| `walkInVenue` | Walk-In Venue | text |
| `walkInStart` | Walk-In Start | text |
| `walkInEnd` | Walk-In End | text |
| `walkInTiming` | Walk-In Timing | text |
| `walkInContact` | Walk-In Contact | text |
| `walkInPhone` | Walk-In Phone | text |
| `referenceCode` | Reference Code | text |
| `internshipDuration` | Internship Duration | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "naukri/job",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "requirementsSummary": "3 Must Have Skills. Disclaimer: This job description has been sourced from a public domain and may have been modified by Naukri.com to improve clarity for ou...",
      "walkInEnd": null,
      "jobType": "Full Time",
      "industry": "IT Services & Consulting",
      "roleCategory": "Business Intelligence & Analytics",
      "jobTitle": "Data Analyst",
      "benchmarkMinCtcLakhs": 5,
      "hybridDetail": null,
      "walkInTiming": null,
      "walkInVenue": null,
      "walkInStart": null,
      "benchmarkMaxCtcLakhs": 7.1,
      "posted": "2026-08-13 16:15:12",
      "internshipDuration": null,
      "applicants": 4389,
      "jobId": "130826501142",
      "hasQuestionnaire": null,
      "department": "Data Science & Analytics",
      "referenceCode": "#23346",
      "walkInPhone": null,
      "applyUrl": "https://careers.quality-ai.com//job/Bangalore-Data-Analyst-560045/58791844/",
      "role": "Data Analyst",
      "employeeReviews": [
        {
          "title": "Software Engineer in Bengaluru",
          "rating": "4",
          "likes": "Work culture and work life balance",
          "dislikes": null,
          "date": "23 Mar 2026",
          "url": "https://www.ambitionbox.com/reviews/qualitest-reviews?rid=78745348&utm_source=naukri&utm_campaign=jd_reviews"
        },
        {
          "title": "Senior Software Engineer",
          "rating": "5",
          "likes": "Work from home with job security",
          "dislikes": null,
          "date": "24 Dec 2024",
          "url": "https://www.ambitionbox.com/reviews/qualitest-reviews?rid=64385982&utm_source=naukri&utm_campaign=jd_reviews"
        }
      ],
      "educationPg": "Any Postgraduate",
      "companyDetails": {
        "name": "Qualitest",
        "website": "https://www.qualitestgroup.com/",
        "logo": "https://img.naukimg.com/logo_images/groups/v1/4284722.gif",
        "jobsUrl": "https://www.naukri.com/qualitest-jobs-careers-24718",
        "about": "Qualitest is a global leader in software testing and quality assurance services, providing end-to-end solutions that help organizations deliver reliable digi...",
        "address": null,
        "hq": null,
        "naukriFollowers": 101938,
        "rating": 3.6,
        "reviewCount": 837,
        "reviewsUrl": "https://www.ambitionbox.com/reviews/qualitest-reviews"
      }
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.