{ "openapi": "3.0.1", "info": { "title": "Naukri & Naukrigulf Jobs Scraper & Monitor - 60+ Fields", "description": "Scrape and monitor Naukri India and Naukrigulf over direct HTTP. Get 60+ fields, salaries, skills, company profiles, applications, views, public Naukrigulf recruiter emails when disclosed, and new-job alerts.", "version": "1.0", "x-build-id": "nClWvc8sCyj7pjiNW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thirdwatch~naukri-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thirdwatch-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/thirdwatch~naukri-jobs-scraper/runs": { "post": { "operationId": "runs-sync-thirdwatch-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/thirdwatch~naukri-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-thirdwatch-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": { "platform": { "title": "Job market", "enum": [ "auto", "naukri", "naukrigulf", "both" ], "type": "string", "description": "Naukri India is the backward-compatible default. Choose Auto to route Gulf locations to Naukrigulf, or Both to search both markets.", "default": "naukri" }, "queries": { "title": "Keywords or role + city queries", "type": "array", "description": "Search keywords such as 'python developer'. Recognized suffixes such as 'data analyst mumbai' or 'sales manager dubai' become the location.", "default": [ "software engineer" ], "items": { "type": "string" } }, "location": { "title": "Location for all keyword queries (optional)", "type": "string", "description": "Explicit city, region, or 'India'. This overrides any city suffix in queries. Leave empty to infer a recognized suffix or search India." }, "searchUrls": { "title": "Naukri or Naukrigulf search URLs (optional)", "type": "array", "description": "Existing Naukri or Naukrigulf search URLs. Keyword, location, and source are extracted automatically.", "default": [], "items": { "type": "string" } }, "includeGulfDetails": { "title": "Enrich Naukrigulf jobs with full details", "type": "boolean", "description": "Fetch each public job page for full description, skills, education, industry, employment type, and other disclosed details. Disable for the fastest low-cost monitoring runs.", "default": true }, "includeNaukriDetails": { "title": "Enrich Naukri jobs with 40+ fields", "type": "boolean", "description": "Fetch Naukri's public mobile detail payload for role taxonomy, company profile and address, full skills, applications, views, vacancies, job type, and richer locations. Failed detail requests preserve the base job row.", "default": true }, "includeDescription": { "title": "Include job descriptions", "type": "boolean", "description": "Return full plain-text and HTML descriptions. Disable for smaller monitoring datasets.", "default": true }, "monitorMode": { "title": "Monitoring mode", "enum": [ "off", "new-jobs" ], "type": "string", "description": "Off returns the current snapshot. New jobs emits and bills the current baseline on the first run, then stores a bounded history and emits only previously unseen job IDs. A monitor may request up to 2,000 rows per run; split larger watchlists across monitor names.", "default": "off" }, "monitorStoreName": { "title": "Monitor name (optional)", "maxLength": 100, "type": "string", "description": "Stable name for a scheduled watch. Reuse it on every run. If omitted, the Actor derives one from the searches, filters, and detail settings." }, "cleanHtml": { "title": "Plain text descriptions only", "type": "boolean", "description": "Keep cleaned plain text but omit the duplicate HTML description fields.", "default": false }, "maxResultsPerQuery": { "title": "Max results per query", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum jobs per keyword or search URL. The Actor paginates automatically in batches of 20.", "default": 20 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Naukri India result order. Naukrigulf currently uses relevance.", "default": "relevance" }, "freshnessDays": { "title": "Posted within", "enum": [ "0", "1", "3", "7", "15", "30" ], "type": "string", "description": "Naukri India only: return jobs posted within this many days. Zero means any age.", "default": "0" }, "experience": { "title": "Experience in years (optional)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Naukri India only: filter jobs by candidate experience level." }, "workMode": { "title": "Work mode", "enum": [ "any", "office", "hybrid", "remote" ], "type": "string", "description": "Naukri India only: filter office, hybrid, or remote listings.", "default": "any" }, "salaryRange": { "title": "Annual salary range (optional)", "enum": [ "any", "0to3", "3to6", "6to10", "10to15", "15to25", "25to50", "50to75", "75to100", "100to500" ], "type": "string", "description": "Naukri India only: annual CTC filter in lakhs of INR.", "default": "any" }, "minSalary": { "title": "Minimum annual salary in INR (optional)", "minimum": 0, "type": "integer", "description": "Naukri India rich filter. Excludes disclosed salaries below this amount; jobs with hidden salary remain because the source does not expose a comparable value." }, "industry": { "title": "Industry contains (optional)", "type": "string", "description": "Naukri India rich filter, for example 'IT Services', 'Financial Services', or 'Pharmaceutical'. Detail enrichment is enabled automatically by the default configuration." }, "roleCategory": { "title": "Role category contains (optional)", "type": "string", "description": "Naukri India rich filter, for example 'Software Development', 'Data Science', 'Sales', or 'Marketing'." }, "companyType": { "title": "Employer posting type", "enum": [ "any", "company", "consultant" ], "type": "string", "description": "Naukri India rich filter. Separate direct employer jobs from consultant or recruiter postings.", "default": "any" }, "maxConcurrency": { "title": "Concurrent searches", "minimum": 1, "maximum": 5, "type": "integer", "description": "Number of independent keyword searches processed together. Pagination within each search remains rate-limited.", "default": 3 } } }, "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 } } } } } } } } } }