# Naukri Jobs Scraper (`thenetaji/naukri-jobs-scraper`) Actor

Search Naukri.com by keyword and city, filter by experience, remote or hybrid work and posting age, and export each job with salary, skills, company rating and dates.

- **URL**: https://apify.com/thenetaji/naukri-jobs-scraper.md
- **Developed by:** [The Netaji](https://apify.com/thenetaji) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.85 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Naukri Jobs Scraper

The Actor searches Naukri.com, India's largest job board, by keyword and location and saves each matching job as one dataset row with its title, company, AmbitionBox rating, experience range, salary, skills, locations and posting time. Results arrive in Naukri's relevance order by default, and the experience, work mode and posting-age filters narrow a search the same way they do on Naukri itself.

```json
{
  "query": "python developer",
  "location": "Bangalore",
  "experienceYears": 3,
  "workMode": "hybrid",
  "postedWithinDays": "7",
  "sort": "relevance",
  "maxItems": 100
}
```

### Accepted input

- `query` is required: a job title, skill or keyword such as `python developer` or `chartered accountant`.
- `location` is optional and takes a city as Naukri spells it, for example `Bangalore`, `Mumbai` or `Delhi`.
- `experienceYears` keeps jobs open to a candidate with that many years of experience; it is empty by default, which means any experience.
- `workMode` accepts `any`, `office`, `remote` or `hybrid`; the default is `any`.
- `postedWithinDays` accepts `any`, `1`, `3`, `7`, `15` or `30`; the default is `any`.
- `sort` accepts `relevance` (the default) or `date` (newest first).
- `enrichJobDescription` adds each saved job's full posting to its row; it is off by default. See [Full postings](#full-postings).
- `page` is the first result page to read; it defaults to `1`.
- `maxItems` bounds the number of saved rows; it defaults to `100`, and `0` removes the bound.

### Response fields

Each row carries `job_id`, `title`, `url`, `company` (name, ID, logo, `rating` and `reviews_count` where Naukri shows them), `locations`, `work_mode` (`remote` or `hybrid` where the search row says so, otherwise empty; a full posting sets `office`, `remote` or `hybrid`), `experience` (`min_years`, `max_years`, `label`), `salary` (`min`, `max`, `currency`, `label`, `disclosed`), `skills`, `description_snippet`, `posted_at` as an ISO 8601 timestamp in India time, `posted_label` as Naukri prints it, `vacancies` and `is_walk_in`. Every row also records the `query`, `location` and `page` it was collected under, together with Naukri's own `total` for the search.

A salary that the employer hides is returned with `disclosed` set to `false` and `min` and `max` set to null, rather than as zero.

### Full postings

A search row carries what Naukri's results page shows. With `enrichJobDescription` on, the Actor also reads each saved job's own posting and adds `description_html`, `employment_type`, `role`, `role_category`, `department`, `industry`, `education`, `key_skills` (`preferred` and `other`), `applicants`, `views` and the company's `about`, `website` and `address`, and it replaces `work_mode` with the posting's own value. Each posting is a further request, so a run takes longer, and each posting read is billed as a separate event. A posting that has closed since the search keeps its search row unchanged and is not billed.

### Behaviour on large searches

Naukri serves 20 jobs per page and no more than 150 pages for one search, so a single search yields at most 3,000 jobs even when `total` reports tens of thousands. The run ends cleanly at that point. Splitting a broad search by `location`, `experienceYears` or `postedWithinDays` reaches further into the same pool.

### Notes on the results

**Why is relevance the default instead of newest first?**
Naukri matches a search more loosely in date order. On the first page of "python developer", relevance order had Python in the title or skills of all 20 jobs; date order had it in 9. Relevance pages can repeat a few jobs from the page before; the Actor saves each job once, so a repeat is neither saved nor charged twice.

**Why did a search for an unusual term return unrelated jobs?**
When Naukri cannot match a query it broadens it and returns recent jobs rather than an empty result, exactly as its own search page does. Some meaningless queries return nothing; others return a large unrelated list. The rows are what Naukri itself shows for that query, so a check of `title` or `skills` against the search term is advisable when queries are generated automatically.

**Is the salary always present?**
Only when the employer publishes it. Most postings in India show "Not disclosed", and those rows carry `disclosed: false`.

### Related Actors

Use [All-in-One Job Boards Scraper](https://apify.com/thenetaji/job-boards-all-in-one-scraper) to run Naukri searches alongside Dice, Seek and ZipRecruiter in one Actor.

# Actor input Schema

## `query` (type: `string`):

The job title, skill or keyword to search for. Used by the Dice, Seek and Naukri searches; the ZipRecruiter search takes no keyword at all and is driven by location alone.

## `location` (type: `string`):

Where to search, in the wording the board itself uses — a city, a state or a country. Left empty, each board returns whatever it serves a reader with no location set.

## `experienceYears` (type: `integer`):

Naukri only. Keep postings open to someone with this many years of experience. Leave empty for any.

## `workMode` (type: `string`):

Naukri only. Keep postings that are office-based, remote or hybrid.

## `postedWithinDays` (type: `string`):

Naukri only. Keep postings published within this many days.

## `sort` (type: `string`):

Naukri only. Relevance keeps to jobs that match the search, as on naukri.com. Newest first matches the search more loosely, so about half its jobs only partly fit.

## `enrichJobDescription` (type: `boolean`):

Reads each saved job's own posting and adds what a search row does not carry: the complete description, the preferred and other key skills, the required education, the role, department and industry, the employment type, the work mode for every job, the applicant and view counts, and the company's profile, website and address.

It costs one further request per job, so a run is slower with it on, and it is billed per posting read.

## `page` (type: `integer`):

Which page the search modes start from. Leave at 1 unless you are picking a run back up part-way through a result list.

## `maxItems` (type: `integer`):

Maximum number of rows to save. Set 0 for no limit.

## Actor input object example

```json
{
  "query": "python developer",
  "location": "Bangalore",
  "experienceYears": 3,
  "workMode": "any",
  "postedWithinDays": "any",
  "sort": "relevance",
  "enrichJobDescription": false,
  "page": 1,
  "maxItems": 20
}
```

# Actor output Schema

## `dataset` (type: `string`):

All records scraped by this run

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "python developer",
    "location": "Bangalore",
    "page": 1,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("thenetaji/naukri-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "python developer",
    "location": "Bangalore",
    "page": 1,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("thenetaji/naukri-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "python developer",
  "location": "Bangalore",
  "page": 1,
  "maxItems": 20
}' |
apify call thenetaji/naukri-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,thenetaji/naukri-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/QQGhgFaK7gazYjxda/builds/JgEGHNDZ7LRhl1gOy/openapi.json
