# Property Finder Scraper (`crawlerbros/propertyfinder-scraper`) Actor Scrape property listings from Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt). Extract prices, locations, photos, agent info, and 50+ fields per listing. No proxy required. - **URL**: https://apify.com/crawlerbros/propertyfinder-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 9 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Property Finder Scraper Scrape property listings from [Property Finder](https://www.propertyfinder.ae) — the leading real estate portal in UAE, Saudi Arabia, Qatar, Bahrain and Egypt. Extract prices, locations, photos, agent info, amenities, and 50+ fields per listing. ### What This Actor Does This actor scrapes Property Finder across all supported countries and categories. Provide search URLs directly or use city + purpose filters to find listings across sale, rent, and commercial property segments. The scraper uses Property Finder's public sitemaps for discovery and extracts structured data directly from server-rendered pages. No proxy required, no browser needed. ### Key Features - **50+ fields per listing** — price, bedrooms, bathrooms, size, location hierarchy, agent info, broker info, amenities, RERA permit, status flags, and more - **5 countries** — UAE, Saudi Arabia, Qatar, Bahrain, Egypt - **All UAE emirates + Saudi cities** — Dubai, Abu Dhabi, Sharjah, Ajman, Ras Al Khaimah, Fujairah, Umm Al Quwain, Al Ain, Riyadh, Jeddah, Dammam and more - **4 purposes** — For Sale, For Rent, Commercial For Sale, Commercial For Rent - **Two input modes** — paste URLs or use city + purpose filters - **Location hierarchy** — city → community → sub-community → tower with IDs and slugs - **Agent & broker contacts** — name, email, phone, WhatsApp, profile image - **No null fields** — every output field is populated or set to a safe default - **Automatic deduplication** — same property won't appear twice even across different landing pages - **No proxy required** — runs reliably on any Apify plan ### Supported Property Types Apartments, Villas, Townhouses, Penthouses, Duplexes, Hotel Apartments, Compounds, Floors, Land, Villa Compounds, Offices, Shops, Warehouses, Factories, Labour Camps, Bulk Units. ### Supported Locations #### UAE Dubai, Abu Dhabi, Sharjah, Ajman, Ras Al Khaimah, Fujairah, Umm Al Quwain, Al Ain #### Saudi Arabia Riyadh, Jeddah, Dammam, Makkah, Madinah, Khobar #### Also Supported Qatar (propertyfinder.qa), Bahrain (propertyfinder.bh), Egypt (propertyfinder.eg) ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | array | — | Property Finder URLs to scrape (landing pages, sitemaps, or sitemap index) | | `country` | enum | `ae` | Country to search in (ae, sa, bh, eg, qa) | | `city` | enum | `dubai` | City to search in | | `purpose` | enum | `buy` | buy, rent, commercial-buy, commercial-rent | | `max_items` | integer | 20 | Maximum unique properties to scrape | | `max_retries` | integer | 2 | Retry attempts per failed request | | `ignore_url_failures` | boolean | true | Continue on errors | ### Usage Examples #### Scrape properties from a specific landing page ```json { "startUrls": [ "https://www.propertyfinder.ae/en/buy/dubai/2-bedroom-apartments-for-sale-dubai-land-ghaf-woods-cilia-at-ghaf-woods-cilia-tower-2.html" ], "max_items": 20 } ```` #### Scrape all Dubai apartments for sale (filter mode) ```json { "city": "dubai", "purpose": "buy", "max_items": 100 } ``` #### Scrape Saudi Arabia listings ```json { "country": "sa", "city": "riyadh", "purpose": "buy", "max_items": 50 } ``` #### Scrape rentals in Abu Dhabi ```json { "city": "abu-dhabi", "purpose": "rent", "max_items": 100 } ``` #### Expand from sitemap index (maximum coverage) ```json { "startUrls": [ "https://www.propertyfinder.ae/sitemaps/index-sitemap.xml" ], "max_items": 500 } ``` ### Output Fields | Field | Type | Description | |-------|------|-------------| | `id` | number | Property Finder numeric ID | | `listingId` | string | Alphanumeric listing identifier | | `reference` | string | Agency reference number | | `rera` | string | RERA permit number | | `url` | string | Canonical detail URL | | `title` | string | Listing title | | `description` | string | Full description | | `propertyType` | string | Type (Apartment, Villa, etc.) | | `offeringType` | string | e.g. "Residential for Sale" | | `categoryId` | number | 1=Sale, 2=Rent, 3=Commercial Sale, 4=Commercial Rent | | `price` | number | Price value | | `priceCurrency` | string | AED/SAR/QAR/BHD/EGP | | `priceDuration` | string | sell/yearly/monthly/weekly/daily | | `pricePerArea` | number | Price per unit area | | `pricePerAreaUnit` | string | sqft/sqm | | `bedrooms` | number | Number of bedrooms | | `bathrooms` | number | Number of bathrooms | | `size` | number | Size value | | `sizeUnit` | string | Size unit (sqft/sqm) | | `furnished` | string | YES/NO/PARTLY | | `completionStatus` | string | completed/off\_plan | | `city` | string | City name | | `community` | string | Community/area | | `subCommunity` | string | Sub-community | | `tower` | string | Tower/building name | | `locationTree` | array | Hierarchical `[{id, name, type, slug, level}]` | | `latitude` | number | GPS latitude | | `longitude` | number | GPS longitude | | `coverImage` | string | Main photo URL | | `images` | array | All photo URLs | | `imagesCount` | number | Number of images | | `amenities` | array | Amenity codes | | `amenityNames` | array | Human-readable amenity names | | `agentName` | string | Agent full name | | `agentEmail` | string | Agent email | | `agentPhone` | string | Agent phone | | `agentWhatsapp` | string | Agent WhatsApp | | `agentImage` | string | Agent profile photo URL | | `brokerName` | string | Agency/broker name | | `brokerLogo` | string | Agency logo URL | | `brokerPhone` | string | Agency phone | | `brokerEmail` | string | Agency email | | `isVerified` | boolean | Verified listing | | `isDirectFromDeveloper` | boolean | Direct from developer | | `isNewConstruction` | boolean | New construction | | `isFeatured` | boolean | Featured listing | | `isPremium` | boolean | Premium placement | | `isExclusive` | boolean | Exclusive listing | | `isAvailable` | boolean | Currently available | | `leadValue` | number | Lead quality score | | `listingLevel` | string | Listing tier | | `videoUrl` | string | Video URL | | `has360View` | boolean | Has 360° view | | `listedDate` | string | Date listed (ISO 8601) | | `scrapedAt` | string | Scrape timestamp (ISO 8601) | ### Sample Output ```json { "id": 75010975, "listingId": "9WYS2AVTMRJP9HKQHEDEY797BM", "rera": "71149781518", "title": "Luxury 2BR | Downtown Dubai | Sea View", "propertyType": "Apartment", "offeringType": "Residential for Sale", "categoryId": 1, "price": 2600000, "priceCurrency": "AED", "priceDuration": "sell", "pricePerArea": 2126, "pricePerAreaUnit": "sqft", "bedrooms": 2, "bathrooms": 3, "size": 1250, "sizeUnit": "sqft", "furnished": "YES", "completionStatus": "completed", "city": "Dubai", "community": "Downtown Dubai", "subCommunity": "Boulevard Walk", "tower": "Tower A", "latitude": 25.0762, "longitude": 55.1358, "coverImage": "https://img.pf.ae/cover.jpg", "images": ["https://img.pf.ae/1.jpg", "https://img.pf.ae/2.jpg"], "imagesCount": 8, "amenityNames": ["Central A/C", "Built in Wardrobes", "Shared Pool", "Shared Gym"], "agentName": "Jane Agent", "agentEmail": "jane@agency.ae", "agentPhone": "+971501234567", "brokerName": "Best Realty", "brokerLogo": "https://img.pf.ae/logo.jpg", "isVerified": true, "isAvailable": true, "listedDate": "2025-03-15T10:30:00+00:00", "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-downtown-dubai-75010975.html", "scrapedAt": "2026-04-10T12:00:00+00:00" } ``` ### FAQs #### How do I find URLs to paste? Browse Property Finder normally and copy URLs from the address bar. The scraper supports landing pages, sitemap URLs, and the sitemap index. Or use the city + purpose filters to let the actor discover URLs for you. #### Can I scrape all Dubai listings at once? Yes — provide the sitemap index URL `https://www.propertyfinder.ae/sitemaps/index-sitemap.xml` and set a high `max_items`. The actor will expand it into all available landing pages. #### Does it support Saudi Arabia? Yes — use `country=sa` and a Saudi city (Riyadh, Jeddah, Dammam, etc.), or pass a propertyfinder.sa URL. #### Can I filter by bedrooms, price, or area? Directly — no. The filter mode uses city + purpose only. For fine-grained filtering, browse Property Finder's website with your desired filters applied, then paste the resulting URLs into `startUrls`. #### What if a URL returns no results? The actor logs a warning and continues with the remaining URLs. Set `ignore_url_failures` to `false` to stop on first failure. #### Does this work on the Apify FREE plan? Yes. The scraper runs entirely without residential proxies and without browsers, so it fits comfortably within free plan compute limits. #### How do I get verified listings only? All listings include an `isVerified` boolean — filter the output downstream (e.g., in a Google Sheet or database) to keep only `isVerified=true` entries. #### How fresh is the data? The actor fetches live data on each run. Schedule daily runs on Apify to track new listings, price changes, and delistings. ### Use Cases - **Real estate market analysis** — Track price trends and inventory across UAE and Saudi markets - **Lead generation** — Extract agent and agency contact info for business outreach - **Price monitoring** — Schedule daily runs to detect price changes in specific areas - **Investment research** — Compare properties by location, size, amenities, and RERA status - **Competitive analysis** — Monitor agency listings and market share - **Data enrichment** — Combine with other sources for comprehensive market intelligence - **Off-plan tracking** — Identify new construction and direct-from-developer properties ### About Property Finder [Property Finder](https://www.propertyfinder.ae) is the leading property portal in the United Arab Emirates and the wider Middle East region, listing millions of residential and commercial properties for sale and rent across Dubai, Abu Dhabi, Sharjah, and other major cities. It operates dedicated sites for UAE, Saudi Arabia, Qatar, Bahrain, and Egypt. # Actor input Schema ## `startUrls` (type: `array`): Property Finder URLs to scrape. Supports: - SEO landing pages (e.g. /en/buy/dubai/apartments-for-sale-marina.html) - Sitemap URLs (e.g. /sitemaps/dubai-buy-0.xml) - Sitemap index (/sitemaps/index-sitemap.xml) ## `country` (type: `string`): Country to search in (used only when no URLs are provided). ## `city` (type: `string`): City to search in. ## `purpose` (type: `string`): Listing purpose. ## `fetch_full_details` (type: `boolean`): When enabled, the scraper fetches each listing's detail page to retrieve the complete image gallery, full description, floor plans, and all extended fields. Disables if you only need basic listing info. Adds 1 HTTP request per property. ## `max_items` (type: `integer`): Maximum number of unique properties to scrape. ## `max_retries` (type: `integer`): Maximum retry attempts for each failed request. ## `ignore_url_failures` (type: `boolean`): Continue running even if some URLs fail after max retries. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.propertyfinder.ae/sitemaps/dubai-buy-0.xml" } ], "country": "ae", "city": "dubai", "purpose": "buy", "fetch_full_details": false, "max_items": 5, "max_retries": 2, "ignore_url_failures": true } ``` # Actor output Schema ## `listings` (type: `string`): No description # 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 = { "startUrls": [ { "url": "https://www.propertyfinder.ae/sitemaps/dubai-buy-0.xml" } ], "fetch_full_details": false, "max_items": 5, "max_retries": 2, "ignore_url_failures": true }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/propertyfinder-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 = { "startUrls": [{ "url": "https://www.propertyfinder.ae/sitemaps/dubai-buy-0.xml" }], "fetch_full_details": False, "max_items": 5, "max_retries": 2, "ignore_url_failures": True, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/propertyfinder-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 '{ "startUrls": [ { "url": "https://www.propertyfinder.ae/sitemaps/dubai-buy-0.xml" } ], "fetch_full_details": false, "max_items": 5, "max_retries": 2, "ignore_url_failures": true }' | apify call crawlerbros/propertyfinder-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/propertyfinder-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Property Finder Scraper", "description": "Scrape property listings from Property Finder (UAE, Saudi Arabia, Qatar, Bahrain, Egypt). Extract prices, locations, photos, agent info, and 50+ fields per listing. No proxy required.", "version": "1.0", "x-build-id": "w9yM3YruwlJwPefZ1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~propertyfinder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-propertyfinder-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/crawlerbros~propertyfinder-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-propertyfinder-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/crawlerbros~propertyfinder-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-propertyfinder-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Property Finder URLs to scrape. Supports:\n- SEO landing pages (e.g. /en/buy/dubai/apartments-for-sale-marina.html)\n- Sitemap URLs (e.g. /sitemaps/dubai-buy-0.xml)\n- Sitemap index (/sitemaps/index-sitemap.xml)", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country", "enum": [ "ae", "sa", "bh", "eg", "qa" ], "type": "string", "description": "Country to search in (used only when no URLs are provided).", "default": "ae" }, "city": { "title": "City", "enum": [ "dubai", "abu-dhabi", "sharjah", "ajman", "ras-al-khaimah", "fujairah", "umm-al-quwain", "al-ain", "riyadh", "jeddah", "dammam", "makkah", "madinah", "khobar" ], "type": "string", "description": "City to search in.", "default": "dubai" }, "purpose": { "title": "Purpose", "enum": [ "buy", "rent", "commercial-buy", "commercial-rent" ], "type": "string", "description": "Listing purpose.", "default": "buy" }, "fetch_full_details": { "title": "Fetch Full Details (All Images + Extended Data)", "type": "boolean", "description": "When enabled, the scraper fetches each listing's detail page to retrieve the complete image gallery, full description, floor plans, and all extended fields. Disables if you only need basic listing info. Adds 1 HTTP request per property.", "default": false }, "max_items": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of unique properties to scrape.", "default": 20 }, "max_retries": { "title": "Max Retries Per Request", "minimum": 0, "type": "integer", "description": "Maximum retry attempts for each failed request.", "default": 2 }, "ignore_url_failures": { "title": "Ignore URL Failures", "type": "boolean", "description": "Continue running even if some URLs fail after max retries.", "default": true } } }, "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 } } } } } } } } } } ```