# PropertyFinder UAE Scraper: Dubai Sale, Rent & Off-Plan (`kotaro001/propertyfinder-ae-scraper`) Actor

Scrape propertyfinder.ae listings in Dubai & Abu Dhabi. Get AED prices, DLD sold benchmarks, Golden Visa 2M+ AED flags, RERA Madhmoun QR permits, off-plan handover dates, cheques count, and broker WhatsApp contacts across 96 clean flat columns.

- **URL**: https://apify.com/kotaro001/propertyfinder-ae-scraper.md
- **Developed by:** [Tuyen Tran](https://apify.com/kotaro001) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What can PropertyFinder UAE Scraper do?

PropertyFinder UAE Scraper **extracts public United Arab Emirates real estate intelligence from propertyfinder.ae** in a single unified tool: residential apartments, villas, townhouses, penthouses, duplexes, off-plan projects, and commercial properties across four distinct market channels (`buy`, `rent`, `commercial-buy`, and `commercial-rent`). Provide target communities across Dubai, Abu Dhabi, and the Northern Emirates or direct listing URLs, and you can instantly capture asking prices in AED, verified Dubai Land Department (DLD) 90-day sold benchmarks, official RERA Madhmoun QR permit links, statutory UAE Golden Visa eligibility flags (2,000,000 AED+), tenancy cheque payment frequencies (`chequesCount`), off-plan developer handover schedules, and direct agent WhatsApp contacts.

<table>
<tr>
<th>📦 What you can extract</th>
<th>⚙️ Features & integrations</th>
</tr>
<tr>
<td valign="top">

🏡 **Buy & Secondary Market listings** across Dubai Marina, Palm Jumeirah, Downtown, and 75+ communities <br>
🔑 **Rental properties** with annual rent, tenancy payment schedules (`chequesCount`), and bills inclusion <br>
🏗️ **Off-Plan developments** with developer names, handover dates, and structured payment plans <br>
🏢 **Commercial offices & retail** with business centre classification (`isBusinessCentre`) <br>
📊 **Dubai Land Department (DLD) Sold Benchmarks**: 90-day registered transaction medians and price deltas <br>
🎖️ **UAE Golden Visa indicators**: automated qualification tagging for properties priced at 2,000,000 AED+ <br>
📜 **Official RERA & Madhmoun verification**: direct Trakheesi QR validation links and Abu Dhabi DED licenses <br>
📉 **Real-time price drop intelligence**: portal-reported price cuts, previous prices, and percentage deltas <br>
👤 **Direct agent & agency contacts**: listing agent name, full telephone numbers, and direct WhatsApp links <br>
📐 **Comprehensive property specs**: bedrooms, bathrooms, parking spaces, area in sqft and sqm, and amenities

</td>
<td valign="top">

🔎 **Discovery by 75+ mapped communities** or direct `propertyfinder.ae` listing and search URLs <br>
🎛️ **Granular parameter filtering**: price bounds, bedroom counts, property types, and furnishing status <br>
🛡️ **Built-in Cloudflare & TLS fingerprinting bypass** with automatic residential proxy rotation included <br>
⏱️ **Instant Days on Market calculation** based on portal published listing dates on your very first run <br>
⬇️ **Export to JSON, CSV, Excel, or XML** in 96 fixed, flattened columns without nested object errors <br>
🦾 **Full Apify API, webhooks**, Python and Node.js SDK access for automated data pipelines <br>
🤖 **Model Context Protocol (MCP) server ready** for real-time querying via Claude, Cursor, and ChatGPT

</td>
</tr>
</table>

> 💡 **Web Terminal & Google Sheets:** Explore daily UAE property snapshots and net ROI calculators at **[propdealradar.com](https://propdealradar.com)**.

Whether you are sourcing Golden Visa qualified acquisitions under DLD market medians, monitoring off-plan handover schedules, screening rental yields across cheque terms, or generating B2B broker leads for co-broking, you get complete market coverage in one structured tool.

### What data can I scrape from propertyfinder.ae?

PropertyFinder UAE Scraper serves as the **unofficial propertyfinder.ae API** for real estate investors, hedge funds, buyer's agents, PropTech engineers, and valuation analysts. Founded in 2005 (initially AlBabworld and rebranded in 2007) and backed by a 120 million USD investment from General Atlantic, Property Finder commands over 60% of the UAE premium real estate listing market. While standard web extractors output unstructured arrays that break downstream databases, this scraper delivers a standardized 96-column flat row across all four market channels:

- **Residential For Sale listings (`buy` channel):** *Secondary market stock, ready units, and capital acquisitions*. Full property address (`address`), emirate (`emirate`), community (`community`), sub-community (`subCommunity`), building name (`towerOrBuilding`), geographic coordinates (`latitude`, `longitude`), price in AED (`priceNumeric`), price per square foot (`pricePerSqftAed`), bedrooms (`bedrooms`), bathrooms (`bathrooms`), parking spaces (`parkingSpaces`), area in sqft and sqm (`areaSqft`, `areaSqm`), furnishing status (`furnishing`), verified listing status (`isVerified`), direct listing URLs (`url`), and direct agent contact points.

- **Residential Rental listings (`rent` channel):** *Tenant accommodations, rental yields, and cashflow modeling*. Advertised annual or monthly rent (`price`, `priceNumeric`), rental payment frequency (`rentFrequency`), post-dated cheques payment count (`chequesCount`), community median prices, building amenities (`amenityNames`), and listing agent contacts.

- **Off-Plan Development listings (`off-plan` / `buy` with `completionStatus: "off_plan"`):** *Primary project launches, developer milestones, and installment schedules*. Primary developer brand (`developerName`), official project name (`projectName`), completion status (`completionStatus`), projected handover date (`handoverDate`), payment installment schedule (`paymentPlanSummary`), and annual service charges (`serviceChargePerSqftAed`).

- **Commercial Real Estate listings (`commercial-buy` and `commercial-rent` channels):** *Offices, retail units, warehouses, and commercial plots*. Commercial property type (`propertyType`), serviced business centre indicator (`isBusinessCentre`), floor space, dedicated parking allocations, trade licenses, and commercial agency representation.

- **Dubai Land Department (DLD) Sold Price Benchmarks:** *Independent transaction registry validation*. Registered 90-day median sales price (`dldMedianSoldPriceAed`), registered median price per square foot (`dldMedianSoldPricePerSqftAed`), percentage variance against registered government sales (`vsDldSoldMedianPercent`), sample transaction volume (`dldSampleTransactionsCount`), and benchmark resolution scope (`dldBenchmarkBasis`: `building` or `community`).

- **Official Regulatory Compliance & Licensing:** *RERA Trakheesi and Madhmoun validation*. Advertising permit number (`permitNumber`), direct official Madhmoun QR verification link (`reraValidationUrl`, `permitValidationUrl`), Abu Dhabi trade license number (`dedLicenseNumber`), broker card license (`agentLicenseNumber`), agency RERA registration number (`reraRegistrationNumber`), and agent tier status (`agentTier`).

- **UAE Golden Visa Eligibility Tagging:** *Long-term 10-year residency property qualification*. The automated boolean flag `goldenVisaEligible` sets to `true` whenever a property's purchase price reaches or exceeds 2,000,000 AED, adhering to UAE Federal Decree-Law No. 29 of 2020 and Cabinet Resolution No. 65 of 2022.

- **Direct Broker & Agency Contact Intelligence:** *B2B outreach and co-broking coordination*. Primary listing agent name (`agent1Name`), unmasked telephone number (`agent1PhoneComplete`), clean numeric digits (`agent1PhoneDigits`), direct WhatsApp click-to-chat link (`agent1Whatsapp`), agency corporate name (`agencyName`), and agency logo URL (`agencyLogo`).

- **Price Reduction & Market Velocity Tracking:** *Distressed stock discovery and vendor motivation*. Boolean price drop indicator (`isPriceDrop`), portal-recorded reduction percentage (`priceChangePercent`), historical asking price (`previousPrice`), numeric price drop amount (`priceDiff`), signed percentage drop (`priceDiffPercent`), cumulative change count (`priceChangesCount`), and days on market (`daysOnMarket`) calculated from the portal's recorded listing date.

- **Deep Listing Enrichment & Architectural Assets:** *Extended marketing copy and media assets*. Detailed property description (`description`), structured architectural features (`detail`), vector floor plans (`floorPlans`), virtual 360-degree tour URLs (`view360`), and high-resolution photo galleries (`images`, `imagesCount`).

You can extract listings by selecting from **75+ mapped communities across Dubai and Abu Dhabi** or by supplying **direct propertyfinder.ae search and listing URLs**.

> Looking for property data beyond PropertyFinder? Try these dedicated scrapers across the UAE and Australia:
>
> - 🇦🇪 [Bayut UAE Scraper](https://apify.com/kotaro001/bayut-uae-scraper): secondary portal listings, TruValue automated valuations, and neighborhood guides
> - 🇦🇺 [Realestate.com.au Scraper](https://apify.com/kotaro001/realestate-com-au-scraper): Australia's leading residential property database, sold prices, and agent contacts
> - 🇦🇺 [Domain.com.au Scraper](https://apify.com/kotaro001/domain-com-au-scraper): school catchments, auction clearance rates, and suburb market profiles
> - 🇦🇺 [Allhomes.com.au Scraper](https://apify.com/kotaro001/allhomes-com-au-scraper): ACT Canberra prices, statutory EER thermal ratings, and Crown leasehold land valuations
> - 🇦🇺 [Realcommercial.com.au Scraper](https://apify.com/kotaro001/realcommercial-com-au-scraper): commercial offices, industrial warehouses, retail shops, net yields, and brochure PDFs

### How much will scraping propertyfinder.ae cost?

PropertyFinder UAE Scraper operates on a transparent **pay-per-event (PPE)** pricing model where all residential proxy bandwidth, Cloudflare bypass safeguards, and cloud container compute are 100% included in the event fee. A standard catalog listing run (`includeDetails: false`) across any branch (`buy`, `rent`, `commercial-buy`, or `commercial-rent`) costs **$0.005 per actor start plus $2.000 per 1,000 listings** ($0.002 per row), totaling **$2.005 per 1,000 listings** ($1.404 on paid platform tiers). When you activate deep detail inspection (`includeDetails: true`) to extract full descriptions, vector floor plans, virtual 360 tours, and building service charges, the run adds **$0.005 per detail row** ($0.004 on paid tiers), bringing a full-detail extraction to **$7.005 per 1,000 enriched records** ($5.404 on paid tiers). A 100-row list run costs exactly **$0.205**. There are no external proxy fees, no compute overage surprises, and no unexpected infrastructure line items.

Every Apify account receives **$5.00 in free monthly platform credit**, which translates to **up to 2,490 property listings per month for free**, or **over 700 full-detail property records with floor plans, service charges, and agent phone numbers for free**. Both Free and Paid accounts control output volume directly with no per-run row limits, providing complete freedom to inspect field fill rates, test community filters, and verify DLD benchmark accuracy before committing budget. On paid subscription plans, extraction scales predictably: the Starter plan ($49/month) covers **up to 24,000 list rows or 7,000 full-detail records**, while the Scale plan ($499/month) and custom enterprise tiers handle **hundreds of thousands of monthly property records** at discounted volume rates. Review the [pricing tab](https://apify.com/kotaro001/propertyfinder-ae-scraper/pricing) for complete tier breakdowns.

### How do I use PropertyFinder UAE Scraper?

PropertyFinder UAE Scraper requires zero local installation and runs directly in your cloud browser. Here is how to extract Dubai and UAE property listings:

1. Create a free account on [Apify Console](https://console.apify.com/sign-up).
2. Open [PropertyFinder UAE Scraper](https://console.apify.com/actors/qhvxQawCWUKHb8HnB) in your dashboard.
3. Choose your target **Listing type** (`buy`, `rent`, `commercial-buy`, or `commercial-rent`).
4. Select one or more **Communities** from the built-in dropdown (e.g., `Dubai Marina`, `Downtown Dubai`, `Palm Jumeirah`, `JVC`). The scraper splits your item budget evenly across chosen locations.
5. Set your **Max listings** (`maxItems: 20`) to manage run duration (pagination depth is calculated automatically).
6. Enable **Open detail pages** (`includeDetails: true`) if your analysis requires floor plans, service charges per sqft, 360 virtual tours, or full marketing descriptions.
7. Apply targeted filters such as price limits (`minPrice`, `maxPrice`), bedrooms (`minBedrooms`, `maxBedrooms`), completion stage (`ready` or `off_plan`), `goldenVisaOnly: true`, or price drop detection (`onlyPriceChanged: true`).
8. Click **Save & Start**, monitor the live execution log, and download your 96-column dataset in **JSON, CSV, Excel, or XML**, or connect via the Apify REST API.

#### Ready-to-run presets

| # | Preset | Target branch | Key input configuration | Use case |
|---|---|---|---|---|
| 1 | Dubai Marina & JBR Price Drops | `buy` | `communities: ["Dubai Marina", "JBR"]`, `onlyPriceChanged: true`, `minBedrooms: 2`, `maxBedrooms: 2` | Sourcing discounted 2-bed waterfront apartments with verified price reductions |
| 2 | Downtown & Business Bay Stale Stock | `buy` | `communities: ["Downtown Dubai", "Business Bay"]`, `minDaysOnMarket: 60`, `maxItems: 100` | Identifying motivated sellers with listings active for 60+ days |
| 3 | Palm Jumeirah Furnished Ready Units | `buy` | `communities: ["Palm Jumeirah", "Dubai Harbour"]`, `completionStatus: "ready"`, `furnishing: "furnished"` | Luxury turnkey acquisitions for international holiday home operators |
| 4 | UAE Golden Visa Ready Properties | `buy` | `communities: ["Dubai Marina", "Downtown Dubai"]`, `minPrice: 2000000`, `goldenVisaOnly: true`, `onlyVerified: true` | Qualifying acquisitions meeting the official 2,000,000 AED 10-year residency threshold |
| 5 | Affordable Apartments under 1.2M AED | `buy` | `communities: ["JVC", "Arjan", "Dubai South"]`, `maxPrice: 1200000`, `propertyTypes: ["apartment"]` | High-yield suburban investment screening for entry-level portfolio buyers |
| 6 | DIFC & Downtown Executive Rentals | `rent` | `communities: ["DIFC", "Downtown Dubai", "Business Bay"]`, `rentFrequency: "yearly"`, `maxItems: 200` | Corporate relocation accommodation analysis and tenant lease benchmarking |
| 7 | Abu Dhabi Yas & Saadiyat Luxury Homes | `buy` | `communities: ["Yas Island", "Saadiyat Island"]`, `minPrice: 3000000`, `propertyTypes: ["villa", "apartment"]` | Capital city luxury villa and cultural district residential market intelligence |
| 8 | Business Bay Fitted Commercial Offices | `commercial-rent` | `communities: ["Business Bay", "DIFC", "JLT"]`, `propertyTypes: ["office"]`, `maxItems: 100` | Commercial lease benchmarking separating fitted offices from business centre desks |
| 9 | Dubai Hills DLD Sold Benchmark Run | `buy` | `communities: ["Dubai Hills Estate"]`, `completionStatus: "ready"`, `maxItems: 200` | Cross-checking advertised asking prices against official Land Department transaction medians |
| 10 | Dubai Off-Plan Handover Tracker | `buy` | `communities: ["Dubai Creek Harbour", "JVC", "Dubai Hills Estate"]`, `completionStatus: "off_plan"`, `includeDetails: true` | Monitoring primary project delivery timelines, developer plans, and service charges |

### ⬇️ Input

PropertyFinder UAE Scraper supports two extraction modes: automated discovery across 75+ mapped communities or targeted extraction from direct portal URLs.

#### Mode 1: Discovery by Communities

Specify one or more community names. The scraper resolves each name to Property Finder's internal location identifier and distributes your listing budget evenly:

```json
{
  "listingType": "buy",
  "communities": [
    "Dubai Marina",
    "JBR"
  ],
  "maxItems": 40,
  "includeDetails": false,
  "onlyPriceChanged": true
}
```

#### Mode 2: Direct Portal URLs

If you have pre-filtered search queries or specific property links saved from browsing `propertyfinder.ae`, paste them directly into `startUrls`:

| Direct URL pattern | Extracted data |
|---|---|
| `https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-dubai-marina.html` | All residential apartments for sale in Dubai Marina with asking prices, DLD benchmarks, and RERA links |
| `https://www.propertyfinder.ae/en/plp/rent/properties-for-rent-dubai-downtown-dubai.html` | Active rental listings in Downtown Dubai with annual rents, cheque terms, and agent numbers |
| `https://www.propertyfinder.ae/en/plp/buy/properties-for-sale-dubai-jumeirah-village-circle.html?c=1` | Primary off-plan projects in JVC with developer identities, handover dates, and installment schedules |
| `https://www.propertyfinder.ae/en/plp/commercial-rent/office-for-rent-dubai-business-bay.html` | Commercial office listings in Business Bay with service fee rates and business centre flags |
| `https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-dubai-marina-the-torch-161888280.html` | Deep single listing extraction with floor plans, 360 tour, full description, and broker WhatsApp |

#### Market verticals comparison

| Vertical | Input parameter | Primary property categories | Key analytical columns populated |
|---|---|---|---|
| **Residential Sale** | `listingType: "buy"` | Apartment, Villa, Townhouse, Penthouse, Duplex | `dldMedianSoldPriceAed`, `vsDldSoldMedianPercent`, `goldenVisaEligible`, `isVerified` |
| **Residential Rent** | `listingType: "rent"` | Apartment, Villa, Townhouse, Hotel Apartment | `priceNumeric`, `rentFrequency`, `chequesCount`, `agent1Whatsapp` |
| **Off-Plan Projects** | `listingType: "buy"` + `completionStatus: "off_plan"` | Off-plan Apartments, Townhouses, Luxury Villas | `developerName`, `projectName`, `handoverDate`, `paymentPlanSummary`, `serviceChargePerSqftAed` |
| **Commercial Real Estate** | `listingType: "commercial-buy"` or `"commercial-rent"` | Office, Retail, Warehouse, Commercial Land | `isBusinessCentre`, `areaSqft`, `pricePerSqftAed`, `dedLicenseNumber` |

#### Configuration parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `listingType` | String | `buy` | Market branch: `buy`, `rent`, `commercial-buy`, or `commercial-rent`. |
| `communities` | Array | `["Dubai Marina"]` | Array of target UAE communities (75+ mapped locations across Dubai and Abu Dhabi). |
| `propertyTypes` | Array | `[]` | Filter by categories: `apartment`, `villa`, `townhouse`, `penthouse`, `duplex`, `office`, `retail`, `warehouse`, `land`. |
| `completionStatus` | String | `all` | Construction phase filter: `all`, `ready`, or `off_plan`. |
| `furnishing` | String | `all` | Furnishing filter: `all`, `furnished`, `unfurnished`, or `partly_furnished`. |
| `minPrice` | Integer | None | Minimum asking price or annual rent in AED. |
| `maxPrice` | Integer | None | Maximum asking price or annual rent in AED. |
| `minBedrooms` | Integer | None | Minimum bedroom count (0 = Studio). |
| `maxBedrooms` | Integer | None | Maximum bedroom count. |
| `minBathrooms` | Integer | None | Minimum bathroom count. |
| `minAreaSqft` | Integer | None | Minimum built-up area in square feet. |
| `maxAreaSqft` | Integer | None | Maximum built-up area in square feet. |
| `minDaysOnMarket` | Integer | `0` | Excludes listings active for fewer than this many days based on portal listing dates. |
| `onlyPriceChanged` | Boolean | `false` | When true, returns only listings where the portal records a recent price reduction. |
| `onlyVerified` | Boolean | `false` | When true, filters for portal-verified listings with confirmed ownership documentation. |
| `goldenVisaOnly` | Boolean | `false` | When true, restricts results to properties priced at 2,000,000 AED or higher. |
| `includeDetails` | Boolean | `false` | When true, visits individual listing pages to extract floor plans, service charges, descriptions, and agent numbers. |
| `maxItems` | Integer | `20` | Total listings exported across all specified communities. |
| `maxDetails` | Integer | `0` | Budget cap on deep detail visits when `includeDetails` is enabled (0 = no cap). |
| `rentFrequency` | String | `""` | For rental runs only: restrict to `yearly` or `monthly` lease terms. |

### ⬆️ Output and setup

Every run exports clean, tabular records directly into your Apify default dataset. Data can be downloaded with a single click as **JSON, CSV, Excel, XML, or HTML**, or fetched programmatically via the Apify REST API. The schema strictly maintains **96 fixed flat columns** across all runs, eliminating schema drift and nested parsing errors.

#### Live sample datasets & verified run benchmarks

Explore real dataset exports across all four market branches directly from our public CDN:

| Market branch & scenario | JSON sample | CSV sample | Sample size |
|---|---|---|---|
| **Residential Sale (Dubai Marina & JBR)** | [Download JSON](https://actors.zapstackguides.com/samples/propertyfinder-sale.json) | [Download CSV](https://actors.zapstackguides.com/samples/propertyfinder-sale.csv) | 30 rows, 96 columns |
| **Residential Rent (Marina, JBR, DIFC & Downtown)** | [Download JSON](https://actors.zapstackguides.com/samples/propertyfinder-rent.json) | [Download CSV](https://actors.zapstackguides.com/samples/propertyfinder-rent.csv) | 50 rows, 96 columns |
| **Off-Plan Projects (JVC & Dubai Hills Estate)** | [Download JSON](https://actors.zapstackguides.com/samples/propertyfinder-offplan.json) | [Download CSV](https://actors.zapstackguides.com/samples/propertyfinder-offplan.csv) | 40 rows, 96 columns |
| **Commercial Real Estate (Business Bay Fitted Offices)** | [Download JSON](https://actors.zapstackguides.com/samples/propertyfinder-commercial.json) | [Download CSV](https://actors.zapstackguides.com/samples/propertyfinder-commercial.csv) | 20 rows, 96 columns |

Below are seven real-world output examples demonstrating how specific market branches and analytical modes populate the 96-column dataset:

#### 1. Dubai Marina 2-bedroom ready sale listing with DLD sold benchmark

```json
{
  "item_id": "161888280",
  "id": "161888280",
  "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-dubai-marina-the-torch-161888280.html",
  "source": "propertyfinder.ae",
  "title": "Full Marina View | High Floor | 02 Layout | Vacant",
  "listingId": "161888280",
  "status": "active",
  "listingType": "buy",
  "propertyType": "apartment",
  "referenceNumber": "PF-S-98214",
  "listingLevel": "premium",
  "offeringType": "residential_sale",
  "unitType": "apartment",
  "isExclusive": false,
  "isDirectFromDeveloper": false,
  "isNewListing": false,
  "crossPortalName": null,
  "price": "AED 2,095,000",
  "priceNumeric": 2095000,
  "currency": "AED",
  "rentFrequency": null,
  "chequesCount": null,
  "pricePerSqftAed": 1665.34,
  "isBusinessCentre": false,
  "isPriceDrop": false,
  "priceChangePercent": null,
  "crossPortalPriceAed": null,
  "priceChangeSource": null,
  "address": "The Torch, Dubai Marina, Dubai",
  "emirate": "Dubai",
  "community": "Dubai Marina",
  "subCommunity": "The Torch",
  "towerOrBuilding": "The Torch",
  "latitude": 25.08721,
  "longitude": 55.14589,
  "zoneName": "Dubai Marina",
  "bedrooms": 2,
  "bathrooms": 2,
  "parkingSpaces": 1,
  "areaSqft": 1258.0,
  "areaSqm": 116.87,
  "furnishing": "unfurnished",
  "amenities": ["balcony", "built_in_wardrobes", "central_ac", "covered_parking", "shared_pool", "shared_gym"],
  "amenityNames": ["Balcony", "Built-in Wardrobes", "Central A/C", "Covered Parking", "Shared Pool", "Shared Gym"],
  "permitNumber": "",
  "permitValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=133biktzejsobnpf1ipdh9vonomp9thkjvopuynzfesfwpfiu",
  "permitAuthority": "RERA",
  "reraRegistrationNumber": "12450",
  "reraValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=133biktzejsobnpf1ipdh9vonomp9thkjvopuynzfesfwpfiu",
  "dedLicenseNumber": null,
  "agentLicenseNumber": "48921",
  "isVerified": true,
  "agentTier": "super_agent",
  "completionStatus": "ready",
  "handoverDate": null,
  "developerName": "Select Group",
  "projectName": "The Torch",
  "paymentPlanSummary": null,
  "serviceChargePerSqftAed": 15.22,
  "goldenVisaEligible": true,
  "posted_at": "2026-10-12T08:30:00Z",
  "listedDate": "2026-10-12",
  "lastRefreshed": "2026-11-04T10:15:00Z",
  "first_seen_at": "2026-10-12T09:00:00Z",
  "last_seen_at": "2026-11-06T12:00:00Z",
  "daysOnMarket": 25,
  "priceChanged": false,
  "previousPrice": null,
  "priceDiff": 0,
  "priceDiffPercent": 0.0,
  "priceChangesCount": 0,
  "changes": [],
  "agent1Name": "Hamza Tariq",
  "agent1Phone": "+971501234567",
  "agent1PhoneDigits": "971501234567",
  "agent1PhoneComplete": "+971501234567",
  "agent1Whatsapp": "https://wa.me/971501234567",
  "agencyName": "Darna Properties LLC",
  "agencyLogo": "https://www.propertyfinder.ae/broker/1/120/80/LOGO/darna.jpg",
  "mainImage": "https://media.propertyfinder.ae/property/161888280/main.jpg",
  "images": ["https://media.propertyfinder.ae/property/161888280/1.jpg", "https://media.propertyfinder.ae/property/161888280/2.jpg"],
  "imagesCount": 18,
  "description": null,
  "detail": null,
  "floorPlans": [],
  "view360": null,
  "sizeSqft": 1258.0,
  "detailScrapedSuccess": null,
  "communityMedianPricePerSqftAed": 1720.5,
  "medianPriceSameBedroomAed": 2150000,
  "belowMedianPercent": -3.21,
  "dldMedianSoldPriceAed": 1700000,
  "dldMedianSoldPricePerSqftAed": 1351.35,
  "vsDldSoldMedianPercent": 23.28,
  "dldSampleTransactionsCount": 5,
  "dldBenchmarkBasis": "building"
}
```

#### 2. Downtown Dubai luxury rental with cheques schedule and bills

```json
{
  "item_id": "168345561",
  "id": "168345561",
  "url": "https://www.propertyfinder.ae/en/plp/rent/apartment-for-rent-dubai-downtown-dubai-burj-crown-168345561.html",
  "source": "propertyfinder.ae",
  "title": "Burj Khalifa View | Brand New | Chiller Free | High Floor",
  "listingId": "168345561",
  "status": "active",
  "listingType": "rent",
  "propertyType": "apartment",
  "referenceNumber": "PF-R-44109",
  "listingLevel": "standard",
  "offeringType": "residential_rent",
  "unitType": "apartment",
  "isExclusive": false,
  "isDirectFromDeveloper": false,
  "isNewListing": true,
  "crossPortalName": null,
  "price": "AED 165,000/year",
  "priceNumeric": 165000,
  "currency": "AED",
  "rentFrequency": "yearly",
  "chequesCount": 4,
  "pricePerSqftAed": 165.17,
  "isBusinessCentre": false,
  "isPriceDrop": false,
  "priceChangePercent": null,
  "crossPortalPriceAed": null,
  "priceChangeSource": null,
  "address": "Burj Crown, Downtown Dubai, Dubai",
  "emirate": "Dubai",
  "community": "Downtown Dubai",
  "subCommunity": "Burj Crown",
  "towerOrBuilding": "Burj Crown",
  "latitude": 25.19451,
  "longitude": 55.27814,
  "zoneName": "Downtown Dubai",
  "bedrooms": 2,
  "bathrooms": 2,
  "parkingSpaces": 1,
  "areaSqft": 999.0,
  "areaSqm": 92.81,
  "furnishing": "unfurnished",
  "amenities": ["balcony", "chiller_free", "covered_parking", "shared_pool", "shared_gym", "security"],
  "amenityNames": ["Balcony", "Chiller Free", "Covered Parking", "Shared Pool", "Shared Gym", "24/7 Security"],
  "permitNumber": "",
  "permitValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=984aaktzejsobnpf2ipdh9vonomp9thkjvopuynzfesfwpllm",
  "permitAuthority": "RERA",
  "reraRegistrationNumber": "21045",
  "reraValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=984aaktzejsobnpf2ipdh9vonomp9thkjvopuynzfesfwpllm",
  "dedLicenseNumber": null,
  "agentLicenseNumber": "55120",
  "isVerified": true,
  "agentTier": "standard",
  "completionStatus": "ready",
  "handoverDate": null,
  "developerName": "Emaar Properties",
  "projectName": "Burj Crown",
  "paymentPlanSummary": null,
  "serviceChargePerSqftAed": null,
  "goldenVisaEligible": false,
  "posted_at": "2026-10-30T11:00:00Z",
  "listedDate": "2026-10-30",
  "lastRefreshed": "2026-11-05T08:20:00Z",
  "first_seen_at": "2026-10-30T11:30:00Z",
  "last_seen_at": "2026-11-06T12:00:00Z",
  "daysOnMarket": 7,
  "priceChanged": false,
  "previousPrice": null,
  "priceDiff": 0,
  "priceDiffPercent": 0.0,
  "priceChangesCount": 0,
  "changes": [],
  "agent1Name": "Sarah Jenkins",
  "agent1Phone": "+971559876543",
  "agent1PhoneDigits": "971559876543",
  "agent1PhoneComplete": "+971559876543",
  "agent1Whatsapp": "https://wa.me/971559876543",
  "agencyName": "Downtown Living Real Estate",
  "agencyLogo": "https://media.propertyfinder.ae/broker/2/120/80/LOGO/dtl.jpg",
  "mainImage": "https://media.propertyfinder.ae/property/168345561/main.jpg",
  "images": ["https://media.propertyfinder.ae/property/168345561/1.jpg"],
  "imagesCount": 14,
  "description": null,
  "detail": null,
  "floorPlans": [],
  "view360": null,
  "sizeSqft": 999.0,
  "detailScrapedSuccess": null,
  "communityMedianPricePerSqftAed": 175.4,
  "medianPriceSameBedroomAed": 170000,
  "belowMedianPercent": -2.94,
  "dldMedianSoldPriceAed": null,
  "dldMedianSoldPricePerSqftAed": null,
  "vsDldSoldMedianPercent": null,
  "dldSampleTransactionsCount": 0,
  "dldBenchmarkBasis": null
}
```

#### 3. Jumeirah Village Circle (JVC) off-plan investment with payment plan

```json
{
  "item_id": "165992014",
  "id": "165992014",
  "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-jumeirah-village-circle-jvc-district-13-165992014.html",
  "source": "propertyfinder.ae",
  "title": "Smart Home | 1% Monthly Payment Plan | Handover Q4 2026",
  "listingId": "165992014",
  "status": "active",
  "listingType": "buy",
  "propertyType": "apartment",
  "referenceNumber": "PF-OP-3312",
  "listingLevel": "featured",
  "offeringType": "residential_sale",
  "unitType": "apartment",
  "isExclusive": true,
  "isDirectFromDeveloper": true,
  "isNewListing": false,
  "crossPortalName": null,
  "price": "AED 850,000",
  "priceNumeric": 850000,
  "currency": "AED",
  "rentFrequency": null,
  "chequesCount": null,
  "pricePerSqftAed": 1148.65,
  "isBusinessCentre": false,
  "isPriceDrop": false,
  "priceChangePercent": null,
  "crossPortalPriceAed": null,
  "priceChangeSource": null,
  "address": "District 13, Jumeirah Village Circle (JVC), Dubai",
  "emirate": "Dubai",
  "community": "JVC",
  "subCommunity": "District 13",
  "towerOrBuilding": "Luma Park Views",
  "latitude": 25.05672,
  "longitude": 55.20914,
  "zoneName": "Jumeirah Village Circle",
  "bedrooms": 1,
  "bathrooms": 2,
  "parkingSpaces": 1,
  "areaSqft": 740.0,
  "areaSqm": 68.75,
  "furnishing": "unfurnished",
  "amenities": ["smart_home", "balcony", "shared_pool", "children_play_area"],
  "amenityNames": ["Smart Home System", "Balcony", "Infinity Pool", "Kids Play Area"],
  "permitNumber": "",
  "permitValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=332ciktzejsobnpf7ipdh9vonomp9thkjvopuynzfesfwpooo",
  "permitAuthority": "RERA",
  "reraRegistrationNumber": "19400",
  "reraValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=332ciktzejsobnpf7ipdh9vonomp9thkjvopuynzfesfwpooo",
  "dedLicenseNumber": null,
  "agentLicenseNumber": "39104",
  "isVerified": true,
  "agentTier": "super_agent",
  "completionStatus": "off_plan",
  "handoverDate": "2026-12-31",
  "developerName": "TownX Development",
  "projectName": "Luma Park Views",
  "paymentPlanSummary": "20% Down Payment, 50% During Construction, 30% on Handover",
  "serviceChargePerSqftAed": 14.0,
  "goldenVisaEligible": false,
  "posted_at": "2026-09-15T10:00:00Z",
  "listedDate": "2026-09-15",
  "lastRefreshed": "2026-11-04T14:30:00Z",
  "first_seen_at": "2026-09-15T10:30:00Z",
  "last_seen_at": "2026-11-06T12:00:00Z",
  "daysOnMarket": 52,
  "priceChanged": false,
  "previousPrice": null,
  "priceDiff": 0,
  "priceDiffPercent": 0.0,
  "priceChangesCount": 0,
  "changes": [],
  "agent1Name": "Karim Mansour",
  "agent1Phone": "+971521122334",
  "agent1PhoneDigits": "971521122334",
  "agent1PhoneComplete": "+971521122334",
  "agent1Whatsapp": "https://wa.me/971521122334",
  "agencyName": "Apex Prime Real Estate",
  "agencyLogo": "https://media.propertyfinder.ae/broker/3/120/80/LOGO/apex.jpg",
  "mainImage": "https://media.propertyfinder.ae/property/165992014/main.jpg",
  "images": ["https://media.propertyfinder.ae/property/165992014/1.jpg"],
  "imagesCount": 12,
  "description": null,
  "detail": null,
  "floorPlans": [],
  "view360": null,
  "sizeSqft": 740.0,
  "detailScrapedSuccess": null,
  "communityMedianPricePerSqftAed": 1180.0,
  "medianPriceSameBedroomAed": 870000,
  "belowMedianPercent": -2.3,
  "dldMedianSoldPriceAed": null,
  "dldMedianSoldPricePerSqftAed": null,
  "vsDldSoldMedianPercent": null,
  "dldSampleTransactionsCount": 0,
  "dldBenchmarkBasis": null
}
```

#### 4. Business Bay fitted commercial office space

```json
{
  "item_id": "164220911",
  "id": "164220911",
  "url": "https://www.propertyfinder.ae/en/plp/commercial-rent/office-for-rent-dubai-business-bay-the-prism-164220911.html",
  "source": "propertyfinder.ae",
  "title": "Fully Fitted Office | Near Metro | Partitioned | Grade A",
  "listingId": "164220911",
  "status": "active",
  "listingType": "commercial-rent",
  "propertyType": "office",
  "referenceNumber": "PF-COM-8812",
  "listingLevel": "standard",
  "offeringType": "commercial_rent",
  "unitType": "office",
  "isExclusive": false,
  "isDirectFromDeveloper": false,
  "isNewListing": false,
  "crossPortalName": null,
  "price": "AED 245,000/year",
  "priceNumeric": 245000,
  "currency": "AED",
  "rentFrequency": "yearly",
  "chequesCount": 4,
  "pricePerSqftAed": 175.0,
  "isBusinessCentre": false,
  "isPriceDrop": false,
  "priceChangePercent": null,
  "crossPortalPriceAed": null,
  "priceChangeSource": null,
  "address": "The Prism, Business Bay, Dubai",
  "emirate": "Dubai",
  "community": "Business Bay",
  "subCommunity": "The Prism",
  "towerOrBuilding": "The Prism",
  "latitude": 25.18845,
  "longitude": 55.26312,
  "zoneName": "Business Bay",
  "bedrooms": 0,
  "bathrooms": 2,
  "parkingSpaces": 2,
  "areaSqft": 1400.0,
  "areaSqm": 130.06,
  "furnishing": "furnished",
  "amenities": ["central_ac", "covered_parking", "metro_access", "24_security"],
  "amenityNames": ["Central A/C", "Covered Parking", "Direct Metro Access", "24/7 Concierge"],
  "permitNumber": "",
  "permitValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=771piktzejsobnpf9ipdh9vonomp9thkjvopuynzfesfwpqrr",
  "permitAuthority": "RERA",
  "reraRegistrationNumber": "11980",
  "reraValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=771piktzejsobnpf9ipdh9vonomp9thkjvopuynzfesfwpqrr",
  "dedLicenseNumber": null,
  "agentLicenseNumber": "28114",
  "isVerified": true,
  "agentTier": "standard",
  "completionStatus": "ready",
  "handoverDate": null,
  "developerName": "Credo Investments",
  "projectName": "The Prism",
  "paymentPlanSummary": null,
  "serviceChargePerSqftAed": 18.5,
  "goldenVisaEligible": false,
  "posted_at": "2026-10-01T07:15:00Z",
  "listedDate": "2026-10-01",
  "lastRefreshed": "2026-11-03T09:40:00Z",
  "first_seen_at": "2026-10-01T08:00:00Z",
  "last_seen_at": "2026-11-06T12:00:00Z",
  "daysOnMarket": 36,
  "priceChanged": false,
  "previousPrice": null,
  "priceDiff": 0,
  "priceDiffPercent": 0.0,
  "priceChangesCount": 0,
  "changes": [],
  "agent1Name": "Vikram Malhotra",
  "agent1Phone": "+971508899001",
  "agent1PhoneDigits": "971508899001",
  "agent1PhoneComplete": "+971508899001",
  "agent1Whatsapp": "https://wa.me/971508899001",
  "agencyName": "Commercial Axis Real Estate",
  "agencyLogo": "https://media.propertyfinder.ae/broker/4/120/80/LOGO/axis.jpg",
  "mainImage": "https://media.propertyfinder.ae/property/164220911/main.jpg",
  "images": ["https://media.propertyfinder.ae/property/164220911/1.jpg"],
  "imagesCount": 16,
  "description": null,
  "detail": null,
  "floorPlans": [],
  "view360": null,
  "sizeSqft": 1400.0,
  "detailScrapedSuccess": null,
  "communityMedianPricePerSqftAed": 182.0,
  "medianPriceSameBedroomAed": 255000,
  "belowMedianPercent": -3.85,
  "dldMedianSoldPriceAed": null,
  "dldMedianSoldPricePerSqftAed": null,
  "vsDldSoldMedianPercent": null,
  "dldSampleTransactionsCount": 0,
  "dldBenchmarkBasis": null
}
```

#### 5. Deep detail enrichment with floor plans, 360 tour, and full description

```json
{
  "item_id": "152823124",
  "id": "152823124",
  "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-dubai-marina-elite-residence-152823124.html",
  "source": "propertyfinder.ae",
  "title": "Full Sea View | 03 Layout | High Floor | Upgraded",
  "listingId": "152823124",
  "status": "active",
  "listingType": "buy",
  "propertyType": "apartment",
  "referenceNumber": "PF-S-55214",
  "listingLevel": "featured",
  "offeringType": "residential_sale",
  "unitType": "apartment",
  "isExclusive": true,
  "isDirectFromDeveloper": false,
  "isNewListing": false,
  "crossPortalName": null,
  "price": "AED 1,625,000",
  "priceNumeric": 1625000,
  "currency": "AED",
  "rentFrequency": null,
  "chequesCount": null,
  "pricePerSqftAed": 2028.71,
  "isBusinessCentre": false,
  "isPriceDrop": true,
  "priceChangePercent": -7.0,
  "crossPortalPriceAed": null,
  "priceChangeSource": "portal_listing_badge",
  "address": "Elite Residence, Dubai Marina, Dubai",
  "emirate": "Dubai",
  "community": "Dubai Marina",
  "subCommunity": "Elite Residence",
  "towerOrBuilding": "Elite Residence",
  "latitude": 25.08945,
  "longitude": 55.14812,
  "zoneName": "Dubai Marina",
  "bedrooms": 1,
  "bathrooms": 2,
  "parkingSpaces": 1,
  "areaSqft": 801.0,
  "areaSqm": 74.41,
  "furnishing": "furnished",
  "amenities": ["sea_view", "balcony", "indoor_pool", "outdoor_pool", "spa", "billiards_room"],
  "amenityNames": ["Full Sea View", "Balcony", "Indoor Pool", "Outdoor Pool", "Spa Facilities", "Billiards Room"],
  "permitNumber": "",
  "permitValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=133biktzejsobnpf1ipdh9vonomp9thkjvopuynzfesfwpfiu",
  "permitAuthority": "RERA",
  "reraRegistrationNumber": "15890",
  "reraValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=133biktzejsobnpf1ipdh9vonomp9thkjvopuynzfesfwpfiu",
  "dedLicenseNumber": null,
  "agentLicenseNumber": "31045",
  "isVerified": true,
  "agentTier": "super_agent",
  "completionStatus": "ready",
  "handoverDate": null,
  "developerName": "Tameer Holding",
  "projectName": "Elite Residence",
  "paymentPlanSummary": null,
  "serviceChargePerSqftAed": 14.45,
  "goldenVisaEligible": false,
  "posted_at": "2026-10-04T09:00:00Z",
  "listedDate": "2026-10-04",
  "lastRefreshed": "2026-11-05T12:00:00Z",
  "first_seen_at": "2026-10-04T09:30:00Z",
  "last_seen_at": "2026-11-06T12:00:00Z",
  "daysOnMarket": 33,
  "priceChanged": true,
  "previousPrice": 1747312,
  "priceDiff": -122312,
  "priceDiffPercent": -7.0,
  "priceChangesCount": 1,
  "changes": [{"field": "price", "from": 1747312, "to": 1625000, "date": "2026-10-28"}],
  "agent1Name": "Jackson David Williams",
  "agent1Phone": "+971507765467",
  "agent1PhoneDigits": "971507765467",
  "agent1PhoneComplete": "+971507765467",
  "agent1Whatsapp": "https://wa.me/971507765467",
  "agencyName": "YHU Properties LLC",
  "agencyLogo": "https://media.propertyfinder.ae/broker/5/120/80/LOGO/yhu.jpg",
  "mainImage": "https://media.propertyfinder.ae/property/152823124/main.jpg",
  "images": [
    "https://media.propertyfinder.ae/property/152823124/1.jpg",
    "https://media.propertyfinder.ae/property/152823124/2.jpg",
    "https://media.propertyfinder.ae/property/152823124/3.jpg"
  ],
  "imagesCount": 24,
  "description": "Presenting this fully upgraded 1-bedroom apartment in Elite Residence, Dubai Marina. Situated on a high floor, the unit enjoys unobstructed sea and Palm Jumeirah vistas. The kitchen features premium integrated European appliances and marble counter surfaces. The building provides comprehensive wellness amenities including indoor and outdoor swimming pools, sauna, and dedicated parking.",
  "detail": {
    "view": "Sea and Palm Jumeirah",
    "developer": "Tameer Holding",
    "serviceCharges": "14.45 AED/sqft"
  },
  "floorPlans": ["https://media.propertyfinder.ae/property/152823124/floorplan_1.svg"],
  "view360": "https://my.matterport.com/show/?m=example360tour",
  "sizeSqft": 801.0,
  "detailScrapedSuccess": true,
  "communityMedianPricePerSqftAed": 1980.0,
  "medianPriceSameBedroomAed": 1680000,
  "belowMedianPercent": -3.27,
  "dldMedianSoldPriceAed": 1550000,
  "dldMedianSoldPricePerSqftAed": 1935.08,
  "vsDldSoldMedianPercent": 4.84,
  "dldSampleTransactionsCount": 8,
  "dldBenchmarkBasis": "building"
}
```

#### 6. Real-time price reduction tracking with previous price and delta percent

```json
{
  "item_id": "162794818",
  "id": "162794818",
  "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-dubai-marina-dubai-marina-towers-al-yass-tower-162794818.html",
  "source": "propertyfinder.ae",
  "title": "Emaar Original 6 | Al Yass Tower | Price Reduced by 150k AED",
  "listingId": "162794818",
  "status": "active",
  "listingType": "buy",
  "propertyType": "apartment",
  "referenceNumber": "PF-S-10992",
  "listingLevel": "premium",
  "offeringType": "residential_sale",
  "unitType": "apartment",
  "isExclusive": false,
  "isDirectFromDeveloper": false,
  "isNewListing": false,
  "crossPortalName": null,
  "price": "AED 4,350,000",
  "priceNumeric": 4350000,
  "currency": "AED",
  "rentFrequency": null,
  "chequesCount": null,
  "pricePerSqftAed": 1782.79,
  "isBusinessCentre": false,
  "isPriceDrop": true,
  "priceChangePercent": -3.33,
  "crossPortalPriceAed": null,
  "priceChangeSource": "portal_listing_badge",
  "address": "Al Yass Tower, Dubai Marina Towers, Dubai Marina, Dubai",
  "emirate": "Dubai",
  "community": "Dubai Marina",
  "subCommunity": "Dubai Marina Towers (Emaar 6)",
  "towerOrBuilding": "Al Yass Tower",
  "latitude": 25.08512,
  "longitude": 55.14321,
  "zoneName": "Dubai Marina",
  "bedrooms": 3,
  "bathrooms": 4,
  "parkingSpaces": 2,
  "areaSqft": 2440.0,
  "areaSqm": 226.68,
  "furnishing": "unfurnished",
  "amenities": ["maid_room", "balcony", "shared_pool", "shared_gym", "direct_marina_walk_access"],
  "amenityNames": ["Maid's Room", "Balcony", "Shared Pool", "Shared Gym", "Direct Marina Walk Access"],
  "permitNumber": "",
  "permitValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=441aiktzejsobnpf8ipdh9vonomp9thkjvopuynzfesfwprst",
  "permitAuthority": "RERA",
  "reraRegistrationNumber": "10098",
  "reraValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=441aiktzejsobnpf8ipdh9vonomp9thkjvopuynzfesfwprst",
  "dedLicenseNumber": null,
  "agentLicenseNumber": "19420",
  "isVerified": true,
  "agentTier": "super_agent",
  "completionStatus": "ready",
  "handoverDate": null,
  "developerName": "Emaar Properties",
  "projectName": "Dubai Marina Towers",
  "paymentPlanSummary": null,
  "serviceChargePerSqftAed": 16.8,
  "goldenVisaEligible": true,
  "posted_at": "2026-09-20T08:00:00Z",
  "listedDate": "2026-09-20",
  "lastRefreshed": "2026-11-04T16:00:00Z",
  "first_seen_at": "2026-09-20T08:30:00Z",
  "last_seen_at": "2026-11-06T12:00:00Z",
  "daysOnMarket": 47,
  "priceChanged": true,
  "previousPrice": 4500000,
  "priceDiff": -150000,
  "priceDiffPercent": -3.33,
  "priceChangesCount": 1,
  "changes": [{"field": "price", "from": 4500000, "to": 4350000, "date": "2026-11-01"}],
  "agent1Name": "Farhan Al Hashimi",
  "agent1Phone": "+971504433221",
  "agent1PhoneDigits": "971504433221",
  "agent1PhoneComplete": "+971504433221",
  "agent1Whatsapp": "https://wa.me/971504433221",
  "agencyName": "Gulf Prestige Properties",
  "agencyLogo": "https://media.propertyfinder.ae/broker/6/120/80/LOGO/gulf.jpg",
  "mainImage": "https://media.propertyfinder.ae/property/162794818/main.jpg",
  "images": ["https://media.propertyfinder.ae/property/162794818/1.jpg"],
  "imagesCount": 21,
  "description": null,
  "detail": null,
  "floorPlans": [],
  "view360": null,
  "sizeSqft": 2440.0,
  "detailScrapedSuccess": null,
  "communityMedianPricePerSqftAed": 1850.0,
  "medianPriceSameBedroomAed": 4600000,
  "belowMedianPercent": -5.43,
  "dldMedianSoldPriceAed": 2520000,
  "dldMedianSoldPricePerSqftAed": 1201.72,
  "vsDldSoldMedianPercent": 48.32,
  "dldSampleTransactionsCount": 84,
  "dldBenchmarkBasis": "community"
}
```

#### 7. Official RERA Madhmoun QR permit and broker licensing validation

```json
{
  "item_id": "162796251",
  "id": "162796251",
  "url": "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-dubai-marina-dubai-marina-towers-murjan-tower-162796251.html",
  "source": "propertyfinder.ae",
  "title": "Murjan Tower | Fully Renovated 2-Bed | Authentic RERA Madhmoun Permit",
  "listingId": "162796251",
  "status": "active",
  "listingType": "buy",
  "propertyType": "apartment",
  "referenceNumber": "PF-S-88301",
  "listingLevel": "standard",
  "offeringType": "residential_sale",
  "unitType": "apartment",
  "isExclusive": true,
  "isDirectFromDeveloper": false,
  "isNewListing": false,
  "crossPortalName": null,
  "price": "AED 2,850,000",
  "priceNumeric": 2850000,
  "currency": "AED",
  "rentFrequency": null,
  "chequesCount": null,
  "pricePerSqftAed": 1875.0,
  "isBusinessCentre": false,
  "isPriceDrop": false,
  "priceChangePercent": null,
  "crossPortalPriceAed": null,
  "priceChangeSource": null,
  "address": "Murjan Tower, Dubai Marina Towers, Dubai Marina, Dubai",
  "emirate": "Dubai",
  "community": "Dubai Marina",
  "subCommunity": "Dubai Marina Towers (Emaar 6)",
  "towerOrBuilding": "Murjan Tower",
  "latitude": 25.08412,
  "longitude": 55.14256,
  "zoneName": "Dubai Marina",
  "bedrooms": 2,
  "bathrooms": 2,
  "parkingSpaces": 1,
  "areaSqft": 1520.0,
  "areaSqm": 141.21,
  "furnishing": "partly_furnished",
  "amenities": ["marina_view", "balcony", "covered_parking", "shared_pool", "shared_gym"],
  "amenityNames": ["Marina View", "Balcony", "Covered Parking", "Shared Pool", "Shared Gym"],
  "permitNumber": "",
  "permitValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=552diktzejsobnpf3ipdh9vonomp9thkjvopuynzfesfwpuvw",
  "permitAuthority": "RERA",
  "reraRegistrationNumber": "18920",
  "reraValidationUrl": "https://trakheesi.dubailand.gov.ae/rev/madmoun/listing/validation?khevJujtDig=552diktzejsobnpf3ipdh9vonomp9thkjvopuynzfesfwpuvw",
  "dedLicenseNumber": null,
  "agentLicenseNumber": "42109",
  "isVerified": true,
  "agentTier": "super_agent",
  "completionStatus": "ready",
  "handoverDate": null,
  "developerName": "Emaar Properties",
  "projectName": "Dubai Marina Towers",
  "paymentPlanSummary": null,
  "serviceChargePerSqftAed": 16.5,
  "goldenVisaEligible": true,
  "posted_at": "2026-10-18T12:00:00Z",
  "listedDate": "2026-10-18",
  "lastRefreshed": "2026-11-05T14:10:00Z",
  "first_seen_at": "2026-10-18T12:30:00Z",
  "last_seen_at": "2026-11-06T12:00:00Z",
  "daysOnMarket": 19,
  "priceChanged": false,
  "previousPrice": null,
  "priceDiff": 0,
  "priceDiffPercent": 0.0,
  "priceChangesCount": 0,
  "changes": [],
  "agent1Name": "Nour El Din",
  "agent1Phone": "+971561122998",
  "agent1PhoneDigits": "971561122998",
  "agent1PhoneComplete": "+971561122998",
  "agent1Whatsapp": "https://wa.me/971561122998",
  "agencyName": "Emirates Heritage Properties",
  "agencyLogo": "https://media.propertyfinder.ae/broker/7/120/80/LOGO/heritage.jpg",
  "mainImage": "https://media.propertyfinder.ae/property/162796251/main.jpg",
  "images": ["https://media.propertyfinder.ae/property/162796251/1.jpg"],
  "imagesCount": 19,
  "description": null,
  "detail": null,
  "floorPlans": [],
  "view360": null,
  "sizeSqft": 1520.0,
  "detailScrapedSuccess": null,
  "communityMedianPricePerSqftAed": 1850.0,
  "medianPriceSameBedroomAed": 2800000,
  "belowMedianPercent": 1.79,
  "dldMedianSoldPriceAed": 2400000,
  "dldMedianSoldPricePerSqftAed": 1578.95,
  "vsDldSoldMedianPercent": 18.75,
  "dldSampleTransactionsCount": 12,
  "dldBenchmarkBasis": "building"
}
```

### Notes and exceptions

1. **Automated Cloudflare and TLS Fingerprinting Bypass:** PropertyFinder enforces strict Cloudflare WAF protection and inspects TLS client handshakes. The scraper implements an automated Chrome TLS signature and routes traffic through rotating residential proxies. You do not need to configure external proxy credentials or solve interactive captchas.
2. **Dubai Land Department (DLD) Sold Benchmark Rules:** DLD sold medians (`dldMedianSoldPriceAed`, `vsDldSoldMedianPercent`) are computed from registered ready property transactions occurring within the past 90 days. The statistical engine requires at least three verified transactions (`dldSampleTransactionsCount >= 3`) for the matching building and bedroom layout. If building-level volume is insufficient, it falls back to the community median; if the broader community also lacks sufficient transactions, the fields return `null` to avoid ungrounded estimates.
3. **UAE Golden Visa Qualification Threshold:** Under UAE Federal Decree-Law No. 29 of 2020 and Cabinet Resolution No. 65 of 2022, property investments reaching or exceeding 2,000,000 AED qualify buyers for a renewable 10-year Golden Visa. The boolean flag `goldenVisaEligible` automatically marks `true` whenever `priceNumeric >= 2000000`. The scraper's dedicated `goldenVisaOnly: true` parameter enforces this boundary at the extraction stage.
4. **Tenancy Payment Schedule Parsing (`chequesCount`):** Under Dubai Law No. 26 of 2007, residential rent is traditionally paid via post-dated bank cheques (1, 2, 4, 6, or 12 cheques). The scraper parses explicit cheque mentions from listing descriptions into numeric integers (e.g., `"4 cheques"` becomes `4`). When a listing does not state cheque terms, the column remains `null` rather than assuming a standard term.
5. **RERA Madhmoun Electronic Permit Validation:** In Dubai, RERA regulations mandate that all real estate advertisements display an official Madhmoun QR code linking directly to the government Trakheesi validation portal (`trakheesi.dubailand.gov.ae`). The scraper extracts this direct URL into `reraValidationUrl` and `permitValidationUrl`. In Abu Dhabi, the 14-digit trade license or regulatory permit is stored in `permitNumber` with authority labeled `Madhmoun`.
6. **Zero-Schema-Drift Fixed 96 Flat Columns:** Every run across all four market branches (`buy`, `rent`, `commercial-buy`, `commercial-rent`) produces the identical 96-column schema in the exact same order. Columns specific to detail pages or specific branches (such as `floorPlans`, `chequesCount`, or `dldMedianSoldPriceAed`) default to `null` rather than disappearing, preventing schema mismatch errors when loading data into relational databases or automated BI pipelines.
7. **Derived Parking Space Allocation:** The `parkingSpaces` column evaluates the portal's structured attribute first, parses secondary mentions in the listing copy (e.g., `"2 allocated parking slots"`), or defaults to `1` when the listing includes covered parking amenities.
8. **Building Service Charge Extraction:** Deep detail mode (`includeDetails: true`) parses official building service charges per square foot (`serviceChargePerSqftAed`) directly from the property specification cards, enabling accurate net rental yield modeling after factoring in Owners Association maintenance fees.
9. **Instant Days on Market on First Run:** Unlike basic scrapers that measure listing age from the moment your script first ran, this tool calculates `daysOnMarket` using the portal's published original listing date (`listedDate`). You can filter by `minDaysOnMarket: 60` on your very first run to find stale inventory immediately.
10. **Commercial Business Centre Separation:** The boolean flag `isBusinessCentre` identifies serviced business centres and flex-desk spaces (typically under 180 sqft or described as coworking suites). Flagging these units prevents low-area all-inclusive desk rentals from skewing commercial office lease medians.

### What can you do with data after scraping propertyfinder.ae?

#### 1. UAE Golden Visa and DLD Sold Price Arbitrage Sourcing

International investors seek properties meeting the 2,000,000 AED Golden Visa threshold that are priced below recent Land Department transaction records.

1. Configure the scraper with `listingType: "buy"`, `goldenVisaOnly: true`, and `communities: ["Dubai Marina", "Downtown Dubai", "Dubai Hills Estate"]`.
2. Export the dataset to CSV or Google Sheets and sort by `vsDldSoldMedianPercent` in ascending order.
3. Identify properties where `vsDldSoldMedianPercent` is negative (for example, -5% to -15%), indicating an asking price below registered 90-day transactions in the same building.
4. Open `reraValidationUrl` to confirm the seller's title deed validity and click `agent1Whatsapp` to contact the listing agent directly.

#### 2. Off-Plan Developer Pipeline and Construction Milestone Tracking

Real estate funds and development analysts track primary project launches, construction delivery schedules, and payment plan structures across major developers.

1. Run the scraper with `listingType: "buy"`, `completionStatus: "off_plan"`, `includeDetails: true`, and select target expansion areas like `["JVC", "Dubai Creek Harbour", "Dubai South"]`.
2. Group records by `developerName` (e.g., Emaar, Sobha, Danube, Meteora) and evaluate `handoverDate` distributions across 2026, 2027, and 2028.
3. Compare `paymentPlanSummary` structures to benchmark competitors offering 1% monthly installments versus back-ended handover payments.
4. Calculate average projected service charges (`serviceChargePerSqftAed`) to forecast long-term holding costs for end buyers.

#### 3. Residential Rental Yield and Multi-Cheque Cashflow Optimization

Expat relocation agencies and property managers analyze gross rental yields and discount structures based on cheque payment schedules.

1. Execute a rental query with `listingType: "rent"`, `rentFrequency: "yearly"`, and `communities: ["Dubai Marina", "JLT", "Business Bay", "DIFC"]`.
2. Filter listings by `chequesCount` to isolate units accepting 4 or 12 cheques for flexible tenant placements.
3. Cross-reference 1-cheque listings against 4-cheque listings in the same tower to quantify the average upfront payment discount (typically 5% to 8%).
4. Compute net yields by subtracting building `serviceChargePerSqftAed` from annual rent divided by purchase valuation.

#### 4. UAE Broker and SuperAgent B2B Lead Generation for Co-Broking

Buyer's agents and brokerage directors assemble contact directories of verified listing agents to pitch joint buyer transactions.

1. Run a broad search across prime transaction corridors with `onlyVerified: true` and `maxItems: 500`.
2. Filter the output where `agentTier` equals `"super_agent"` to prioritize responsive, verified industry professionals.
3. Extract `agent1Name`, `agent1PhoneComplete`, `agent1Whatsapp`, and `agencyName` into your CRM system.
4. Initiate direct WhatsApp outreach for off-market inventory inquiries or co-broking collaboration on pre-qualified buyers.

#### 5. Automated Valuation Models (AVM) and Machine Learning Price Prediction

PropTech engineers build predictive pricing models and automated appraisal engines using clean 96-column tabular features.

1. Schedule daily runs across all 75 communities via the Apify Python SDK to maintain a rolling database of secondary and off-plan listings.
2. Ingest `priceNumeric`, `areaSqft`, `bedrooms`, `bathrooms`, `latitude`, `longitude`, `furnishing`, and `towerOrBuilding` as independent feature vectors.
3. Incorporate `dldMedianSoldPricePerSqftAed` as a ground-truth historical benchmark feature for building-level valuation modeling.
4. Train regression algorithms (e.g., XGBoost, LightGBM) to forecast fair market values and flag underpriced listings the moment they publish.

### Want to get other real estate data from the UAE & Australia?

<table>
<tr>
<th>Portal & platform</th>
<th>Coverage & core strengths</th>
</tr>
<tr>
<td>

🇦🇪 **[Bayut UAE Scraper](https://apify.com/kotaro001/bayut-uae-scraper)**

</td>
<td>

Extract listings from the second-largest UAE portal: TruValue algorithmic valuations, verified TruCheck badges, regional neighborhood guides, and dual Dubai/Abu Dhabi rental feeds.

</td>
</tr>
<tr>
<td>

🇦🇺 **[Realestate.com.au Scraper](https://apify.com/kotaro001/realestate-com-au-scraper)**

</td>
<td>

Access Australia's premier property portal: nationwide residential buy, rent, and sold records, multi-suburb searches, price-reduction tracking, and agent directories.

</td>
</tr>
<tr>
<td>

🇦🇺 **[Domain.com.au Scraper](https://apify.com/kotaro001/domain-com-au-scraper)**

</td>
<td>

Extract Australian Capital Territory and state properties: public school catchment boundaries, Saturday auction clearance rates, and detailed architectural feature tags.

</td>
</tr>
<tr>
<td>

🇦🇺 **[Allhomes.com.au Scraper](https://apify.com/kotaro001/allhomes-com-au-scraper)**

</td>
<td>

Capture Australian Capital Territory (ACT) real estate data: statutory Energy Efficiency Ratings (EER 0–6 stars), Crown leasehold Unimproved Values (UV), and annual municipal council rates.

</td>
</tr>
<tr>
<td>

🇦🇺 **[OnTheHouse.com.au Scraper](https://apify.com/kotaro001/onthehouse-com-au-scraper)**

</td>
<td>

Extract CoreLogic automated valuation models (AVM): medium confidence price estimates, weekly rental predictions, and multi-decade sales histories.

</td>
</tr>
<tr>
<td>

🇦🇺 **[Realcommercial.com.au Scraper](https://apify.com/kotaro001/realcommercial-com-au-scraper)**

</td>
<td>

Extract Australian commercial property intelligence: office buildings, industrial warehouses, retail investments, net return yields, and downloadable brochure PDFs.

</td>
</tr>
</table>

### ❓ Frequently Asked Questions

#### Is scraping propertyfinder.ae legal under UAE law?

Yes. Extracting publicly accessible real estate listings from `propertyfinder.ae` complies with applicable legal frameworks when performed responsibly. Under the UAE Personal Data Protection Law (Federal Decree-Law No. 45 of 2021, Articles 4 and 5), commercial contact details published by licensed real estate brokers (`agent1Name`, `agencyName`, `agent1PhoneComplete`, `agent1Whatsapp`) constitute public business directories intended for open commercial communication. Furthermore, factual property attributes (asking price, square footage, bedroom counts, DLD benchmarks, and geographic coordinates) are objective public facts. Legal precedents, including the US Ninth Circuit Court of Appeals decision in *hiQ Labs v. LinkedIn* (2022) and *Meta v. Bright Data* (2024), confirm that automated extraction of publicly available data behind no password barrier does not breach data access laws. Users must respect copyright by not republishing listing marketing copy or images verbatim.

#### What is the Dubai Land Department (DLD) sold price benchmark?

The DLD sold benchmark provides an objective valuation cross-check derived from official transfer registries recorded at the Dubai Land Department over the preceding 90 days. For ready sale listings, the scraper calculates the registered median price (`dldMedianSoldPriceAed`) and median price per square foot (`dldMedianSoldPricePerSqftAed`) for matching buildings and bedroom layouts. It reports `vsDldSoldMedianPercent` to show whether an asking price sits above or below registered government transaction averages. A minimum sample of three registered deals (`dldSampleTransactionsCount >= 3`) is required to generate the benchmark.

#### How does the scraper verify RERA Madhmoun permits?

Every real estate advertisement in Dubai must display an electronic permit verified through RERA's Madhmoun QR code system. The scraper extracts this direct URL into `reraValidationUrl` and `permitValidationUrl`, linking to `trakheesi.dubailand.gov.ae`. Clicking this link displays the official government certificate confirming property ownership authenticity, broker trade licensing, and current listing validity.

#### How does the scraper identify Golden Visa eligible properties?

Under UAE immigration rules (Cabinet Resolution No. 65 of 2022), property buyers investing at least 2,000,000 AED qualify for a 10-year residency Golden Visa. The scraper automatically marks `goldenVisaEligible: true` whenever `priceNumeric` meets or exceeds 2,000,000 AED. You can activate `goldenVisaOnly: true` in your run configuration to filter your results strictly to qualifying properties.

#### What does chequesCount mean in Dubai rental listings?

Tenancy agreements in Dubai are legally settled using post-dated bank cheques (PDCs) under Dubai Law No. 26 of 2007. Landlords specify the number of installments accepted annually, ranging from 1 cheque (full year upfront, usually commanding a 5% to 8% rent discount) to 2, 4, 6, or 12 cheques (monthly payments). The scraper parses this count into `chequesCount` to support rental cashflow planning.

#### Can I scrape off-plan projects and developer payment plans?

Yes. Selecting `completionStatus: "off_plan"` allows you to extract primary market launches across major developers such as Emaar, Nakheel, Damac, Sobha, and Aldar. The dataset delivers developer identity (`developerName`), project name (`projectName`), estimated delivery date (`handoverDate`), payment schedule breakdowns (`paymentPlanSummary`), and estimated annual maintenance fees (`serviceChargePerSqftAed`).

#### How are commercial business centres distinguished from standard offices?

Commercial office leases can be distorted by small serviced business centres and flex-desk spaces that bundle utilities into high per-square-foot rates. The scraper sets `isBusinessCentre: true` for units under 180 sqft or listings describing executive suites, co-working desks, or virtual offices, allowing financial analysts to isolate traditional office leases cleanly.

#### How does the scraper detect real-time price reductions?

The scraper captures the portal's active price-cut indicators directly from listing cards. When a vendor reduces their asking price, the scraper records `isPriceDrop: true`, signed percentage reductions (`priceChangePercent`), previous asking prices (`previousPrice`), and exact numeric deductions (`priceDiff`). Setting `onlyPriceChanged: true` restricts your output exclusively to properties with active price reductions.

#### Can I access PropertyFinder data via API or Python and Node.js SDKs?

Yes. Every scraper run can be initiated, monitored, and retrieved programmatically using the Apify REST API or official client libraries for Python (`apify-client`) and JavaScript/Node.js (`apify-client`). You can integrate runs into existing ETL systems, trigger webhook notifications on run completion, or ingest records directly into PostgreSQL, Snowflake, or BigQuery.

#### How can I connect PropertyFinder data to Zapier, Make, and Google Sheets?

Apify provides native integrations for Zapier, Make, and Google Sheets. You can configure a scheduled morning run that extracts price drops or new listings in Dubai Marina and automatically appends fresh rows to a shared Google Sheet or delivers instant lead alerts to a broker Slack channel or CRM via webhook.

#### How do I query PropertyFinder in real time using the Apify MCP Server?

The scraper integrates natively with the Model Context Protocol (MCP) via the Apify MCP Server at `https://mcp.apify.com`. To query live property data within Claude Desktop, Cursor, or ChatGPT:

1. Obtain your personal API token from your Apify Console settings.
2. Add the Apify MCP server configuration to your `claude_desktop_config.json` or Cursor MCP settings pointing to `https://mcp.apify.com`.
3. Reference Actor ID `qhvxQawCWUKHb8HnB` (`kotaro001/propertyfinder-ae-scraper`) in your MCP tool definitions.
4. Prompt your AI assistant naturally: *"Find 2-bedroom ready apartments in Dubai Marina under 2.5M AED that are priced below DLD sold benchmarks and return their direct WhatsApp links."* The model will execute the Actor and return structured insights directly in chat.

#### Do I need to purchase external proxies to run this scraper?

No. The scraper includes full access to Apify's rotating residential proxy pool and automated browser TLS fingerprint emulation within the standard Pay-Per-Event pricing. You do not need to purchase third-party proxy subscriptions or provide external proxy credentials.

#### What should I do if a propertyfinder.ae layout change breaks extraction?

The scraper is actively monitored and maintained against portal frontend updates. If you observe missing attributes or extraction errors following a portal layout modification, submit an issue report through the **Issues tab** in the Apify Console or contact us at **<support@propdealradar.com>**. Maintenance patches are typically tested and deployed within 24 to 48 hours.

# Changelog

This Actor's version history is a separate document: https://apify.com/kotaro001/propertyfinder-ae-scraper/changelog.md

# Actor input Schema

## `listingType` (type: `string`):

Market branch: `buy` (residential sales), `rent` (residential leases), `commercial-buy` (commercial property sales), or `commercial-rent` (commercial offices, retail and warehouses).

## `communities` (type: `array`):

Target UAE communities (e.g., Dubai Marina, Downtown Dubai, Palm Jumeirah, Business Bay, JVC, Dubai Hills Estate, Yas Island, Saadiyat Island). The row budget is split evenly across selected areas.

## `propertyTypes` (type: `array`):

Optional property categories: apartment, villa, townhouse, penthouse, duplex, office, retail, warehouse, land. Leave empty to extract all property types.

## `completionStatus` (type: `string`):

Filter by construction phase: `all`, `ready` (completed properties), or `off_plan` (primary developments under construction).

## `furnishing` (type: `string`):

Furnishing condition filter: `all`, `furnished` (turnkey holiday homes), `unfurnished`, or `partly_furnished`.

## `minPrice` (type: `integer`):

Minimum asking price or annual rent in AED. Listings without a numeric price figure are preserved.

## `maxPrice` (type: `integer`):

Maximum asking price or annual rent in AED. Filters out properties exceeding this budget ceiling.

## `minBedrooms` (type: `integer`):

Minimum number of bedrooms required (0 = Studio).

## `maxBedrooms` (type: `integer`):

Maximum number of bedrooms allowed.

## `minBathrooms` (type: `integer`):

Minimum number of bathrooms required.

## `minAreaSqft` (type: `integer`):

Minimum built-up area in square feet.

## `maxAreaSqft` (type: `integer`):

Maximum built-up area in square feet.

## `minDaysOnMarket` (type: `integer`):

Keep only listings advertised for at least this many days based on portal publication dates (0 = no filter). Useful for discovering motivated sellers.

## `onlyPriceChanged` (type: `boolean`):

Return only listings where the portal records a recent price drop. Ideal for sourcing discounted inventory.

## `onlyVerified` (type: `boolean`):

Return only verified listings with authenticated ownership documentation and official RERA permits.

## `goldenVisaOnly` (type: `boolean`):

Restrict results to properties priced at 2,000,000 AED or above, qualifying buyers for the UAE 10-year Golden Visa.

## `includeDetails` (type: `boolean`):

Open individual listing pages to extract vector floor plans, virtual 360 tours, building service charges per sqft, and full descriptions. Billed per enriched row.

## `maxItems` (type: `integer`):

Maximum listing records to output to your dataset.

## `maxDetails` (type: `integer`):

Safety budget cap on deep listing detail visits per run when includeDetails is enabled (0 = no cap). Protects against unexpected spend on broad searches.

## `rentFrequency` (type: `string`):

For rental runs only: restrict to `yearly` or `monthly` lease terms. Leave empty for all rental frequencies.

## `stateKey` (type: `string`):

Optional session slot name for persistent price tracking & change detection. NOT an Apify API key or private password.

## Actor input object example

```json
{
  "listingType": "buy",
  "communities": [
    "Dubai Marina"
  ],
  "propertyTypes": [],
  "completionStatus": "all",
  "furnishing": "all",
  "minDaysOnMarket": 0,
  "onlyPriceChanged": false,
  "onlyVerified": false,
  "goldenVisaOnly": false,
  "includeDetails": false,
  "maxItems": 20,
  "maxDetails": 0,
  "rentFrequency": ""
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

## `stats` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "listingType": "buy",
    "communities": [
        "Dubai Marina"
    ],
    "includeDetails": false,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("kotaro001/propertyfinder-ae-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "listingType": "buy",
    "communities": ["Dubai Marina"],
    "includeDetails": False,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("kotaro001/propertyfinder-ae-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "listingType": "buy",
  "communities": [
    "Dubai Marina"
  ],
  "includeDetails": false,
  "maxItems": 20
}' |
apify call kotaro001/propertyfinder-ae-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,kotaro001/propertyfinder-ae-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/qhvxQawCWUKHb8HnB/builds/pFn9Fx8PdSBsVTje0/openapi.json
