{ "openapi": "3.0.1", "info": { "title": "Bayt.com Jobs Scraper", "description": "[💰 $0.8 / 1K] Extract job listings from Bayt.com, the Middle East's largest job board — UAE, Saudi Arabia, Egypt, Qatar, Kuwait, Jordan, Lebanon, Bahrain, Oman & Morocco. Search by keyword, country and city in English or Arabic. Get title, company, location, posting date, description & apply link.", "version": "1.0", "x-build-id": "jBzTXQfYEf5d3Rk3o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~bayt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-bayt-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/solidcode~bayt-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-bayt-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/solidcode~bayt-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-bayt-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": { "searchKeyword": { "title": "Job Keyword", "type": "string", "description": "Job title or keyword to search for (e.g. 'software engineer', 'accountant', 'nurse', 'sales manager'). Leave blank to collect every job in the selected country." }, "country": { "title": "Country", "enum": [ "uae", "saudi-arabia", "egypt", "qatar", "kuwait", "jordan", "lebanon", "bahrain", "oman", "morocco", "international" ], "type": "string", "description": "Which Bayt.com country site to search. Choose 'International & worldwide' for the widest pool of listings." }, "city": { "title": "City", "type": "string", "description": "Narrow the search to a single city (e.g. 'Dubai', 'Abu Dhabi', 'Riyadh', 'Cairo', 'Doha'). Leave blank to search the whole country." }, "startUrls": { "title": "Start URLs", "uniqueItems": true, "type": "array", "description": "Paste Bayt.com job-search links (e.g. https://www.bayt.com/en/uae/jobs/software-engineer-jobs/) or individual job links. Each link is collected as its own task and results are merged and de-duplicated. When you use this, the keyword, country and city above are ignored — the link already carries its own search. Any filters you set below are still applied, unless the link already specifies them.", "items": { "type": "string" } }, "language": { "title": "Language", "enum": [ "en", "ar" ], "type": "string", "description": "Which language version of Bayt.com to read. Arabic returns the same jobs with Arabic page content where the employer provided it." }, "datePosted": { "title": "Date Posted", "enum": [ "3", "2", "1" ], "type": "string", "description": "Only collect jobs posted within this time window. Leave blank to include jobs of any age." }, "careerLevel": { "title": "Career Level", "enum": [ "1", "2", "3", "5" ], "type": "string", "description": "Only collect jobs advertised at this career level. Note that most employers leave this blank on Bayt, so this filter can return very few jobs." }, "employmentType": { "title": "Employment Type", "enum": [ "1", "5" ], "type": "string", "description": "Only collect full-time or part-time roles. Note that many employers leave this blank on Bayt, so this filter can return far fewer jobs than the unfiltered search." }, "remoteOnly": { "title": "Work-from-home jobs only", "type": "boolean", "description": "Only collect jobs Bayt flags as remote / work from home." }, "easyApplyOnly": { "title": "Easy Apply jobs only", "type": "boolean", "description": "Only collect jobs you can apply to directly on Bayt.com, skipping listings that redirect to an external careers site." }, "sortBy": { "title": "Sort Results By", "enum": [ "r", "d" ], "type": "string", "description": "How Bayt orders the results before they are collected. 'Most recent' is useful when you want the newest postings first and are also setting a maximum." }, "fetchJobDetails": { "title": "Include full job details", "type": "boolean", "description": "Open each job to collect the complete description, application deadline, employment type, career level, company ID and exact address. Turn this off for a faster, lighter run that keeps only the summary shown in the search results. On very large runs a small number of jobs may skip the full details; those rows still arrive with everything shown on the search results page, and the run tells you exactly how many were affected." }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Hard cap on how many jobs to collect. Default 50 — increase for bigger runs, or set to 0 to collect everything that matches. Results arrive from Bayt in pages of 30, and the run always keeps the whole page it is on when the cap is reached, so the number you actually receive rounds up to the next multiple of 30 (ask for 1 and you get 30, ask for 50 and you get 60). Set a multiple of 30 if you want an exact count. Bayt itself never serves more than about 10,000 jobs for a single search, so to go deeper split your run by city or by the filters above." } } }, "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 } } } } } } } } } }