{
"openapi": "3.0.1",
"info": {
"title": "NaukriGulf Scraper - Gulf Jobs, Companies & Salaries",
"description": "Scrape Gulf job listings from NaukriGulf: title, company, location, experience range, vacancies, summary, skills keywords, posted date and apply URL for the UAE, Saudi Arabia, Qatar, Kuwait, Oman and Bahrain. Search by keyword and city, filter by experience and freshness. No login. JSON, CSV, Excel.",
"version": "0.1",
"x-build-id": "iAmtVGcCtWtp3DZg9"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~naukrigulf-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-naukrigulf-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/scrapesage~naukrigulf-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-naukrigulf-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/scrapesage~naukrigulf-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-naukrigulf-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": {
"searchQueries": {
"title": "Job title / keywords",
"type": "array",
"description": "Keywords to search, e.g. accountant, civil engineer, nurse, sales manager. Each keyword is searched separately (and combined with every location). Leave empty to browse all jobs in the chosen locations.",
"items": {
"type": "string"
}
},
"locations": {
"title": "Locations",
"type": "array",
"description": "Cities or countries as NaukriGulf names them: Dubai, Abu Dhabi, Sharjah, UAE, Riyadh, Jeddah, Dammam, Saudi Arabia, Doha, Qatar, Kuwait, Muscat, Oman, Manama, Bahrain. Leave empty to search the whole Gulf region.",
"items": {
"type": "string"
}
},
"minExperienceYears": {
"title": "Minimum experience (years)",
"minimum": 0,
"maximum": 30,
"type": "integer",
"description": "Only jobs whose experience range covers at least this many years (NaukriGulf's own experience filter). Leave empty for any experience."
},
"postedWithinDays": {
"title": "Posted within",
"enum": [
"0",
"1",
"3",
"7",
"15",
"30",
"60"
],
"type": "string",
"description": "Freshness filter - only jobs posted within this window.",
"default": "0"
},
"maxResults": {
"title": "Max jobs",
"minimum": 1,
"type": "integer",
"description": "Maximum number of jobs to return across all keyword x location combinations (duplicates are collapsed by job id).",
"default": 100
},
"includeDescriptions": {
"title": "Add full job descriptions (SLOW, costs more)",
"type": "boolean",
"description": "⚠️ Off by default. When on, each job's full detail page is rendered to pull the complete description, plus qualifications, experience requirements, skills, industry and employment type. NaukriGulf renders the description with JavaScript, so each one needs a full browser-render fetch: this makes the run much slower (a few seconds per job) and is billed as a separate, higher-priced Job description event on top of the per-job charge. Leave OFF unless you specifically need the description text - the search already returns the summary, skills keywords, salary-experience, company and apply URL. Cap the count with the next field.",
"default": false
},
"maxDescriptions": {
"title": "Max descriptions to fetch",
"minimum": 1,
"type": "integer",
"description": "When 'Add full job descriptions' is on, stop after this many descriptions (the remaining jobs still ship with all their listing fields, just no description). Keep this modest - each description is a slow, separately-billed render.",
"default": 50
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "The search API answers Apify datacenter proxies, so the default is enough. Requests are paced automatically to stay under the site's rate limit.",
"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
}
}
}
}
}
}
}
}
}
}