{ "openapi": "3.0.1", "info": { "title": "Naukri Job Scraper โšก from $0.50/1K โ€” Salary, Skills & Full JD", "description": "Naukri Job Scraper extracts structured job listing data from Naukri.com โ€” job title, company, experience, salary, location, full details. Fast, reliable, and built for scale. Ideal for recruiters, market researchers, and businesses tracking hiring trends.", "version": "0.1", "x-build-id": "NTyCGXzpewLeIZvug" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/corvuslab~naukri-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-corvuslab-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/corvuslab~naukri-jobs-scraper/runs": { "post": { "operationId": "runs-sync-corvuslab-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/corvuslab~naukri-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-corvuslab-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": "Job search keyword, e.g. \"data analyst\". Alias: query." }, "searchQueries": { "title": "๐Ÿ“ Search queries", "type": "array", "description": "Multiple keyword searches per run (unioned, each capped by maxResults).", "items": { "type": "string" } }, "jobIds": { "title": "๐Ÿ†” Job IDs", "type": "array", "description": "Fetch specific jobs by their Naukri job ID.", "items": { "type": "string" } }, "startUrls": { "title": "๐Ÿ”— Start URLs", "type": "array", "description": "Paste Naukri URLs directly (single job page, search results, or SEO listing URLs).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "ignoreUrlFailures": { "title": "โญ๏ธ Ignore URL failures", "type": "boolean", "description": "Skip URLs that cannot be parsed instead of failing the whole run.", "default": true }, "location": { "title": "๐Ÿ“ Location", "type": "string", "description": "Free-text location filter, e.g. \"bangalore\"." }, "experience": { "title": "๐Ÿง‘โ€๐Ÿ’ผ Experience (shortcut)", "type": "string", "description": "Shortcut accepting ranges (\"0-1\", \"5+\") or labels (fresher, junior, senior). Overridden by experienceMin/experienceMax if set." }, "experienceMin": { "title": "โฌ‡๏ธ Experience min (years)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Minimum years of experience." }, "experienceMax": { "title": "โฌ†๏ธ Experience max (years)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Maximum years of experience." }, "salary": { "title": "๐Ÿ’ฐ Salary range (lakhs)", "enum": [ "0to3", "3to6", "6to10", "10to15", "15to25", "25to50", "50to75", "75to100" ], "type": "string", "description": "Annual salary bracket in lakhs (INR)." }, "skills": { "title": "๐Ÿ› ๏ธ Skills", "type": "array", "description": "Filter by skill names.", "items": { "type": "string" } }, "workMode": { "title": "๐Ÿ  Work mode", "enum": [ "office", "remote", "hybrid", "temporary_wfh" ], "type": "string", "description": "Filter by work mode." }, "freshness": { "title": "๐Ÿ•’ Freshness (days)", "minimum": 1, "maximum": 30, "type": "integer", "description": "Only jobs posted within the last N days." }, "datePosted": { "title": "๐Ÿ“… Date posted (shortcut)", "type": "string", "description": "Shortcut: \"today\", \"3d\", \"7d\", \"week\", \"month\". Overridden by freshness if set." }, "cityTypeGid": { "title": "๐Ÿ™๏ธ City ID (cityTypeGid)", "type": "integer", "description": "Naukri city GID, e.g. 97=Bengaluru, 17=Hyderabad, 220=Delhi/NCR." }, "companyId": { "title": "๐Ÿข Company ID", "type": "integer", "description": "Restrict to a single company entity ID." }, "companyGroupIds": { "title": "๐Ÿฌ Company group IDs", "type": "array", "description": "Fan out a parallel crawl across multiple company group IDs.", "items": { "type": "string" } }, "companyType": { "title": "๐Ÿท๏ธ Company type", "type": "array", "description": "Filter by company type.", "items": { "type": "string", "enum": [ "213", "62", "51", "83", "223" ], "enumTitles": [ "Foreign MNC", "Startup", "Indian MNC", "Corporate", "Others" ] } }, "postedBy": { "title": "๐Ÿ‘ค Posted by", "enum": [ "Both", "Company", "Consultant" ], "type": "string", "description": "Filter by who posted the job (recruiter-spam filter).", "default": "Both" }, "industry": { "title": "๐Ÿญ Industry (post-filter)", "type": "string", "description": "Keep only jobs in this industry. Requires fetchDetails." }, "roleCategory": { "title": "๐Ÿ—‚๏ธ Role category (post-filter)", "type": "string", "description": "Keep only jobs in this role category. Requires fetchDetails." }, "sortBy": { "title": "โ†•๏ธ Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Result ordering." }, "maxResults": { "title": "๐Ÿ”ข Max results", "minimum": 0, "type": "integer", "description": "Maximum jobs to return per search (0 = unlimited, capped at 5000). Aliases: limit, maxItems.", "default": 25 }, "fetchDetails": { "title": "๐Ÿ“„ Fetch details", "type": "boolean", "description": "Fetch full descriptions, company metadata, education, walk-in and AmbitionBox data for each job (billed at a higher per-result rate).", "default": false }, "compact": { "title": "๐Ÿ—œ๏ธ Compact output", "type": "boolean", "description": "Return only core fields (AI/MCP-friendly).", "default": false }, "excludeEmptyFields": { "title": "๐Ÿงน Exclude empty fields", "type": "boolean", "description": "Drop null/empty fields and objects from output items.", "default": false }, "descriptionMaxLength": { "title": "โœ‚๏ธ Description max length", "minimum": 0, "type": "integer", "description": "Truncate descriptions to N characters (0/empty = no limit)." }, "descriptionFormat": { "title": "๐Ÿ“ Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Which description formats to include (requires fetchDetails).", "default": "all" }, "incremental": { "title": "๐Ÿ†• Incremental mode", "type": "boolean", "description": "Emit only jobs that are new or changed since the last run with the same state key.", "default": false }, "stateKey": { "title": "๐Ÿ—๏ธ State key", "type": "string", "description": "Override the incremental state scope. Defaults to a hash of the search parameters." }, "skipReposts": { "title": "๐Ÿšซ Skip reposts", "type": "boolean", "description": "Exclude jobs detected as reposts of previously seen listings.", "default": false }, "emitUnchanged": { "title": "โ™ป๏ธ Emit unchanged", "type": "boolean", "description": "Include jobs whose content has not changed since the last run.", "default": false }, "emitExpired": { "title": "โŒ› Emit expired", "type": "boolean", "description": "Emit records for jobs that disappeared since the last run (changeType = EXPIRED).", "default": false }, "telegramToken": { "title": "๐Ÿค– Telegram bot token", "type": "string", "description": "Bot token from @BotFather." }, "telegramChatId": { "title": "๐Ÿ’ฌ Telegram chat ID", "type": "string", "description": "Target chat/channel ID for Telegram alerts." }, "slackWebhookUrl": { "title": "๐Ÿ“จ Slack webhook URL", "type": "string", "description": "Slack incoming webhook URL." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord webhook URL", "type": "string", "description": "Discord incoming webhook URL." }, "whatsappPhoneNumberId": { "title": "๐Ÿ“ฑ WhatsApp phone number ID", "type": "string", "description": "Meta Cloud API phone number ID." }, "whatsappAccessToken": { "title": "๐Ÿ” WhatsApp access token", "type": "string", "description": "Meta Cloud API access token." }, "whatsappTo": { "title": "๐Ÿ“ฒ WhatsApp recipient", "type": "string", "description": "Recipient phone number in E.164 format (e.g. 919876543210)." }, "webhookUrl": { "title": "๐Ÿช Generic webhook URL", "type": "string", "description": "Receives a JSON POST { count, jobs: [...] } โ€” for n8n / Make / Zapier." }, "webhookHeaders": { "title": "๐Ÿ“‹ Webhook headers", "type": "object", "description": "Custom headers sent with the generic webhook (e.g. auth)." }, "notificationLimit": { "title": "๐Ÿ”ข Notification limit", "minimum": 1, "maximum": 20, "type": "integer", "description": "Max jobs listed per notification message.", "default": 5 }, "notifyOnlyChanges": { "title": "๐Ÿ”” Notify only changes", "type": "boolean", "description": "In incremental mode, only notify about NEW/UPDATED jobs.", "default": false }, "maxConcurrency": { "title": "๐Ÿšฆ Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum concurrent requests.", "default": 5 }, "detailConcurrency": { "title": "๐Ÿงต Detail concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many job-detail pages to load in parallel (fetchDetails only). Higher = faster wall-clock on large runs, but NOT cheaper: extra pages need more memory (set 2048MB+ for 2-3) and share one proxy IP. Leave at 1 for lowest cost; raise it only when finishing fast matters more than cost.", "default": 1 }, "maxRequestRetries": { "title": "๐Ÿ” Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Retries per failed request.", "default": 3 }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "Optional. The stealth browser often reaches Naukri without a proxy, but for scheduled or large runs โ€” or if you hit blocks โ€” use Apify Proxy with group RESIDENTIAL and country IN for the most reliable results. Clear this to run without a proxy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }