{ "openapi": "3.0.1", "info": { "title": "GulfTalent Job Listings Across 16 Middle East Markets", "description": "Search GulfTalent by keyword, category, industry, job type or nationality preference, or browse one employer's careers page, and get salary, description and preference details.", "version": "2.0", "x-build-id": "zZCteaXnpbNbasj4u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vexaloom-labs~gulftalent-job-listings-across-16-middle-east/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vexaloom-labs-gulftalent-job-listings-across-16-middle-east", "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/vexaloom-labs~gulftalent-job-listings-across-16-middle-east/runs": { "post": { "operationId": "runs-sync-vexaloom-labs-gulftalent-job-listings-across-16-middle-east", "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/vexaloom-labs~gulftalent-job-listings-across-16-middle-east/run-sync": { "post": { "operationId": "run-sync-vexaloom-labs-gulftalent-job-listings-across-16-middle-east", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byCompany", "byUrls", "salary" ], "type": "string", "description": "What to collect: job search, one employer, pasted URLs, or salary benchmarks.", "default": "search" }, "searchQueries": { "title": "Search keywords (mode=search)", "type": "array", "description": "One or more job-title keywords. Each query is paginated in full and results are de-duplicated. Leave empty to browse all jobs that match the filters.", "default": [ "accountant" ], "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "", "uae", "saudi-arabia", "egypt", "qatar", "jordan", "bahrain", "kuwait", "oman", "lebanon", "iraq", "remote-jobs", "india", "armenia", "djibouti", "malta", "united-kingdom", "nigeria", "belgium", "maldives", "malaysia", "finland", "switzerland", "singapore", "uganda", "latvia", "south-korea", "kenya", "austria", "spain", "zambia", "seychelles", "united-states", "pakistan", "sweden", "germany", "france", "brunei", "libya" ], "type": "string", "description": "Restrict jobs to one of GulfTalent's 38 markets.", "default": "uae" }, "city": { "title": "City", "enum": [ "", "dubai", "abu-dhabi", "sharjah", "ras-al-khaimah", "ajman", "al-ain", "fujairah", "umm-al-quwain", "riyadh", "jeddah", "mecca", "dammam", "khobar", "dhahran", "jubail", "yanbu", "doha", "muscat", "salalah", "cairo", "amman", "kuwait-city", "manama", "baghdad", "basra", "erbil", "kirkuk", "mosul", "sulaymaniyah", "beirut" ], "type": "string", "description": "Restrict jobs to a city. Selecting a city also selects its country.", "default": "" }, "category": { "title": "Job category", "enum": [ "", "accounting", "admin", "architecture", "catering", "design", "customer-service", "academic", "chemical-engineering", "civil-engineering", "electronics-engineering", "hse", "mechanical-engineering", "petroleum-engineering", "power-engineering", "finance-consulting", "management", "healthcare", "hr", "investment", "software", "journalism", "legal", "marketing", "security", "procurement", "r-d", "retail-sales", "telesales", "sales", "translation", "logistics", "network-admin" ], "type": "string", "description": "Job function such as Accounting, Software or Logistics.", "default": "" }, "industry": { "title": "Company industry", "enum": [ "", "marketing", "accountancy", "banking", "professional-services", "non-profit", "construction", "cosmetics", "education", "engineering", "finance", "fmcg", "general-trading", "government", "healthcare", "insurance", "it", "law", "consulting", "manufacturing", "media", "oil-gas", "publishing", "real-estate", "hr", "retail", "security", "shipping", "telecom", "logistics", "hospitality", "utilities", "automotive", "aviation", "it-hardware-networking", "cyber-network-security", "restaurants-catering-food-services", "facilities-management", "mining-quarrying", "textiles-apparel-fashion" ], "type": "string", "description": "The hiring company's industry sector.", "default": "" }, "careerLevel": { "title": "Career level", "enum": [ "", "fresh-graduate", "junior", "experienced", "manager", "director" ], "type": "string", "description": "Seniority required by the posting.", "default": "" }, "employmentTypes": { "title": "Employment types", "type": "array", "description": "Any of: full-time, part-time, contract, temporary, internship. Leave empty for all types.", "default": [], "items": { "type": "string" } }, "nationality": { "title": "Nationality preference", "enum": [ "", "uae", "saudi", "kuwaiti", "qatari", "bahraini", "omani" ], "type": "string", "description": "Only jobs aimed at this Gulf nationality.", "default": "" }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Keep only postings GulfTalent flags as remote.", "default": false }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Keep only jobs that can be applied for on GulfTalent.", "default": false }, "exclusiveOnly": { "title": "Exclusive jobs only", "type": "boolean", "description": "Keep only GulfTalent-exclusive postings.", "default": false }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 90, "type": "integer", "description": "Only jobs posted in the last N days. 0 means any age.", "default": 0 }, "includeKeywords": { "title": "Must contain keywords", "type": "array", "description": "Keep only jobs whose title, description or job function contains any of these terms (case-insensitive).", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop jobs whose title, description or job function contains any of these terms (case-insensitive).", "default": [], "items": { "type": "string" } }, "minSalary": { "title": "Minimum salary", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Drop jobs below this salary in the job's own currency. Jobs without a disclosed salary are kept." }, "maxSalary": { "title": "Maximum salary", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Drop jobs above this salary in the job's own currency. Jobs without a disclosed salary are kept." }, "fetchFullDetails": { "title": "Fetch full details", "type": "boolean", "description": "Visit each job page for the full description, salary, address and preference fields. Turn off for the fastest, cheapest listing-only runs.", "default": true }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on emitted records (1-10000).", "default": 25 }, "companyUrl": { "title": "Company careers URL or slug (mode=byCompany)", "type": "string", "description": "A GulfTalent company page such as https://www.gulftalent.com/companies/marriott-international-careers or just marriott-international-careers.", "default": "" }, "startUrls": { "title": "Start URLs (mode=byUrls)", "type": "array", "description": "Job detail URLs, search/listing URLs or company careers URLs.", "default": [], "items": { "type": "string" } }, "salaryTitles": { "title": "Salary titles (mode=salary)", "type": "array", "description": "Job titles to benchmark, e.g. accountant or project manager.", "default": [ "accountant" ], "items": { "type": "string" } }, "salaryCountry": { "title": "Salary country (mode=salary)", "enum": [ "uae", "saudi-arabia", "qatar", "kuwait", "bahrain", "oman" ], "type": "string", "description": "GulfTalent publishes salary benchmarks for six GCC countries.", "default": "uae" }, "salaryCurrency": { "title": "Salary currency (mode=salary)", "enum": [ "", "AED", "BHD", "KWD", "OMR", "QAR", "SAR", "USD", "GBP", "EUR", "INR" ], "type": "string", "description": "Primary currency for the percentile fields. Leave empty for the country's own currency.", "default": "" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }