# PropertyFinder Dubai Off-Plan Project Tracker (`xtracto/propertyfinder-offplan-tracker`) Actor Extract off-plan and new-project listings from PropertyFinder UAE -- project & developer name, status, expected handover, price range, payment plans, and estimated ROI when available. - **URL**: https://apify.com/xtracto/propertyfinder-offplan-tracker.md - **Developed by:** [xtractoo](https://apify.com/xtracto) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.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 ## PropertyFinder Dubai Off-Plan Project Tracker Pull off-plan and new-development projects from PropertyFinder UAE into a clean dataset — project name, developer, project status, expected handover year, price range, payment-plan types (including post-handover plans), and estimated ROI when it's published. Built for international expat investors, migration agencies, and institutional funds tracking Dubai's booming off-plan market. ### Why use this actor - **No account, no login, no API key** required. - **Every project fully detailed** — project & developer name, status (off-plan / under construction / ready), expected handover, starting price and full price range, payment plans, amenities, location with map coordinates, and gallery images. - **Post-handover payment plans flagged** — each project is tagged `hasPostHandoverPaymentPlan` so you can isolate the plans expat buyers care about most. - **Filter to exactly what you want** — by emirate (Dubai, Abu Dhabi, …), completion status, developer, price range, or expected handover date. - **Stable JSON output** suitable for pipelines, spreadsheets, or a database — download as JSON, CSV, or Excel. - **Automatic retries** keep multi-emirate runs flowing without manual babysitting. ### How it works 1. You choose what to collect — e.g. `{ "completionStatus": "off_plan", "locations": ["Dubai"] }`. Leave `locations` empty for all of the UAE. 2. The actor walks every page of matching projects and reads each one's full detail — developer, status, handover, price range, and payment plans. 3. Results stream into your dataset in real time, ready to download as JSON, CSV, or Excel. You don't manage any of the fetching, paging, or retrying — just set your search and press **Run**. ### Input All fields are pre-filled in Apify Console, so you can press **Run** immediately. ```json { "completionStatus": "off_plan", "locations": ["Dubai"], "filters": { "hasPostHandoverPaymentPlan": true, "minPrice": 1000000 }, "maxItems": 100, "maxPages": 120, "maxRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` | Field | Type | Description | |---|---|---| | `completionStatus` | string | `"off_plan"` (default), `"completed"` (ready), or `""` (all). | | `locations` | array | Emirates to collect. Supported: Dubai, Abu Dhabi, Sharjah, Ras Al Khaimah, Ajman, Umm Al Quwain, Fujairah, Al Ain. Empty = all UAE. | | `filters` | object | Optional: `developerId`, `minPrice`, `maxPrice`, `deliveryDateGte`, `deliveryDateLte`, `hasPostHandoverPaymentPlan` (true/false), `propertyTypeId`. | | `maxItems` | integer | Soft cap on rows emitted. `0` = unlimited. Default `100`. | | `maxPages` | integer | Safety ceiling on pages (24 projects each) per emirate. Default `120`. | | `maxRetries` | integer | Retries per request before giving up. Default `5`. | | `proxyConfiguration` | object | Recommended. A residential pool keeps the UAE site calm; pin `apifyProxyCountry` to `AE` for local addresses, or leave it global for a mixed pool. | ### Output Real sample (one record, verbatim; images array truncated): ```json { "source": "propertyfinder", "sourceId": "a4962042-e705-4082-a5b1-5cd27c6a4b8e", "url": "https://www.propertyfinder.ae/en/new-projects/emaar-properties/creek-haven", "projectName": "Creek Haven", "developer": { "id": "79ca4333-9975-4672-b05f-bb7329de75e9", "name": "Emaar Properties", "logoUrl": "https://new-projects-media.propertyfinder.com/developer/.../original.png" }, "status": "under_construction", "salesPhase": "waiting_for_sales_start", "stockAvailability": "available", "handoverDate": "2030-03-31T13:41:00Z", "handoverYear": 2030, "estimatedRoi": null, "startingPrice": 1868888, "priceRange": { "min": 3296888, "max": 5491888 }, "currency": "AED", "paymentPlans": ["10/70/20", "10/90"], "downPaymentPercentage": 10, "hasPostHandoverPaymentPlan": true, "propertyTypes": ["apartment"], "bedrooms": ["1", "2", "3"], "amenities": ["Indoor Swimming Pool", "Landscaped Gardens", "Gymnasium", "... 3 more"], "location": { "fullName": "Dubai,Dubai Creek Harbour (The Lagoons),Creek Haven", "id": 17744, "lat": 25.1992605206, "lng": 55.3474927078 }, "images": ["https://new-projects-media.propertyfinder.com/project/.../medium.webp", "... more"], "_source": "S1-nextdata", "_scrapedAt": "2026-05-29T17:03:23Z" } ``` | Field | Type | Description | |---|---|---| | `source` | string | Always `"propertyfinder"`. | | `sourceId` | string | PropertyFinder project ID. | | `url` | string | Public project page. | | `projectName` | string | Project title. | | `developer` | object | `id`, `name`, `logoUrl`. | | `status` | string | Lifecycle phase, e.g. `under_construction`, `not_started`, `ready`. | | `salesPhase` / `stockAvailability` | string | Sales lifecycle and current availability. | | `handoverDate` / `handoverYear` | string / int | Expected completion date and its year. | | `estimatedRoi` | number | Estimated annual ROI / rental yield **when PropertyFinder publishes it** (otherwise `null`). | | `startingPrice` | number | Lowest advertised price (AED). | | `priceRange` | object | `{ min, max }` in AED, when available. | | `paymentPlans` | array | Plan codes like `"10/70/20"` = down% / during-construction% / post-handover%. | | `downPaymentPercentage` | number | Down-payment percentage. | | `hasPostHandoverPaymentPlan` | boolean | `true` when any plan has a non-zero post-handover portion. | | `propertyTypes` / `bedrooms` / `amenities` | array | Unit mix and amenities. | | `location` | object | `fullName`, `id`, `lat`, `lng`. | | `images` | array | Gallery image URLs. | | `raw` | object | The full upstream project node, for any field not surfaced above. | | `_source` / `_scrapedAt` | string | Strategy tag and UTC collection time. | > **About ROI:** PropertyFinder's project listings don't always carry an explicit yield figure. This actor surfaces `estimatedRoi` whenever it's present in the source and returns `null` when it isn't — it never fabricates a number. To estimate yield yourself, combine `priceRange` with rental comps for the same area. ### Use cases - **Off-plan deal discovery** — pull every off-plan project in Dubai each morning, sort by `handoverYear`, and shortlist near-term completions before they sell out. - **Post-handover plan targeting** — filter `hasPostHandoverPaymentPlan: true` to build a list of the flexible-payment projects expat buyers ask for most. - **Developer monitoring** — track a specific developer's pipeline (`filters.developerId`) and diff daily runs to catch new launches the moment they post. - **Price-band sourcing** — set `minPrice`/`maxPrice` to match a client's budget and hand agents a ready-made, structured shortlist. - **Yield modeling** — join `priceRange` + `bedrooms` + `location` into your own rental-comp model to rank projects by expected return. - **Migration & relocation advisory** — feed the dataset into client portals so expat investors can browse handover timelines and payment plans by emirate. - **Market analytics** — aggregate by emirate / developer / handover year over time to track launch volume, pricing trends, and the off-plan vs. ready mix. ### Other real-estate actors Part of the same Apify real-estate collection — every actor emits stable JSON you can union downstream: | Actor | What it does | |---|---| | [Zillow All-in-One Scraper](https://apify.com/xtracto/zillow-all-in-one-scraper) | Map-area and search-results listings with full property details. | | [Realtor.com All-in-One Scraper](https://apify.com/xtracto/realtor-all-in-one-scraper) | Agent-listed homes, details, photos, agents, price & tax history. | | [FSBO.com Lead Extractor](https://apify.com/xtracto/fsbo-seller-lead-extractor) | For-sale-by-owner seller leads with direct property + owner details. | | [Auction.com Foreclosure Scraper](https://apify.com/xtracto/auction-foreclosure-sniper) | Upcoming foreclosure & bank-owned auctions with schedule, value, and status. | | [PropertyFinder Off-Plan Tracker](https://apify.com/xtracto/propertyfinder-offplan-tracker) — **this actor** | Dubai/UAE off-plan & new projects with developer, handover, price & payment plans. | | [LandWatch Price-per-Acre Scraper](https://apify.com/xtracto/landwatch-price-per-acre-scraper) | Raw-land listings with acreage, price-per-acre, zoning, and broker contact. | # Actor input Schema ## `completionStatus` (type: `string`): Which projects to collect. ## `locations` (type: `array`): Emirates to scrape. Empty = all UAE. ## `filters` (type: `object`): Optional: developerId, minPrice, maxPrice, deliveryDateGte, deliveryDateLte, hasPostHandoverPaymentPlan (true/false), propertyTypeId. ## `maxItems` (type: `integer`): Soft cap on dataset rows. 0 = unlimited. ## `maxPages` (type: `integer`): Safety ceiling on result pages (24 projects each) walked per emirate. ## `maxRetries` (type: `integer`): How many times to retry a request before giving up. ## `proxyConfiguration` (type: `object`): Recommended. A residential pool keeps the UAE site's protection calm. Pin the country to AE for local IPs, or leave global for a mixed pool. ## Actor input object example ```json { "completionStatus": "off_plan", "locations": [ "Dubai" ], "filters": {}, "maxItems": 100, "maxPages": 120, "maxRetries": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "filters": {}, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/propertyfinder-offplan-tracker").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 = { "filters": {}, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("xtracto/propertyfinder-offplan-tracker").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 '{ "filters": {}, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call xtracto/propertyfinder-offplan-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/propertyfinder-offplan-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PropertyFinder Dubai Off-Plan Project Tracker", "description": "Extract off-plan and new-project listings from PropertyFinder UAE -- project & developer name, status, expected handover, price range, payment plans, and estimated ROI when available.", "version": "0.1", "x-build-id": "17Tbp9vu7AdcgmKCj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~propertyfinder-offplan-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-propertyfinder-offplan-tracker", "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/xtracto~propertyfinder-offplan-tracker/runs": { "post": { "operationId": "runs-sync-xtracto-propertyfinder-offplan-tracker", "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/xtracto~propertyfinder-offplan-tracker/run-sync": { "post": { "operationId": "run-sync-xtracto-propertyfinder-offplan-tracker", "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": { "completionStatus": { "title": "Completion status", "enum": [ "off_plan", "completed", "" ], "type": "string", "description": "Which projects to collect.", "default": "off_plan" }, "locations": { "title": "Emirates", "uniqueItems": true, "type": "array", "description": "Emirates to scrape. Empty = all UAE.", "items": { "type": "string", "enum": [ "Dubai", "Abu Dhabi", "Sharjah", "Ras Al Khaimah", "Ajman", "Umm Al Quwain", "Fujairah", "Al Ain" ] }, "default": [ "Dubai" ] }, "filters": { "title": "Extra filters", "type": "object", "description": "Optional: developerId, minPrice, maxPrice, deliveryDateGte, deliveryDateLte, hasPostHandoverPaymentPlan (true/false), propertyTypeId." }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Soft cap on dataset rows. 0 = unlimited.", "default": 100 }, "maxPages": { "title": "Max pages per emirate", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety ceiling on result pages (24 projects each) walked per emirate.", "default": 120 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many times to retry a request before giving up.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Recommended. A residential pool keeps the UAE site's protection calm. Pin the country to AE for local IPs, or leave global for a mixed pool.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```