{ "openapi": "3.0.1", "info": { "title": "Naukri Jobs Scraper - Salary, Skills, Applicants & Details", "description": "Scrape Naukri.com jobs: title, company, experience, salary in LPA, locations, work mode, skills, posted date, full description, applicants, views, education, walk-in venue and AmbitionBox rating. Naukri's filters, company job lists, search URLs, job ids, monitor mode. No login.", "version": "0.1", "x-build-id": "ona8M6ilju6T7JHio" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~naukri-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-naukri-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapersdelight~naukri-jobs-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-naukri-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapersdelight~naukri-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-naukri-jobs-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Job titles, skills or designations, e.g. \"data analyst\", \"python developer\", \"sales\". Empty with a location = every job in that location.", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Indian cities or areas, e.g. \"Bengaluru\", \"Pune\", \"Delhi / NCR\", \"Remote\". Empty or \"India\" = all of India. A place Naukri does not recognise is reported in the run summary and returns nothing (never all-India rows).", "items": { "type": "string" } }, "companies": { "title": "Companies", "type": "array", "description": "List every job of a company: its Naukri jobs page (e.g. https://www.naukri.com/hexaware-technologies-jobs-careers-9815), its overview page (…-overview-12466), a company group id (12466 - the groupId field on every row) or a company name (\"Infosys\").", "items": { "type": "string" } }, "startUrls": { "title": "Naukri URLs", "type": "array", "description": "Search result pages copied from your browser (every filter on the page is kept), company pages, or job pages (https://www.naukri.com/job-listings-…-160126029546).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "jobIds": { "title": "Job ids", "type": "array", "description": "Naukri job ids (12+ digits, the jobId field), e.g. \"160126029546\". Each one returns the full job page.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the results.", "default": "relevance" }, "postedWithinDays": { "title": "Posted within", "enum": [ "0", "1", "3", "7", "15", "30" ], "type": "string", "description": "Freshness filter (Naukri's jobAge).", "default": "0" }, "experienceYears": { "title": "Your experience (years)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Jobs whose experience range includes this many years, e.g. 5 matches \"3-8 Yrs\". Empty = any." }, "workModes": { "title": "Work mode", "uniqueItems": true, "type": "array", "description": "One or more work modes.", "items": { "type": "string", "enum": [ "office", "hybrid", "remote", "temporary_wfh" ], "enumTitles": [ "Work from office", "Hybrid", "Remote", "Temporary WFH" ] } }, "salaryRanges": { "title": "Salary (lakhs per year)", "uniqueItems": true, "type": "array", "description": "Naukri's salary bands (annual CTC).", "items": { "type": "string", "enum": [ "0to3", "3to6", "6to10", "10to15", "15to25", "25to50", "50to75", "75to100", "100to500", "501" ], "enumTitles": [ "0-3 Lakhs", "3-6 Lakhs", "6-10 Lakhs", "10-15 Lakhs", "15-25 Lakhs", "25-50 Lakhs", "50-75 Lakhs", "75-100 Lakhs", "1-5 Crore", "5+ Crore" ] } }, "postedBy": { "title": "Posted by", "uniqueItems": true, "type": "array", "description": "Jobs posted by the employer, by recruitment consultants, or both.", "items": { "type": "string", "enum": [ "company", "consultant" ], "enumTitles": [ "Company jobs", "Consultant jobs" ] } }, "companyTypes": { "title": "Company type", "uniqueItems": true, "type": "array", "description": "Employer types as Naukri classifies them.", "items": { "type": "string", "enum": [ "corporate", "foreign_mnc", "indian_mnc", "startup", "govt_psu", "mnc", "others" ], "enumTitles": [ "Corporate", "Foreign MNC", "Indian MNC", "Startup", "Govt/PSU", "MNC", "Others" ] } }, "walkInOnly": { "title": "Walk-in jobs only", "type": "boolean", "description": "Only walk-in drives (venue, dates, timings and the contact person come with each job).", "default": false }, "walkInWhen": { "title": "Walk-in date", "uniqueItems": true, "type": "array", "description": "When the walk-in drive takes place (use with Walk-in jobs only).", "items": { "type": "string", "enum": [ "this_week", "next_week", "this_month" ], "enumTitles": [ "This week", "Next week", "This month" ] } }, "freshersCampusOnly": { "title": "Fresher / campus jobs only", "type": "boolean", "description": "Naukri's campus filter (jobs for freshers and recent graduates).", "default": false }, "internshipStipends": { "title": "Internship stipend", "uniqueItems": true, "type": "array", "description": "Internships with this stipend (restricts the search to internships).", "items": { "type": "string", "enum": [ "unpaid", "0To10", "10To20", "20To30", "30To40", "40To50", "50To1" ], "enumTitles": [ "Unpaid", "0-10k / month", "10k-20k / month", "20k-30k / month", "30k-40k / month", "40k-50k / month", "50k and above" ] } }, "internshipDurations": { "title": "Internship duration", "uniqueItems": true, "type": "array", "description": "Internships of this length (restricts the search to internships).", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "-1" ], "enumTitles": [ "1 month", "2 months", "3 months", "4 months", "5 months", "6 months", "Flexible" ] } }, "cityIds": { "title": "City ids", "type": "array", "description": "Naukri city ids for an exact city filter, e.g. 97 = Bengaluru, 17 = Hyderabad, 9508 = Delhi / NCR, 139 = Pune, 183 = Chennai.", "items": { "type": "string" } }, "departmentIds": { "title": "Department ids", "type": "array", "description": "Naukri department (functional area) ids, e.g. 5 = Engineering - Software & QA.", "items": { "type": "string" } }, "industryIds": { "title": "Industry ids", "type": "array", "description": "Naukri industry ids, e.g. 109 = IT Services & Consulting.", "items": { "type": "string" } }, "roleCategoryIds": { "title": "Role category ids", "type": "array", "description": "Naukri role category ids (the roleCategoryId field), e.g. 1028 = Software Development.", "items": { "type": "string" } }, "roleIds": { "title": "Role ids", "type": "array", "description": "Naukri role ids (from a Naukri search URL's roleTypeFilterGid).", "items": { "type": "string" } }, "ugCourseIds": { "title": "UG course ids", "type": "array", "description": "Undergraduate course ids, e.g. 9502 = Any Graduate.", "items": { "type": "string" } }, "pgCourseIds": { "title": "PG course ids", "type": "array", "description": "Postgraduate course ids, e.g. 9511 = Any Postgraduate.", "items": { "type": "string" } }, "topCompanyIds": { "title": "Top company ids", "type": "array", "description": "Naukri's \"Top companies\" filter: company group ids (the groupId field), e.g. 242.", "items": { "type": "string" } }, "extraSearchParams": { "title": "Extra Naukri search parameters", "type": "array", "description": "Any other parameter of Naukri's search API, as [{\"key\": \"functionAreaIdGid\", \"value\": \"5\"}]. Applied to every keyword, location and company search." }, "titleKeywords": { "title": "Title must contain", "type": "array", "description": "Keep a job only if its title contains one of these words, e.g. \"senior\", \"lead\".", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude words", "type": "array", "description": "Drop a job whose title, company, snippet or skills contain one of these words, e.g. \"intern\", \"night shift\".", "items": { "type": "string" } }, "excludeCompanies": { "title": "Exclude companies", "type": "array", "description": "Drop jobs from companies whose name contains one of these, e.g. \"Infosys\".", "items": { "type": "string" } }, "onlyWithSalary": { "title": "Only jobs that show a salary", "type": "boolean", "description": "Drop jobs whose salary is \"Not disclosed\" (internships with a stipend are kept).", "default": false }, "minAmbitionBoxRating": { "title": "Minimum AmbitionBox rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only companies rated at least this on AmbitionBox, e.g. 3.5. 0 = no filter.", "default": 0 }, "includeDetails": { "title": "Include job page details", "type": "boolean", "description": "Read each job's page (one extra request per job, same price per job). Turn off for faster search-card rows.", "default": true }, "monitorMode": { "title": "Monitor mode (only new jobs)", "type": "boolean", "description": "Remember delivered jobs in a named store and skip them on later runs; changeType says NEW or UPDATED.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Name of the key-value store that remembers delivered jobs. Use one name per tracked search. Default: naukri-jobs-monitor." }, "includeUnchanged": { "title": "Also deliver unchanged jobs", "type": "boolean", "description": "In monitor mode, also deliver (and pay for) jobs seen before that did not change, marked UNCHANGED.", "default": false }, "notifyOnlyChanges": { "title": "Notify only new/updated jobs", "type": "boolean", "description": "Notifications list only NEW and UPDATED jobs (monitor mode).", "default": false }, "notificationLimit": { "title": "Jobs per notification", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many jobs each notification lists.", "default": 5 }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "Post a summary of the delivered jobs to Slack." }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Post a summary of the delivered jobs to Discord." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Bot token from @BotFather (use with Telegram chat id)." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Chat, group or channel id to message." }, "whatsappAccessToken": { "title": "WhatsApp access token", "type": "string", "description": "WhatsApp Cloud API access token." }, "whatsappPhoneNumberId": { "title": "WhatsApp phone number id", "type": "string", "description": "WhatsApp Cloud API phone number id." }, "whatsappTo": { "title": "WhatsApp recipient", "type": "string", "description": "Recipient number in international format, e.g. 919812345678." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST a JSON summary (and the first jobs) to any URL." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Extra headers for the webhook, e.g. {\"Authorization\": \"Bearer …\"}." }, "maxResults": { "title": "Max jobs", "minimum": 0, "type": "integer", "description": "Maximum jobs for the whole run. Naukri pages up to ~15,000 jobs per search (100 per page, ~150 pages). 0 = no limit.", "default": 100 }, "maxResultsPerSearch": { "title": "Max jobs per search", "minimum": 0, "type": "integer", "description": "Cap for each keyword x location / company search, so one big search does not use the whole run. 0 = no per-search cap.", "default": 0 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 0, "maximum": 150, "type": "integer", "description": "Stop each search after this many result pages (up to 100 jobs each). 0 = until the end.", "default": 0 }, "descriptionFormat": { "title": "Description format", "enum": [ "all", "html", "text", "markdown", "none" ], "type": "string", "description": "Which forms of the full job description each row carries.", "default": "all" }, "descriptionMaxLength": { "title": "Description max length", "minimum": 0, "type": "integer", "description": "Cut descriptions to this many characters (… appended). 0 = full length.", "default": 0 }, "compact": { "title": "Compact rows", "type": "boolean", "description": "Core fields only (id, link, title, company, location, work mode, experience, salary, skills, posted, apply) - small rows for AI agents and spreadsheets.", "default": false }, "excludeEmptyFields": { "title": "Drop empty fields", "type": "boolean", "description": "Leave out null and empty fields from each row.", "default": false }, "includeRawData": { "title": "Include raw Naukri data", "type": "boolean", "description": "Add Naukri's own search card (raw) and job page (rawJobPage) objects to each row.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Job pages read in parallel.", "default": 6 }, "maxRequestsPerSecond": { "title": "Max requests per second", "minimum": 1, "maximum": 20, "type": "integer", "description": "Pace for all requests to Naukri. Naukri blocks an IP that sends too many requests too fast; 8 per second has been safe.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: the actor connects directly and falls back to Indian residential proxies by itself if Naukri refuses. Add your own proxy URLs to use them first." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }