{ "openapi": "3.0.1", "info": { "title": "Bayt Scraper - Middle East Jobs and Companies", "description": "Extract Bayt.com jobs and company profiles across the Middle East and other Bayt markets. Get titles, salaries, locations, full descriptions and optional company details. Pay per delivered row plus a start fee.", "version": "0.5", "x-build-id": "rrj4j80UfLAIyaj5K" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~bayt-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-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/lentic_clockss~bayt-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-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/lentic_clockss~bayt-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-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": { "mode": { "title": "What to scrape", "enum": [ "auto", "jobs", "jobDetails", "company", "locations", "allJobs" ], "type": "string", "description": "Choose job search, specific job pages, a company profile, locations or all-jobs search. Auto selects a mode from your target fields; empty input starts the three-row example.", "default": "auto" }, "keyword": { "title": "Keyword", "type": "string", "description": "One job title, skill or company search, such as accountant. Leave empty in an explicit jobs or allJobs search to include all matching jobs." }, "country": { "title": "Country", "type": "string", "description": "Country name, code or Bayt slug, such as uae, saudi-arabia or egypt. Leave empty in an explicit search mode for all countries." }, "city": { "title": "City", "type": "string", "description": "City within the country you selected, such as Dubai or Riyadh. Use locations mode with that country to find city names." }, "jobIds": { "title": "Job IDs or URLs", "type": "array", "description": "Bayt job IDs or job URLs to read in full. Auto selects jobDetails when this field is filled.", "items": { "type": "string" } }, "companyUrl": { "title": "Company link or ID", "pattern": "^(\\s*|\\d+|https?://([a-z0-9-]+\\.)*bayt\\.com/.*company/.*)$", "type": "string", "description": "A Bayt company URL, such as https://www.bayt.com/en/company/al-futtaim-1661592/, or its numeric ID. Auto selects company mode when this is the highest-priority target." }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum rows per input, including the company row and any requested job rows; default 70, capped at 5,000 outside allJobs and 100,000 in allJobs. The maximum run cost also applies; Free-plan users have up to 200 rows per run and 10 runs of this Actor.", "default": 70 }, "dateInterval": { "title": "Posted within", "enum": [ "", "24h", "7d", "30d" ], "type": "string", "description": "Limit jobs to those posted or updated within the last 24 hours, 7 days or 30 days. Leave empty for any time.", "default": "" }, "remote": { "title": "Remote jobs only", "type": "boolean", "description": "Apply Bayt's remote-work filter to searches.", "default": false }, "careerLevel": { "title": "Career level", "enum": [ "", "student", "graduate", "entry", "mid", "management", "director", "executive" ], "type": "string", "description": "Filter jobs by the career level shown by Bayt. Leave empty for any level.", "default": "" }, "employmentType": { "title": "Employment type", "enum": [ "", "full time", "part time", "contractor", "temporary", "internship", "freelance" ], "type": "string", "description": "Filter jobs by employment arrangement, such as full time, part time or freelance. Leave empty for any type.", "default": "" }, "sortBy": { "title": "Sort", "enum": [ "relevance", "date" ], "type": "string", "description": "Use Bayt relevance order or show the newest jobs first. All-jobs searches read each group newest first.", "default": "relevance" }, "enrichDetails": { "title": "Read full job pages", "type": "boolean", "description": "Add full descriptions, skills and other available job-page fields to matching job rows. This enriches the same rows without a separate row charge.", "default": false }, "enrichLimit": { "title": "Job pages to read", "minimum": 0, "maximum": 300, "type": "integer", "description": "Maximum matching jobs to enrich with full-page fields, from 0 to 300 and no more than maxResults. Used when enrichDetails is enabled.", "default": 30 }, "includeSimilarJobs": { "title": "Similar job IDs", "type": "boolean", "description": "In jobDetails mode, include IDs of similar jobs when Bayt supplies them. These IDs remain inside the job row.", "default": false }, "includeCompanyJobs": { "title": "Company's open jobs", "type": "boolean", "description": "In company mode, add open jobs after the company row. Each job is separately billed and shares the company input row limit.", "default": false }, "includeCompanyPage": { "title": "Company website and employees", "type": "boolean", "description": "In company mode, add the website, introduction, followers and up to 50 listed employees from the public company page when available. Employees remain part of the company row and are not billed separately.", "default": false }, "cursor": { "title": "Continue from (cursor)", "type": "string", "description": "Continue an allJobs search using RUN_SUMMARY.nextCursor from an earlier run with the same search input. Leave empty to start from the beginning.", "default": "" } } }, "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 } } } } } } } } } }