{ "openapi": "3.0.1", "info": { "title": "Bayt.com Scraper - Salaries, Companies & Job Details", "description": "Scrape Bayt.com job listings by keyword, country, or URL. Extract structured data including job title, company, location, salary, experience, career level, posting date, work style, and full job description. Built for recruitment, job aggregation, market research, and workforce analytics.", "version": "1.1", "x-build-id": "yJ446Yr4Vf8t6KDng" }, "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." }, "city": { "title": "City", "type": "string", "description": "Optional city name (for example Dubai) to narrow a keyword search to that city. Needs a keyword; a name Bayt.com does not know is answered with a not-found page, so the run returns no jobs and logs an error." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of the listing: relevance (Bayt.com default) or date (newest first). Also applied to pasted listing URLs that do not already carry a sort.", "default": "relevance" }, "employmentType": { "title": "Employment type filter", "pattern": "^\\s*[0-9]{1,3}\\s*$", "type": "string", "description": "Optional Bayt.com employment-type filter number (the number after filters[jb_employment_type][]= in a Bayt.com filtered link, for example 1). Words such as FULL_TIME are rejected. Leave empty for all types. Also applied to pasted listing URLs that do not already carry it." }, "urls": { "title": "Bayt.com URLs", "type": "array", "description": "Bayt.com listing links (country, keyword, keyword plus city, page, filters, sort, international, Arabic) and single job pages. Search-form links are rewritten to the keyword path; company profile links have no job cards and are skipped with a warning. Country and keyword are ignored in this mode. Pagination starts at the page in the URL and walks forward.", "default": [ "https://www.bayt.com/en/uae/jobs/", "https://www.bayt.com/en/uae/jobs/?q=engineer", "https://www.bayt.com/en/uae/jobs/accountant-jobs/", "https://www.bayt.com/en/uae/jobs/accountant-jobs/?page=2", "https://www.bayt.com/en/uae/jobs/accountant-jobs-in-dubai/", "https://www.bayt.com/en/uae/jobs/accountant-jobs/?filters%5bjb_employment_type%5d%5b%5d=1", "https://www.bayt.com/en/uae/jobs/accountant-jobs/?options%5Bsort%5D%5B%5D=d", "https://www.bayt.com/en/international/jobs/accountant-jobs/", "https://www.bayt.com/en/jobs/accountant-jobs/", "https://www.bayt.com/ar/uae/jobs/accountant-jobs/", "https://www.bayt.com/en/uae/jobs/accountant-5469861/", "https://www.bayt.com/en/company/al-futtaim-group-1661592/", "https://www.bayt.com/en/uae/jobs/search/?jobs_search=accountant" ], "items": { "type": "string" } }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "How many result pages to walk per search (30 jobs per page). 0 (default) means unlimited: the walk stops naturally once a page comes back empty or repeats jobs already collected, or sooner once Max listings is reached. Set a number only for an explicit page cap below that natural stop.", "default": 0 }, "maxListings": { "title": "Max listings (total, default 20, 0 = unlimited)", "minimum": 0, "type": "integer", "description": "The sole soft cap on the run: stop after this many jobs across all searches. Defaults to 20 so a run stays small unless you raise it. 0 = unlimited (bounded only by the natural stop on Max pages).", "default": 20 }, "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" ] } }, "resumeFromRunId": { "title": "Resume from a previous run", "type": "string", "description": "Paste a previous run ID or dataset ID to continue a large crawl of job listings without returning or charging for jobs already collected there. Use this after an interrupted run, or when continuing a job catalogue pull in another run. For recurring daily monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. The first run returns all matching jobs as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED jobs. A job counts as UPDATED when any output field other than the always-ignored scrapedAt, postedAtRelative, postedDate and listingPage (relative or position-dependent values that change with every scrape; postedTimestamp stays compared) and the fields you list under \"Ignore fields when detecting changes\") differs from the last run; changedFields names them. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those jobs returned (and billed). State is kept separately for each country/keyword/city/employment-type/URL and detail-mode setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the country/keyword/URL and detail settings — different searches then never mix state with each other." }, "emitUnchanged": { "title": "Emit unchanged jobs (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return jobs that have not changed since the last run, marked UNCHANGED. This returns — and bills — extra rows you already have, so leave it off unless you specifically want the full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired jobs (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return jobs that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search — not when Max listings capped it or when Resume was used. This returns — and bills — extra synthetic rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Field names that must NOT count as a change when incremental mode compares a job with the last run, so a job that only differs in these fields stays UNCHANGED. Use a dotted path (for example company.name) for a nested field. These are always ignored because they are relative or position-dependent values that change with every scrape: scrapedAt, postedAtRelative, postedDate, listingPage. Every other output field is compared, so any edit to it makes the job UPDATED.", "default": [], "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } }