{ "openapi": "3.0.1", "info": { "title": "Naukri Jobs Scraper - Salary, Skills & Job API", "description": "Scrape Naukri.com job listings across India by keyword, city, search URL or job ID. Extract full descriptions, disclosed salaries, skills, work mode, company IDs and application links. Export JSON, CSV or Excel; use the API or AI agents. $1 per 1,000 results, plus a small start fee. No Naukri login.", "version": "0.1", "x-build-id": "RKtPNDBg9XTPWR5zm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/whoareyouanas~naukri-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-whoareyouanas-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/whoareyouanas~naukri-jobs-scraper/runs": { "post": { "operationId": "runs-sync-whoareyouanas-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/whoareyouanas~naukri-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-whoareyouanas-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": { "mode": { "title": "Search or job details", "enum": [ "search", "details" ], "type": "string", "description": "Search jobs or fetch individual listings by job ID/URL.", "default": "search" }, "keyword": { "title": "Job keyword or skills", "minLength": 1, "maxLength": 200, "type": "string", "description": "Skills, role or employer name. Use this OR advanced searches OR start URLs. Employer names are search terms, not verified identities." }, "location": { "title": "Job location", "maxLength": 200, "type": "string", "description": "Source location search; remote listings may have no verified city." }, "sortBy": { "title": "Sort By", "enum": [ "date", "relevance" ], "type": "string", "description": "Sort Naukri results by posting date or source relevance. Defaults to date.", "default": "date" }, "freshnessDays": { "title": "Posted within days", "minimum": 1, "maximum": 30, "type": "integer", "description": "Source posting-age filter in days. Known source-created dates are checked locally; unknown dates remain explicit." }, "experienceYears": { "title": "Experience in years", "minimum": 0, "maximum": 30, "type": "integer", "description": "Candidate experience in years, from 0 to 30, passed as a source search filter. Zero searches for fresher roles." }, "workModes": { "title": "Work mode", "maxItems": 3, "uniqueItems": true, "type": "array", "description": "Office, remote or hybrid source filter, also checked when work-mode evidence is available.", "items": { "type": "string", "enum": [ "office", "remote", "hybrid" ] } }, "postedBy": { "title": "Job posted by", "enum": [ "any", "company", "consultant" ], "type": "string", "description": "Source poster filter. With details, also verified against the source consultant flag. Summary mode reports source filtering only.", "default": "any" }, "salaryBands": { "title": "Source salary bands (LPA)", "maxItems": 20, "uniqueItems": true, "type": "array", "description": "Source annual salary-band codes such as 10to15. Source filter only; use INR bounds for strict local enforcement.", "items": { "type": "string" } }, "searches": { "title": "Multiple job searches", "minItems": 1, "maxItems": 20, "type": "array", "description": "Batch of up to 20 searches. Each entry supports keyword, location, sortBy, freshnessDays, workModes, postedBy, experienceYears and salaryBands. Each is paginated fairly under one global job cap.", "items": { "type": "object" } }, "startUrls": { "title": "Naukri search or job URLs", "minItems": 1, "maxItems": 20, "type": "array", "description": "Naukri India search URLs, or single-job URLs in details mode. Search URLs begin at page one. Unsupported filter parameters are rejected.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "jobIds": { "title": "Naukri job IDs", "minItems": 1, "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Twelve-digit Naukri job IDs. Select details mode. Use job IDs OR start URLs.", "items": { "type": "string" } }, "maxJobs": { "title": "Maximum unique jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique delivered jobs across ALL queries. Increase for larger workloads; defaults to 100.", "default": 100 }, "maxPagesPerSearch": { "title": "Max Pages Per Search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Finite discovery page limit. Reaching it is reported as partial coverage.", "default": 25 }, "maxRequests": { "title": "Max Requests", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Hard ceiling on HTTP attempts, including retries and proxy fallback. This controls work even when filters reject many jobs.", "default": 3000 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Maximum simultaneous HTTP workers, from 1 to 8. Defaults to 4; higher concurrency can increase source blocks.", "default": 4 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Retry limit per source request, from 0 to 3. Retried attempts consume maxRequests.", "default": 2 }, "fetchDetails": { "title": "Full job descriptions and details", "type": "boolean", "description": "Fetch full descriptions, locations, education and poster type. Summary mode preserves shorter source snippets.", "default": true }, "onlyDirectEmployers": { "title": "Direct employers only", "type": "boolean", "description": "Verify consultant=false using full details. Requires fetchDetails=true; unknown poster type is excluded.", "default": false }, "descriptionFormat": { "title": "Description Format", "enum": [ "text", "html", "markdown" ], "type": "string", "description": "Return descriptions as plain text, HTML or Markdown. This changes the description field; dataset export format is selected separately.", "default": "text" }, "proxyMode": { "title": "Proxy Mode", "enum": [ "none", "auto", "residential" ], "type": "string", "description": "Auto makes bounded direct requests first and can retry blocked/network failures using Apify India residential proxy. None disables proxy. Proxy/platform usage can incur costs during development runs.", "default": "auto" }, "companyIds": { "title": "Naukri company IDs", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Keep only exact source company IDs. Separate from employer group IDs.", "items": { "type": "string" } }, "groupIds": { "title": "Naukri employer group IDs", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Keep only exact source group IDs. If companyIds is also supplied, both constraints must match.", "items": { "type": "string" } }, "minSalaryInr": { "title": "Minimum annual salary (INR)", "minimum": 0, "type": "number", "description": "Strict annual disclosed INR salary lower bound; unknown/monthly salaries are excluded. Job salary interval must overlap your requested interval." }, "maxSalaryInr": { "title": "Maximum annual salary (INR)", "minimum": 0, "type": "number", "description": "Strict annual disclosed INR salary upper bound. Job salary interval must overlap your requested interval." }, "requiredSkills": { "title": "Required skill tags", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "ALL listed skills must match whole source skill tags, case-insensitively. No guessed skill expansion.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }