{ "openapi": "3.0.1", "info": { "title": "GulfTalent Jobs Scraper", "description": "[💰 $0.98 / 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, salaries, requirements, employment type, and apply links by keyword, country, city, and date.", "version": "1.0", "x-build-id": "rRZOrOpO3EQDlPE3o" }, "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": "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 empty if you only want to use direct URLs.", "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.", "default": "uae" }, "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." }, "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. The scraper stops requesting new pages once this number is reached but keeps every job from the final page (so the actual count 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.", "items": { "type": "string", "enum": [ "full-time", "part-time", "contract", "internship", "temporary" ], "enumTitles": [ "Full-time", "Part-time", "Contract", "Internship", "Temporary" ] }, "default": [] }, "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 } } } } } } } } } }