{ "openapi": "3.0.1", "info": { "title": "Naukri Gulf Jobs Scraper", "description": "Collect public Naukrigulf.com job listings into structured datasets. Search by keyword, location, filters, saved search URL, or job IDs, and get job titles, companies, salaries, experience, skills, and optional full job details.", "version": "0.0", "x-build-id": "Jktg7qOSoJXtw62Cg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hgservices~naukrigulf-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hgservices-naukrigulf-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/hgservices~naukrigulf-jobs-scraper/runs": { "post": { "operationId": "runs-sync-hgservices-naukrigulf-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/hgservices~naukrigulf-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-hgservices-naukrigulf-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": "Search keyword", "type": "string", "description": "Job title, role or keyword to search on NaukriGulf, e.g. \"software engineer\", \"accountant\", \"driver\". Ignored when Search URL or Job IDs are provided.", "default": "software engineer" }, "location": { "title": "Location (optional)", "type": "string", "description": "City or Gulf country to restrict results to, e.g. \"Dubai\", \"Riyadh\", \"Qatar\". Leave empty for all Gulf countries. Ignored when Search URL or Job IDs are provided." }, "searchUrl": { "title": "Search URL (optional)", "type": "string", "description": "Paste a full NaukriGulf search results URL, e.g. https://www.naukrigulf.com/software-engineer-jobs-in-dubai?Freshness=7. Filters set on the site are applied automatically and override the manual filters below (except Sort by). Ignored when Job IDs are provided." }, "jobIds": { "title": "Specific job IDs (optional)", "type": "array", "description": "12-digit NaukriGulf job IDs to fetch directly (overrides keyword, location, Search URL and all filters). Extract them from any NaukriGulf job URL (the ...jid-XXXXXXXXXXXX suffix).", "items": { "type": "string", "minLength": 12, "maxLength": 12, "pattern": "^[0-9]{12}$" } }, "freshness": { "title": "Freshness (posted within)", "enum": [ "", "1d", "3d", "7d", "15d", "30d", "60d" ], "type": "string", "description": "Only jobs posted within the chosen window.", "default": "" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort order of search results. \"Date\" returns newest jobs first and also works together with Search URL.", "default": "relevance" }, "experience": { "title": "Experience (optional)", "enum": [ "", "0_1", "2_5", "6_10", "11_15", "16_20", "20plus" ], "type": "string", "description": "Required years of experience bucket. Leave empty for any.", "default": "" }, "salaryRange": { "title": "Salary range (monthly, USD)", "type": "array", "description": "Monthly salary buckets in USD. Leave empty for any. Bucket values are passed straight to the NaukriGulf CTC filter.", "items": { "type": "string", "enum": [ "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "13", "30" ], "enumTitles": [ "$501 - $1,000", "$1,001 - $2,000", "$2,001 - $3,000", "$3,001 - $4,000", "$4,001 - $5,000", "$5,001 - $6,000", "$6,001 - $7,000", "$7,001 - $8,000", "$8,001 - $9,000", "$9,001 - $10,000", "$15,001 - $30,000", "Not Mentioned" ] } }, "industryId": { "title": "Industry ID (optional)", "type": "string", "description": "NaukriGulf industry filter ID, e.g. \"25\" for IT, \"7\" for Banking and Finance, \"42\" for Recruitment. Leave empty for any. Find more IDs in the search clusters of a result set." }, "functionalAreaId": { "title": "Functional area ID (optional)", "type": "string", "description": "NaukriGulf functional area filter ID, e.g. \"16\" for IT Software, \"38\" for Engineering. Leave empty for any." }, "nationalityId": { "title": "Nationality cluster ID (optional)", "type": "string", "description": "NaukriGulf nationality cluster filter ID, e.g. \"991\" for GCC Nationals, \"992\" for Arab Nationals. Leave empty for any." }, "maxItems": { "title": "Maximum number of job listings", "minimum": 25, "maximum": 100000, "type": "integer", "description": "Maximum number of jobs to collect (minimum 25). Each result page returns up to 25 jobs.", "default": 100 }, "getJobDetails": { "title": "Fetch full job details", "type": "boolean", "description": "When enabled, fetches the full job description, salary breakdown, desired candidate profile, education, company about and contact details for every job (slower, charged as detailed items). Disable for quick listing-only runs.", "default": 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 } } } } } } } } } }