# Bayut Property Scraper (`axlymxp/bayut-property-scraper`) Actor Scrape Bayut UAE property listings at scale — price, beds, area, GPS, photos, agent phone & WhatsApp, agency and TruCheck verification as structured JSON. Filter by location, category, price and beds. Built for investors, agencies and PropTech. Pay only for the results you get. - **URL**: https://apify.com/axlymxp/bayut-property-scraper.md - **Developed by:** [axly](https://apify.com/axlymxp) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 1,000 dataset items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Bayut Property Scraper Extract **Bayut** property listings across the United Arab Emirates as clean, structured JSON — **price, bedrooms, area, GPS coordinates, photos, agent phone & WhatsApp, agency and TruCheck verification** — ready for Google Sheets, a CRM, or your own analytics pipeline. Built on Bayut's own **mobile search API**, so it is fast and reliable: no brittle HTML parsing, no CAPTCHAs, no login. Search by location name, filter the way you would on the site, and paginate straight through the results. --- ### Who uses this - **Property investors & analysts** — build price-per-m²/sqft datasets, track new and off-plan supply by area, and spot deals across Dubai and Abu Dhabi. - **Real-estate agencies & lead-gen teams** — pull listings with agent phone, WhatsApp and agency name for competitive and outreach research. - **PropTech & SaaS developers** — feed a stable, well-documented JSON schema into portals, valuation models and market dashboards. - **Researchers & journalists** — quantify the UAE housing market by location, price band, completion status and verification. --- ### Output fields Each listing becomes one row: | Field | Type | Description | | ------------------------------------------------------------ | ------- | ----------------------------------------------- | | `id` | string | Bayut listing external ID | | `reference` | string | Agency reference number | | `title` | string | Listing headline | | `url` | string | Bayut property page URL | | `purpose` | string | `for-sale` or `for-rent` | | `category` / `category_name` / `category_path` | string | Property category (apartments, villas, …) | | `price` | number | Price in AED | | `currency` | string | Always `AED` | | `rent_frequency` | string | Rental period (yearly/monthly/…) — rentals only | | `bedrooms` | number | Bedroom count (0 = studio) | | `bathrooms` | number | Bathroom count | | `area_sqm` / `area_sqft` | number | Built-up area in m² and ft² | | `plot_area_sqm` / `plot_area_sqft` | number | Plot area where applicable | | `furnishing_status` | string | furnished / unfurnished / partly-furnished | | `completion_status` | string | completed / under-construction | | `occupancy_status` | string | vacant / occupied (rentals) | | `is_verified` | boolean | Bayut TruCheck verified | | `verified_score` / `truchecked_score` / `trubroker_score` | number | Quality scores | | `location_name` / `location_path` / `location_slug` / `city` | string | Location hierarchy | | `latitude` / `longitude` | number | GPS coordinates | | `cover_photo` | string | Cover image URL | | `photos` | array | All listing image URLs | | `photo_count` / `video_count` / `panorama_count` | number | Media counts | | `amenities` | array | Amenity names | | `contact_name` | string | Listing contact | | `contact_phone` / `contact_mobile` / `contact_whatsapp` | string | Agent contact | | `agency` | object | `{ id, name, location }` | | `agent_id` | string | Agent external ID | | `offplan_details` / `payment_plans` | object | Off-plan sale type & payment plan | | `created_at` / `updated_at` | string | Listing timestamps (ISO-8601) | | `scraped_at` | string | Extraction timestamp (ISO-8601) | > Latitude/longitude are emitted as `latitude` and `longitude` from the listing's > geolocation. --- ### High-value use cases 1. **Investment research** — scrape all verified apartments for sale in a price band and compute price-per-ft², yield vs rentals, and area-level supply. 2. **Lead lists** — collect listings with agent phone/WhatsApp and agency for a given community to build an outreach list. 3. **Market monitoring** — schedule a daily run sorted by _newest_ to track fresh inventory and price changes over time. 4. **Off-plan tracking** — filter `completion_status = under-construction` to follow new-development supply and payment plans. 5. **Comparative dashboards** — combine sale and rent runs by location to model gross rental yields. --- ### Input parameters | Field | Type | Default | Description | | ----------------------- | ------- | -------------- | ------------------------------------------------------- | | `purpose` | string | `for-sale` | `for-sale` or `for-rent` | | `category` | string | (all) | apartments, villas, townhouses, offices, … | | `location` | string | `Dubai Marina` | Place name, auto-resolved to a Bayut location | | `locationExternalIds` | array | — | Exact Bayut location IDs (advanced) | | `listingUrls` | array | — | Direct property URLs / IDs (direct mode) | | `minPrice` / `maxPrice` | integer | — | Price range in AED | | `minBeds` / `maxBeds` | integer | — | Bedroom range (0 = studio) | | `minBaths` | integer | — | Minimum bathrooms | | `minArea` / `maxArea` | integer | — | Area range in ft² | | `furnishing` | string | — | furnished / unfurnished / partly-furnished | | `completionStatus` | string | — | completed / under-construction | | `rentFrequency` | string | — | yearly / monthly / weekly / daily (rentals) | | `verifiedOnly` | boolean | `false` | Only TruCheck-verified listings | | `keywords` | string | — | Free-text match (e.g. "sea view") | | `sort` | string | `default` | relevance / verified / newest / oldest / price asc/desc | | `maxItems` | integer | `100` | Stop after this many listings | | `language` | string | `en` | `en` or `ar` | #### Example input ```json { "purpose": "for-sale", "category": "apartments", "location": "Dubai Marina", "minBeds": 1, "minPrice": 800000, "maxPrice": 2500000, "verifiedOnly": true, "sort": "newest", "maxItems": 200 } ```` #### Example output (one row, trimmed) ```json { "id": "14906927", "title": "Below OP 1BR | Golf Facing unit | Vida Branded", "url": "https://www.bayut.com/property/details-14906927.html", "purpose": "for-sale", "category": "apartments", "price": 1400000, "currency": "AED", "bedrooms": 1, "bathrooms": 2, "area_sqm": 69.4, "area_sqft": 747.1, "completion_status": "under-construction", "is_verified": true, "location_name": "Vida Residences Dubai Mall", "city": "Dubai", "latitude": 25.1286, "longitude": 55.2616, "cover_photo": "https://images.bayut.com/thumbnails/844805045-800x600.jpeg", "contact_name": "Muhammad Nauman", "contact_phone": "+971521343659", "contact_whatsapp": "971545695868", "agency": { "id": "103201", "name": "Real Tree Properties", "location": "Dubai" }, "scraped_at": "2026-07-27T10:00:00+00:00" } ``` *** ### Direct mode Pass specific listings instead of searching: ```json { "listingUrls": [ "https://www.bayut.com/property/details-14906927.html", "14990477" ] } ``` *** ### Scheduling & integrations - **Schedule** daily/weekly runs from the Apify Console to keep a fresh dataset. - **Webhooks** notify your systems on finish; export to **Google Sheets, Make, Zapier, Amazon S3** or download as JSON/CSV/Excel. - Every run's dataset is available through the Apify API for your own pipelines. ### Use with AI assistants (MCP) This actor is available through the **Apify MCP server**, so AI assistants (Claude, ChatGPT, and other MCP clients) can call it as a tool and pull live Bayut data into an agent workflow. *** ### FAQ **How many listings can I get per run?** As many as match your query, up to `maxItems`. Bayut caps deep pagination near 50,000 results per query — split by price band or sub-location (e.g. per community) to exhaust larger markets. **Does it include agent contact details?** Yes — `contact_phone`, `contact_mobile`, `contact_whatsapp` and the `agency` come straight from the listing. **Which locations are covered?** All of the UAE (Dubai, Abu Dhabi, Sharjah, Ajman, Ras Al Khaimah, Fujairah, Umm Al Quwain). Use a place name and it is auto-resolved. **Is the data fresh?** Every run fetches live data from Bayut's search backend. **Is it reliable?** It uses Bayut's mobile API (structured JSON) rather than scraping HTML, so it does not break on layout changes and needs no CAPTCHA solving. **Is scraping this legal?** The actor collects publicly available listing data. You are responsible for using the output in line with Bayut's terms and applicable laws (including privacy rules for personal/contact data). *** *Not affiliated with or endorsed by Bayut. "Bayut" is a trademark of its owner and used here for descriptive purposes only.* # Actor input Schema ## `purpose` (type: `string`): Scrape properties for sale or for rent. ## `category` (type: `string`): Filter by property category. Leave empty for all categories. ## `location` (type: `string`): A place name to auto-resolve (e.g. 'Dubai Marina', 'Business Bay', 'Abu Dhabi', 'JVC'). Leave empty to scrape the whole UAE, or use Location External IDs / Listing URLs. ## `locationExternalIds` (type: `array`): Optional. Exact Bayut location external IDs (e.g. 5002 = Dubai, 5003 = Dubai Marina). Overrides 'Location name' when set. ## `listingUrls` (type: `array`): Optional. Direct Bayut property page links (e.g. https://www.bayut.com/property/details-14906927.html) or bare property IDs to scrape specific listings instead of searching. ## `minPrice` (type: `integer`): Optional minimum price in AED. ## `maxPrice` (type: `integer`): Optional maximum price in AED. ## `minBeds` (type: `integer`): Optional minimum bedroom count (0 = studio). ## `maxBeds` (type: `integer`): Optional maximum bedroom count. ## `minBaths` (type: `integer`): Optional minimum bathroom count. ## `minArea` (type: `integer`): Optional minimum built-up area in square feet. ## `maxArea` (type: `integer`): Optional maximum built-up area in square feet. ## `furnishing` (type: `string`): Optional furnishing filter. ## `completionStatus` (type: `string`): Optional. Filter completed (ready) vs off-plan (under construction) properties. ## `rentFrequency` (type: `string`): Optional — only for rentals. Filter by rent period. ## `verifiedOnly` (type: `boolean`): Only include Bayut-verified (TruCheck) listings. ## `keywords` (type: `string`): Optional free-text keywords to match (e.g. 'sea view', 'maid room', 'burj khalifa view'). ## `sort` (type: `string`): Result ordering. ## `maxItems` (type: `integer`): Stop after collecting this many listings. Note: Bayut caps deep pagination near 50,000 results per query — split by price band or sub-location to collect more. ## `hitsPerPage` (type: `integer`): Listings fetched per request (1–50). ## `language` (type: `string`): Language for localized text (e.g. en, ar). ## Actor input object example ```json { "purpose": "for-sale", "location": "Dubai Marina", "locationExternalIds": [], "listingUrls": [], "verifiedOnly": false, "sort": "default", "maxItems": 100, "hitsPerPage": 25, "language": "en" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": "Dubai Marina", "locationExternalIds": [], "listingUrls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("axlymxp/bayut-property-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": "Dubai Marina", "locationExternalIds": [], "listingUrls": [], } # Run the Actor and wait for it to finish run = client.actor("axlymxp/bayut-property-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "location": "Dubai Marina", "locationExternalIds": [], "listingUrls": [] }' | apify call axlymxp/bayut-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=axlymxp/bayut-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bayut Property Scraper", "description": "Scrape Bayut UAE property listings at scale — price, beds, area, GPS, photos, agent phone & WhatsApp, agency and TruCheck verification as structured JSON. Filter by location, category, price and beds. Built for investors, agencies and PropTech. Pay only for the results you get.", "version": "1.0", "x-build-id": "hlFQ2wejzJQf7pj0K" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~bayut-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-bayut-property-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/axlymxp~bayut-property-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-bayut-property-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/axlymxp~bayut-property-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-bayut-property-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": { "purpose": { "title": "Purpose", "enum": [ "for-sale", "for-rent" ], "type": "string", "description": "Scrape properties for sale or for rent.", "default": "for-sale" }, "category": { "title": "Property category", "enum": [ "apartments", "villas", "townhouses", "penthouses", "hotel-apartments", "residential-plots", "residential-building", "residential-floors", "villa-compound", "offices", "shops", "warehouses", "commercial-plots", "commercial-villas", "labour-camps", "commercial-building", "factories", "showrooms" ], "type": "string", "description": "Filter by property category. Leave empty for all categories." }, "location": { "title": "Location name", "type": "string", "description": "A place name to auto-resolve (e.g. 'Dubai Marina', 'Business Bay', 'Abu Dhabi', 'JVC'). Leave empty to scrape the whole UAE, or use Location External IDs / Listing URLs." }, "locationExternalIds": { "title": "Location external IDs (advanced)", "type": "array", "description": "Optional. Exact Bayut location external IDs (e.g. 5002 = Dubai, 5003 = Dubai Marina). Overrides 'Location name' when set.", "items": { "type": "string" } }, "listingUrls": { "title": "Listing URLs (direct mode)", "type": "array", "description": "Optional. Direct Bayut property page links (e.g. https://www.bayut.com/property/details-14906927.html) or bare property IDs to scrape specific listings instead of searching.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (AED)", "type": "integer", "description": "Optional minimum price in AED." }, "maxPrice": { "title": "Maximum price (AED)", "type": "integer", "description": "Optional maximum price in AED." }, "minBeds": { "title": "Minimum bedrooms", "type": "integer", "description": "Optional minimum bedroom count (0 = studio)." }, "maxBeds": { "title": "Maximum bedrooms", "type": "integer", "description": "Optional maximum bedroom count." }, "minBaths": { "title": "Minimum bathrooms", "type": "integer", "description": "Optional minimum bathroom count." }, "minArea": { "title": "Minimum area (sqft)", "type": "integer", "description": "Optional minimum built-up area in square feet." }, "maxArea": { "title": "Maximum area (sqft)", "type": "integer", "description": "Optional maximum built-up area in square feet." }, "furnishing": { "title": "Furnishing", "enum": [ "furnished", "unfurnished", "partly-furnished" ], "type": "string", "description": "Optional furnishing filter." }, "completionStatus": { "title": "Completion status", "enum": [ "completed", "under-construction" ], "type": "string", "description": "Optional. Filter completed (ready) vs off-plan (under construction) properties." }, "rentFrequency": { "title": "Rent period", "enum": [ "yearly", "monthly", "weekly", "daily" ], "type": "string", "description": "Optional — only for rentals. Filter by rent period." }, "verifiedOnly": { "title": "Verified listings only", "type": "boolean", "description": "Only include Bayut-verified (TruCheck) listings.", "default": false }, "keywords": { "title": "Keywords", "type": "string", "description": "Optional free-text keywords to match (e.g. 'sea view', 'maid room', 'burj khalifa view')." }, "sort": { "title": "Sort order", "enum": [ "default", "verified", "newest", "oldest", "price_asc", "price_desc" ], "type": "string", "description": "Result ordering.", "default": "default" }, "maxItems": { "title": "Max listings", "minimum": 1, "type": "integer", "description": "Stop after collecting this many listings. Note: Bayut caps deep pagination near 50,000 results per query — split by price band or sub-location to collect more.", "default": 100 }, "hitsPerPage": { "title": "Page size (advanced)", "minimum": 1, "maximum": 50, "type": "integer", "description": "Listings fetched per request (1–50).", "default": 25 }, "language": { "title": "Language", "type": "string", "description": "Language for localized text (e.g. en, ar).", "default": "en" } } }, "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 } } } } } } } } } } ```