{ "openapi": "3.0.1", "info": { "title": "Naukri Jobs Scraper", "description": "Scrape Naukri.com job listings from India with title, company, location, salary, experience, skills, description, and apply URL. MCP-ready.", "version": "1.0", "x-build-id": "NsWW7zrvqzMlBWcco" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~naukri-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~naukri-jobs-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~naukri-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": { "keyword": { "title": "Keyword", "type": "string", "description": "Use this when you want to search Naukri by role, skill, or title. Enter a query such as 'software engineer', 'data analyst', or 'sales manager'. Defaults to 'software engineer'. This is not a Naukri URL, paste URLs into Start URLs instead.", "default": "software engineer" }, "location": { "title": "Location", "type": "string", "description": "Use this to restrict the Naukri search to a city, region, or remote-style location phrase. Enter values like 'bengaluru', 'mumbai', 'delhi ncr', or 'remote'. Defaults to 'bengaluru'. Leave empty to search all locations.", "default": "bengaluru" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Use this when you already have Naukri search-result pages or job-detail URLs to scrape. Accepts links from naukri.com search pages and /job-listings- detail pages. When provided, Keyword, Location, Experience, and Date posted are ignored for the first page. Do not paste non-Naukri URLs here.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "experience": { "title": "Experience", "enum": [ "any", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15" ], "type": "string", "description": "Use this to filter jobs by required years of experience. Choose 'any' or a starting year from 0 to 15, matching Naukri's search filter. Defaults to 'any'. This is not the extracted experience field returned in each job record.", "default": "any" }, "jobAge": { "title": "Date posted", "enum": [ "any", "1", "3", "7", "15", "30" ], "type": "string", "description": "Use this to restrict results to recently posted jobs. Allowed values are 'any', '1', '3', '7', '15', and '30', representing days back on Naukri search. Defaults to 'any'. This is a search filter, not the returned postedAgo text.", "default": "any" }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Use this to cap how many job postings the actor returns and bills for. Defaults to 50 and stops cleanly when the limit is reached. One returned job costs $0.006 plus the tiny run-start event. Do not use this as a page count.", "default": 50 }, "enrichDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Use this when you need the richest detail-page description and structured fields. Defaults to false because Naukri's search API often returns enough data and detail pages cost more browser time. Enable it for smaller, high-value runs. It does not change the per-job PPE price.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use this to control the proxy used for Naukri requests. Defaults to Apify Residential proxies in India because Naukri is protected by Akamai and commonly blocks datacenter traffic. Keep the default unless you know your proxy can pass Naukri. This is not an authentication or cookie field.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Use this to control how many browser pages run at once. Defaults to 2 to keep sessions consistent and reduce Naukri blocking. Increase only after successful canary runs on your proxy pool. This is not the result limit.", "default": 2 }, "debugDumpHtml": { "title": "Debug: dump raw HTML", "type": "boolean", "description": "Internal troubleshooting flag that saves raw Naukri pages to the key-value store. Use this only when extraction returns zero jobs or the site layout changes. Defaults to false. Normal users should leave it disabled.", "default": false } } }, "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 } } }, "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 } } } } } } } } } }