{ "openapi": "3.0.1", "info": { "title": "GulfTalent Jobs Scraper - Gulf Jobs, Salaries & Details", "description": "Search GulfTalent by job title, country, city, seniority, job type and posting date. Each job comes with company, place, role, industry and date, plus the full description, salary when shown and closing date. A job only comes back if your words are in its title, role, industry, company or place.", "version": "0.1", "x-build-id": "SMn7FZV7n7Xsl9HtY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~gulftalent-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-gulftalent-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/dami_studio~gulftalent-jobs-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-gulftalent-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/dami_studio~gulftalent-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-gulftalent-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": { "keywords": { "title": "Search words", "maxItems": 20, "type": "array", "description": "Job titles, one per line, up to 20. Each line is its own search, and a job only comes back when every word of the line is in its title, job role, industry, company or place. Skills that only appear in a job's description are not seen. Leave this empty and use the filters below to get every job that fits them.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "ANY", "AE", "SA", "QA", "KW", "BH", "OM", "EG", "JO", "LB", "IQ", "REMOTE" ], "type": "string", "description": "Only jobs in this country. GulfTalent keeps remote jobs under an entry of their own, so a remote job doesn't come back with a country, even when it names one.", "default": "ANY" }, "city": { "title": "City", "type": "string", "description": "Only jobs in this city, the way GulfTalent names it: Dubai, Abu Dhabi, Sharjah, Riyadh, Jeddah, Doha, Kuwait City, Manama, Muscat, Cairo, Amman. Leave it empty for the whole country." }, "jobRoles": { "title": "Job role", "uniqueItems": true, "type": "array", "description": "Only jobs GulfTalent files under these roles. A job in any of the roles you pick comes back.", "items": { "type": "string", "enum": [ "1", "22", "23", "24", "25", "26", "27", "28", "29", "30", "32", "33", "34", "35", "36", "38", "40", "41", "42", "57", "43", "44", "45", "46", "47", "48", "53", "49", "50", "51", "31", "52" ], "enumTitles": [ "Accounting & Audit", "Administration & Secretarial", "Architecture", "Catering, Food Services & Restaurants", "Creative Arts & Design", "Customer Service", "Education & Teaching", "Engineering - Chemical & Petrochemical", "Engineering - Civil & Construction", "Engineering - Electronics & Telecom", "Engineering - Mechanical & Aeronautical", "Engineering - Petroleum, Mining & Marine", "Engineering - Power & Heavy Electrical", "Finance, Business Analysis & Consulting", "General Management", "Healthcare", "HR, Recruitment & Training", "Investment Management", "IT - Software & Web Development", "IT - Network Administration", "Journalism", "Legal", "Marketing, Advertising & PR", "Police, military & security services", "Purchasing & Procurement", "Research & Development (R&D)", "Transport, Logistics & Warehousing", "Sales - Retail", "Sales - Telesales / Telemarketing", "Sales - Wholesale / Corporate", "Safety & Environment", "Translation" ] } }, "industries": { "title": "Industry", "uniqueItems": true, "type": "array", "description": "Only jobs from employers in these industries, as GulfTalent files them. A job in any of the industries you pick comes back.", "items": { "type": "string", "enum": [ "2", "33", "34", "3", "5", "7", "8", "36", "9", "10", "38", "11", "12", "13", "14", "15", "16", "35", "18", "19", "20", "1", "21", "39", "6", "22", "23", "24", "25", "37", "26", "27", "28", "17", "29", "40", "30", "31", "32" ], "enumTitles": [ "Audit & Accountancy", "Automotive", "Aviation, Airlines & Aerospace", "Banking & Financial Services", "Business Support & Outsourcing", "Construction", "Cosmetics, Personal Care & Luxury Goods", "Cyber & Network Security", "Education & Training", "Engineering Services", "Facilities Management", "Finance, Investment & Asset Management", "FMCG / Consumer Goods / Food & Beverages", "General Trading & Import/Export", "Government & Public Sector", "Healthcare, Pharmaceuticals & Medical Services", "Insurance", "IT, Hardware & Networking", "Legal Services", "Management Consulting", "Manufacturing", "Marketing, Advertising & PR", "Media & Entertainment", "Mining & Quarrying", "Non-profit / NGO / Social Services", "Oil & Gas / Energy", "Printing & Publishing", "Property & Real Estate", "Recruitment & HR", "Restaurants, Catering & Food Services", "Retail", "Security, law & order", "Shipping, Freight & Marine", "Software & Internet Services", "Telecoms", "Textiles, Apparel & Fashion", "Transport, Logistics & Warehousing", "Travel, Hotel & Tourism", "Water, Power & Utilities" ] } }, "seniority": { "title": "Seniority", "enum": [ "ANY", "1", "2", "4", "5", "6" ], "type": "string", "description": "Only jobs at this level, as GulfTalent files them.", "default": "ANY" }, "employmentType": { "title": "Job type", "enum": [ "ANY", "1", "2", "3", "5", "6" ], "type": "string", "description": "Only jobs of this type.", "default": "ANY" }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only jobs posted in the last this many days. GulfTalent's search has no date filter, so the actor reads its list newest first and stops at the first older job. How far it reads is set by Most pages per search. Leave it empty for any date." }, "companies": { "title": "Companies", "maxItems": 20, "type": "array", "description": "Only jobs from these companies, one per line, up to 20. A job comes back when every word of a line is in its company name, so Emirates finds Emirates NBD and Emirates Airline alike. GulfTalent's search can't filter by company, so this is checked on each job, within Most pages per search.", "items": { "type": "string" } }, "minMonthlySalary": { "title": "Minimum monthly salary", "minimum": 1, "type": "integer", "description": "Only jobs whose page gives a monthly salary reaching this figure, in the currency below. The top of a range counts: 6,500-10,000 AED passes 8,000. Most GulfTalent jobs give no salary at all, and those are left out. The salary is only on each job's page, so setting this opens every page and switches details on." }, "salaryCurrency": { "title": "Salary currency", "enum": [ "COUNTRY", "AED", "SAR", "QAR", "KWD", "BHD", "OMR", "EGP", "JOD", "LBP", "IQD", "USD", "EUR", "GBP" ], "type": "string", "description": "The currency of the minimum salary. A job showing its salary in another currency is left out, not converted.", "default": "COUNTRY" }, "easyApplyOnly": { "title": "Easy Apply only", "type": "boolean", "description": "Only jobs you apply for on GulfTalent itself, rather than on the employer's own site.", "default": false }, "exclusiveOnly": { "title": "Exclusive jobs only", "type": "boolean", "description": "Only jobs GulfTalent marks as exclusive to it. It marks very few.", "default": false }, "maxPagesPerSearch": { "title": "Most pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Posted within, Companies and Minimum monthly salary are checked on each job here, because GulfTalent's search can't do them. With any of them set, one search reads at most this many pages of 200 jobs from GulfTalent's list, and the status message says when a search stopped there. Raise it for a long look back over a whole country.", "default": 10 }, "maxResults": { "title": "Maximum jobs", "minimum": 1, "maximum": 20000, "type": "integer", "description": "The most jobs returned in one run, across all your searches. Each job returned is charged.", "default": 100 }, "includeDetails": { "title": "Full job details", "type": "boolean", "description": "Opens each job's page for the full description, the salary when the employer shows it, the closing date, and the nationality, gender and Arabic the employer asks for. Switch it off for the search-result fields only, which is several times faster.", "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 } } } } } } } } } }