{ "openapi": "3.0.1", "info": { "title": "GulfTalent Jobs Scraper", "description": "[💰 $0.82 / 1K] Extract job postings from GulfTalent across the Gulf and Middle East — UAE, Saudi Arabia, Qatar, Kuwait, Oman, Bahrain, Egypt and more. Get titles, companies, descriptions, requirements, apply links and listed salary bands. Filter by keyword, country, city and employment type.", "version": "1.0", "x-build-id": "tq17zNa8yXjfZt7o7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~gulftalent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-gulftalent-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/solidcode~gulftalent-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-gulftalent-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/solidcode~gulftalent-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-gulftalent-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": "Search Keywords", "type": "array", "description": "Optional. Job titles or keywords to search for (e.g. 'accountant', 'marketing manager', 'software engineer'). Each keyword runs a separate search; results are deduplicated across keywords by job ID. Leave this empty to list every job that matches the country, city and employment type you picked below, with no keyword narrowing at all.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "uae", "saudi-arabia", "qatar", "kuwait", "oman", "bahrain", "egypt", "lebanon", "jordan", "iraq" ], "type": "string", "description": "Country to limit the search to. Applied to every keyword search above, and used on its own when you leave the keywords empty." }, "location": { "title": "City / Location", "type": "string", "description": "Optional city or area within the chosen country (e.g. 'Dubai', 'Abu Dhabi', 'Riyadh', 'Doha'). Leave blank to search the whole country. Works with or without keywords." }, "startUrls": { "title": "Direct GulfTalent Search URLs", "type": "array", "description": "Optional. Paste full GulfTalent search URLs (e.g. https://www.gulftalent.com/uae/jobs/accountant-2 or a filtered search page) to scrape them as-is. Useful when you have already dialed in a search in the GulfTalent UI.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results per Search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum job listings to collect per keyword or URL. This limit applies to EACH search separately, not to the run as a whole: 4 keywords at 300 each can return up to 1,200 jobs in one run. The scraper stops requesting new pages once the limit is reached but keeps every job from the final page (so a search may slightly overshoot).", "default": 100 }, "employmentType": { "title": "Employment Type", "uniqueItems": true, "type": "array", "description": "Only return jobs of these employment types. Leave empty for all types. Pick one or more and clear the keywords above to get every job of that type in the country, for example all contract jobs in the UAE.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "internship", "temporary" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship", "Temporary" ] } }, "includeJobDetails": { "title": "Include Full Job Details", "type": "boolean", "description": "Fetch the full job description, requirements, salary, and apply link from each listing's detail page. Slightly slower but produces much richer data. Disable for faster light scans that return only the list-view fields.", "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 } } } } } } } } } }