{
  "openapi": "3.0.1",
  "info": {
    "title": "Naukrigulf Scraper: Gulf Jobs, Salaries and New Job Alerts",
    "description": "Naukrigulf scraper for Gulf and Middle East jobs (UAE, Saudi Arabia, Qatar, Kuwait, Oman, Bahrain, Egypt). Many keywords and locations per run, country, industry, experience and salary filters, salary as numbers, no start fee. Monitor mode returns only new jobs.",
    "version": "0.1",
    "x-build-id": "evyy2cMOolcIsNJfD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datahamster~naukrigulf-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datahamster-naukrigulf-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~naukrigulf-scraper/runs": {
      "post": {
        "operationId": "runs-sync-datahamster-naukrigulf-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~naukrigulf-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-datahamster-naukrigulf-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 keywords",
            "type": "array",
            "description": "Job keywords, one per line, e.g. \"accountant\", \"python developer\", \"nurse\". Each keyword is searched in each location below. Leave empty to list jobs by the other filters only; note that without a keyword Naukrigulf lists jobs imported from company career sites only after all jobs posted on Naukrigulf itself, so a search (or monitor) without keyword misses most of them.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Cities or countries the way Naukrigulf's location box takes them, one per line, e.g. \"Dubai\", \"Riyadh\", \"Doha\", \"Saudi Arabia\". Every keyword is searched in every location. Leave empty for all locations. Use the site's spelling; \"KSA\", \"RAK\", \"Mecca\" and \"Medina\" are sent as \"Saudi Arabia\", \"Ras Al Khaimah\", \"Makkah\" and \"Madinah\" (the site itself reads KSA as Kuwait). A place the site does not know is ignored by the site; the actor then returns nothing for that search and names the place in the log and status.",
            "items": {
              "type": "string"
            }
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Keep only jobs in these countries (the site's country filter; several allowed), e.g. [\"UAE\", \"Qatar\"]. Combines with locations. Empty = all countries.",
            "items": {
              "type": "string",
              "enum": [
                "UAE",
                "Saudi Arabia",
                "Qatar",
                "Kuwait",
                "Oman",
                "Bahrain",
                "Egypt",
                "Lebanon",
                "Jordan",
                "Iraq",
                "Morocco",
                "Algeria",
                "Tunisia",
                "Libya",
                "Palestine",
                "Syria",
                "Yemen",
                "India",
                "Pakistan"
              ],
              "enumTitles": [
                "United Arab Emirates (UAE)",
                "Saudi Arabia",
                "Qatar",
                "Kuwait",
                "Oman",
                "Bahrain",
                "Egypt",
                "Lebanon",
                "Jordan",
                "Iraq",
                "Morocco",
                "Algeria",
                "Tunisia",
                "Libya",
                "Palestine",
                "Syria",
                "Yemen",
                "India",
                "Pakistan"
              ]
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Keep only jobs of these industries (the site's industry filter), e.g. [\"IT\", \"Banking and Finance\"]. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "IT",
                "Construction",
                "Hospitality",
                "Recruitment",
                "Medical",
                "Engineering",
                "Education",
                "Banking and Finance",
                "Oil and Gas",
                "Consulting",
                "Real Estate",
                "FMCG",
                "Automobile",
                "Retail",
                "Advertising",
                "Logistics",
                "E-commerce",
                "Power Generation",
                "Accounting",
                "Architecture",
                "Consumer Durables",
                "Heavy Machinery",
                "Catering",
                "Steel Fabrication",
                "Cement",
                "Telecom"
              ],
              "enumTitles": [
                "IT",
                "Construction",
                "Hospitality",
                "Recruitment",
                "Medical",
                "Engineering",
                "Education",
                "Banking and Finance",
                "Oil and Gas",
                "Consulting",
                "Real Estate",
                "FMCG",
                "Automobile",
                "Retail",
                "Advertising",
                "Logistics",
                "E-commerce",
                "Power Generation",
                "Accounting",
                "Architecture",
                "Consumer Durables",
                "Heavy Machinery",
                "Catering",
                "Steel Fabrication",
                "Cement",
                "Telecom"
              ]
            }
          },
          "experienceYears": {
            "title": "Years of experience",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Keep only jobs whose required experience range includes this number of years (the site's filter, checked again on every row). Example: 3 keeps a 2-5 years job and drops a 5-10 years job. Empty = any."
          },
          "postedWithin": {
            "title": "Posted within",
            "enum": [
              "any",
              "1d",
              "3d",
              "7d",
              "15d",
              "30d"
            ],
            "type": "string",
            "description": "Keep only jobs posted in this window (the site's freshness filter). The site keeps jobs for about 60 days. Example: 7d.",
            "default": "any"
          },
          "salaryBandsUsd": {
            "title": "Monthly salary band (USD)",
            "type": "array",
            "description": "Keep only jobs in these monthly salary bands, in US dollars (the site's salary filter). The site files a job under the employer's range even when the employer hides the figure, so many matching jobs have no salary numbers. Example: [\"2001-3000\", \"3001-4000\"]. Empty = any salary.",
            "items": {
              "type": "string",
              "enum": [
                "0-500",
                "501-1000",
                "1001-2000",
                "2001-3000",
                "3001-4000",
                "4001-5000",
                "5001-6000",
                "6001-7000",
                "7001-8000",
                "8001-9000",
                "9001-10000",
                "10001-15000",
                "15001-30000",
                "30001-50000",
                "50000+"
              ],
              "enumTitles": [
                "Up to $500",
                "$501 - $1,000",
                "$1,001 - $2,000",
                "$2,001 - $3,000",
                "$3,001 - $4,000",
                "$4,001 - $5,000",
                "$5,001 - $6,000",
                "$6,001 - $7,000",
                "$7,001 - $8,000",
                "$8,001 - $9,000",
                "$9,001 - $10,000",
                "$10,001 - $15,000",
                "$15,001 - $30,000",
                "$30,001 - $50,000",
                "Above $50,000"
              ]
            }
          },
          "sortBy": {
            "title": "Sort",
            "enum": [
              "relevance",
              "date"
            ],
            "type": "string",
            "description": "Order of the site's results. Monitor mode always reads newest first. Example: date.",
            "default": "relevance"
          },
          "includeDetails": {
            "title": "Include job details",
            "type": "boolean",
            "description": "Read each job's page too: salary as numbers (min, max, currency, monthly), full description, desired candidate, company description, industry, functional area, education, employment and workplace type, apply URL of imported jobs. One extra request per job.",
            "default": false
          },
          "maxResultsPerSearch": {
            "title": "Max jobs per search",
            "minimum": 1,
            "maximum": 45000,
            "type": "integer",
            "description": "How deep each keyword x location search reads (50 jobs per page). Empty = 1,000 in scrape mode, 200 in monitor mode. The site serves at most 45,000 jobs per search."
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}