{ "openapi": "3.0.1", "info": { "title": "Bayt.com Jobs Scraper | Search, URLs & Job Details", "description": "Extract Bayt.com job listings by keyword, country, or URL. Get structured data including title, company, location, salary, experience, career level, posting date, work style, and full job description. Ideal for recruitment, analytics, and job aggregation.", "version": "1.0", "x-build-id": "eSxlaF3Am47MGOxA9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~bayt-com-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-bayt-com-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/abotapi~bayt-com-jobs-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-bayt-com-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/abotapi~bayt-com-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-bayt-com-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", "required": [ "mode" ], "properties": { "mode": { "title": "1. Mode", "enum": [ "search", "url" ], "type": "string", "description": "search = build a search from a country and keyword. url = paste one or more Bayt.com search URLs and walk them forward.", "default": "search" }, "country": { "title": "Country", "enum": [ "uae", "saudi-arabia", "egypt", "qatar", "kuwait", "bahrain", "oman", "jordan", "lebanon", "iraq", "morocco", "tunisia", "algeria", "pakistan", "international" ], "type": "string", "description": "Market to search. Bayt.com is organized by country.", "default": "uae" }, "keyword": { "title": "Keyword / job title", "type": "string", "description": "Optional free-text search, e.g. \"accountant\", \"software engineer\", \"sales manager\". Leave blank to list all jobs in the chosen country." }, "urls": { "title": "Search URLs", "type": "array", "description": "One or more Bayt.com search URLs, e.g. https://www.bayt.com/en/uae/jobs/accountant-jobs/. Multi-URL supported. Country and keyword fields are ignored in this mode. Pagination starts at the page in the URL and walks forward.", "items": { "type": "string" } }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 350, "type": "integer", "description": "How many result pages to walk per search (30 jobs per page).", "default": 1 }, "maxListings": { "title": "Max listings (0 = unlimited)", "minimum": 0, "type": "integer", "description": "Global cap on the number of jobs to return across all searches. 0 means no cap (bounded by maxPages).", "default": 0 }, "fetchDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Open each job page to add the full description, employment type, posting and expiry dates, vacancies, and company size. Adds one request per job (billed as a detail-enrichment surcharge). Turn off for a faster, lighter run that uses only the search-card fields.", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Bayt.com only accepts traffic from residential connections. Apify Residential proxy (any country) is strongly recommended. Datacenter connections are rejected.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }