{
  "openapi": "3.0.1",
  "info": {
    "title": "GulfTalent Job Scraper — Hiring Signals",
    "description": "Search public GulfTalent jobs across six Gulf markets or scrape direct search URLs. Filter by country, city, category and date. Get disclosed salary in USD, descriptions, an agent summary and optional new-jobs-only monitoring.",
    "version": "1.0",
    "x-build-id": "zBFNsczGUbSidCytI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~gulftalent-job-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-gulftalent-job-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/khadinakbar~gulftalent-job-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-gulftalent-job-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/khadinakbar~gulftalent-job-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-gulftalent-job-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": {
          "searchUrls": {
            "title": "GulfTalent search URLs",
            "type": "array",
            "description": "Use public /jobs/search or /api/jobs/search URLs with filters in the query string. Provide at most10 HTTPS GulfTalent URLs without credentials or custom ports. These targets override Keyword and each requests one result window. Country-path URLs, individual jobs and page-based pagination are not supported; use offset and limit1–20.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "keyword": {
            "title": "Job keyword",
            "type": "string",
            "description": "Use this to search GulfTalent by one role or skill phrase, for example data engineer. Ignored when GulfTalent search URLs are supplied. Combine with the filters below to narrow results.",
            "default": "software engineer"
          },
          "maxResults": {
            "title": "Maximum jobs",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Use this to set a predictable cap on billable jobs. The actor stores at most this many unique validated jobs; default 20, maximum 1,000. Free Apify plans return at most 25 per run.",
            "default": 20
          },
          "maxPages": {
            "title": "Maximum search pages to scan",
            "minimum": 0,
            "maximum": 60,
            "type": "integer",
            "description": "Use this to limit how many result pages (20 jobs each) the actor scans. 0 means automatic: enough pages for your Maximum jobs, and up to 25 or more pages when filters or new-jobs-only are on. Ignored when search URLs are supplied.",
            "default": 0
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Use this to keep only jobs in these Gulf countries. Leave empty for all six markets.",
            "items": {
              "type": "string",
              "enum": [
                "AE",
                "SA",
                "QA",
                "KW",
                "BH",
                "OM"
              ],
              "enumTitles": [
                "United Arab Emirates",
                "Saudi Arabia",
                "Qatar",
                "Kuwait",
                "Bahrain",
                "Oman"
              ]
            },
            "default": []
          },
          "city": {
            "title": "City or place contains",
            "type": "string",
            "description": "Use this to keep only jobs whose location contains this text, for example Dubai or Riyadh. Leave empty for any place.",
            "default": ""
          },
          "category": {
            "title": "Job category contains",
            "type": "string",
            "description": "Use this to keep only jobs whose category contains this text, for example Engineering or Finance. Leave empty for any category.",
            "default": ""
          },
          "employmentType": {
            "title": "Employment type contains",
            "type": "string",
            "description": "Use this to keep only jobs of one type, for example full time, contract or part time. Leave empty for any type.",
            "default": ""
          },
          "postedWithinDays": {
            "title": "Posted within days",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Use this to keep only jobs posted in the last N days. 0 means any date. Jobs with no posting date are left out when this is set.",
            "default": 0
          },
          "onlyNewJobs": {
            "title": "Only new jobs since my last run",
            "type": "boolean",
            "description": "Use this for monitoring. The actor remembers the jobs it returned for the same keyword and filters in your own account and returns only jobs it has not returned before. You are charged only for the new jobs delivered.",
            "default": false
          },
          "includeJobDetails": {
            "title": "Include job-page details",
            "type": "boolean",
            "description": "Use this when you need each job's public description, disclosed salary, experience, and other page-level fields. Disable only for a faster search-card export with less complete data.",
            "default": true
          },
          "proxyCountry": {
            "title": "Residential proxy country",
            "enum": [
              "AE",
              "SA",
              "QA",
              "KW",
              "BH",
              "OM"
            ],
            "type": "string",
            "description": "Choose the country for the optional Apify residential fallback. The Actor first tries direct access and an owner-managed country-neutral residential route. This setting is a network preference and does not filter job locations. The owner route also works when the caller has no Apify residential access.",
            "default": "AE"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}