{
  "openapi": "3.0.1",
  "info": {
    "title": "GulfTalent Scraper: Gulf Jobs, Salaries and New Job Alerts",
    "description": "GulfTalent scraper for GCC jobs (UAE, Saudi Arabia, Qatar, Kuwait, Oman, Bahrain). Many job titles and cities per run, country and category lists, salary as numbers, no start fee, no contact persons. Monitor mode returns only new jobs.",
    "version": "0.1",
    "x-build-id": "85AxcWNiMgjla26BB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datahamster~gulftalent-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datahamster-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/datahamster~gulftalent-scraper/runs": {
      "post": {
        "operationId": "runs-sync-datahamster-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/datahamster~gulftalent-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-datahamster-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": {
          "keywords": {
            "title": "Job titles (keywords)",
            "type": "array",
            "description": "Job titles, one per line, e.g. \"accountant\", \"civil engineer\", \"nurse\". Each one is read as GulfTalent's job-title page (the site matches it against job titles, not full text) in every location below. Leave empty to list all jobs by location, country or category.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "GCC cities or countries, one per line, e.g. \"Dubai\", \"Abu Dhabi\", \"Riyadh\", \"Doha\", \"Saudi Arabia\". Every keyword is searched in every location. Built in: the main cities of the UAE, Saudi Arabia, Qatar, Kuwait, Oman and Bahrain (\"Makkah\", \"Madinah\", \"RAK\", \"KSA\" understood). Another city is tried under the one country picked in Countries; a place GulfTalent has no page for returns nothing and is named in the log and status. Leave empty to use Countries.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "GCC countries to search when Locations is empty, e.g. [\"UAE\", \"Qatar\"]. Empty with keywords = all countries GulfTalent lists; empty without keywords = all six GCC countries.",
            "items": {
              "type": "string",
              "enum": [
                "UAE",
                "Saudi Arabia",
                "Qatar",
                "Kuwait",
                "Oman",
                "Bahrain"
              ],
              "enumTitles": [
                "United Arab Emirates (UAE)",
                "Saudi Arabia",
                "Qatar",
                "Kuwait",
                "Oman",
                "Bahrain"
              ]
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "GulfTalent job categories, e.g. [\"accounting\", \"software\"]. Used without keywords, per country in Countries (or all countries). GulfTalent has no category page per city or per job title, so categories cannot be combined with keywords or locations.",
            "items": {
              "type": "string",
              "enum": [
                "academic",
                "accounting",
                "admin",
                "architecture",
                "catering",
                "chemical-engineering",
                "civil-engineering",
                "customer-service",
                "design",
                "electronics-engineering",
                "finance-consulting",
                "healthcare",
                "hr",
                "hse",
                "investment",
                "journalism",
                "legal",
                "logistics",
                "management",
                "marketing",
                "mechanical-engineering",
                "network-admin",
                "petroleum-engineering",
                "power-engineering",
                "procurement",
                "r-d",
                "retail-sales",
                "sales",
                "security",
                "software",
                "telesales",
                "translation"
              ],
              "enumTitles": [
                "Academic",
                "Accounting",
                "Admin",
                "Architecture",
                "Catering",
                "Chemical Engineering",
                "Civil Engineering",
                "Customer Service",
                "Design",
                "Electronics Engineering",
                "Finance Consulting",
                "Healthcare",
                "HR",
                "HSE",
                "Investment",
                "Journalism",
                "Legal",
                "Logistics",
                "Management",
                "Marketing",
                "Mechanical Engineering",
                "Network Admin",
                "Petroleum Engineering",
                "Power Engineering",
                "Procurement",
                "R&D",
                "Retail Sales",
                "Sales",
                "Security",
                "Software",
                "Telesales",
                "Translation"
              ]
            }
          },
          "postedWithin": {
            "title": "Posted within",
            "enum": [
              "any",
              "1d",
              "3d",
              "7d",
              "14d",
              "30d"
            ],
            "type": "string",
            "description": "Keep only jobs posted in this window, by the posted date the list shows. Example: 7d.",
            "default": "any"
          },
          "includeDetails": {
            "title": "Include job details",
            "type": "boolean",
            "description": "Read each job's page too: salary as numbers (min, max, currency, period; null when the employer hides it), full description, employment type, job function, company industry, years of experience read from the ad, nationality, reference, closing date. One extra request per job.",
            "default": false
          },
          "maxResultsPerSearch": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 2500,
            "type": "integer",
            "description": "How deep each search reads (25 jobs per page). Empty = 500 in scrape mode, 100 in monitor mode."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many results (you are charged only for pushed items)",
            "default": 100
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "scrape",
              "monitor"
            ],
            "type": "string",
            "description": "scrape = full results; monitor = only new/changed items since the previous run of this task",
            "default": "scrape"
          },
          "monitorStateId": {
            "title": "Monitor state id",
            "type": "string",
            "description": "Optional state id when not running as a saved task (monitor mode)"
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "POST a change summary here in monitor mode"
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Optional: bot token for monitor-mode change summaries"
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "Optional: chat id that receives monitor-mode summaries"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}