Skip to content
Scrappa Get API key
Naukri API 1 credit/request

Naukri Job Search API Documentation

GET https://scrappa.co/api/naukri/search

Naukri Job Search API Documentation Search public Naukri job listings by keyword and location with experience, salary band, work mode and posting age filters. Each job returns id, title, public url, company, experience range, locations, skills, posting date (ISO 8601, UTC), a plain text description snippet and, when disclosed, the salary in INR and the company rating. Page with page and per_page; total and has_more describe the full result. A valid search with zero results is a successful response.

Naukri Job Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/naukri/search
Auth header
x-api-key
Cost
1 credit/request
keyword = running shoes
Response preview
200 OK
{
    "data": {
        "jobs": [
            {
                "id": "100926933981",
                "url": "https://www.naukri.com/job-listings-python-developer-infosys-hyderabad-pune-bengaluru-2-to-5-years-100926933981",
                "title": "Python Developer",
                "rating": {
                    "value": 3.5,
                    "reviews": 53243
                },
                "skills": [
                    "Python",
                    "Css",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

8 optional filters available.

keyword string Required

Job title, skill or company to search for. Example: python developer.

Example value running shoes
location string Optional

City or region in India. Omit to search all of India. Example: bangalore.

Example value Austin, Texas
experience integer Optional

Candidate experience in years, 0 to 30.

Example value 10
salary string Optional

Salary band in lakhs per year. One of 0to3, 3to6, 6to10, 10to15, 15to25, 25to50, 50to75, 75to100. Repeat the parameter for several bands, e.g. salary[]=6to10&salary[]=10to15.

Example value example
posted_within_days integer Optional

Only jobs posted in the last N days, 1 to 90.

Example value 10
sort string Optional

relevance (default) or date.

Example value relevance
work_mode string Optional

office, hybrid or remote.

Example value example
page integer Optional

Page number starting at 1, up to 150. Defaults to 1.

Example value 1
per_page integer Optional

Jobs per page, 1 to 50. Defaults to 20.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "jobs": [
            {
                "id": "100926933981",
                "url": "https://www.naukri.com/job-listings-python-developer-infosys-hyderabad-pune-bengaluru-2-to-5-years-100926933981",
                "title": "Python Developer",
                "rating": {
                    "value": 3.5,
                    "reviews": 53243
                },
                "skills": [
                    "Python",
                    "Css",
                    "Postgresql",
                    "Artificial Intelligence",
                    "Data Structures",
                    "Natural Language Processing",
                    "Html",
                    "Machine Learning"
                ],
                "company": {
                    "id": 410527,
                    "name": "Infosys"
                },
                "logo_url": "https://img.naukimg.com/logo_images/groups/v1/mobile/13832.gif",
                "position": 1,
                "locations": [
                    "Hyderabad",
                    "Pune",
                    "Bengaluru"
                ],
                "posted_at": "2026-10-14T04:14:11Z",
                "experience": {
                    "text": "2-5 Yrs",
                    "max_years": 5,
                    "min_years": 2
                },
                "description_snippet": "Bachelor of Engineering,Bachelor Of Technology,Bachelor Of Science,Bachelor Of Comp Preferred Skills: . Technology->Testing Technologyes->Test Automation Technology. Technology->Java->Core Java. Technology->OpenSystem->Python - OpenSystem->Python"
            },
            {
                "id": "151026032431",
                "url": "https://www.naukri.com/job-listings-python-developer-hatchtra-innotech-pune-bengaluru-mumbai-all-areas-3-to-8-years-151026032431",
                "title": "Python Developer",
                "skills": [
                    "Python Development",
                    "CSS",
                    "Javascript",
                    "HTML",
                    "Python",
                    "SQL",
                    "Cs",
                    "Development"
                ],
                "company": {
                    "id": 6123580,
                    "name": "Hatchtra Innotech"
                },
                "logo_url": "https://img.naukimg.com/logo_images/groups/v1/mobile/9958226.gif",
                "position": 2,
                "locations": [
                    "Hybrid - Pune",
                    "Bengaluru",
                    "Mumbai (All Areas)"
                ],
                "posted_at": "2026-10-15T13:24:28Z",
                "experience": {
                    "text": "3-8 Yrs",
                    "max_years": 8,
                    "min_years": 3
                },
                "description_snippet": "Were Hiring: Python Developers (30+ Openings | 3 - 20 Yrs Exp | Multiple Levels) Location: Pune / Mumbai / Bengaluru / Hyderabad / Gurugram / Chandigarh / Chennai * Specific location and work model may vary by positions and roles. Industry: Fortune 500 Client Projects (Staffing via Hatchtra) Employ\u2026"
            }
        ],
        "page": 1,
        "total": 3797,
        "has_more": true,
        "per_page": 2
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required query parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "keyword": [
            "A search keyword is required, e.g. python developer."
        ]
    },
    "message": "The request validation failed"
}
503

Invalid Source Response

The upstream answered with a shape that no longer matches the documented contract. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "PARSER_DRIFT",
        "message": "The Naukri API is temporarily unavailable. Please retry."
    },
    "success": false
}
503

Service Unavailable

The upstream service is temporarily unavailable. Please retry shortly.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Naukri API is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.