{ "openapi": "3.0.1", "info": { "title": "Property Finder UAE Scraper - Listings, Prices & Agents", "description": "Scrape PropertyFinder.ae listings at scale. Extract prices, property details, images, amenities, coordinates, agent contacts, broker info, RERA numbers and more for UAE real estate research and analysis.", "version": "1.0", "x-build-id": "gHNqLhGhYsN3OXCBQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~propertyfinder-ae-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-propertyfinder-ae-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/abotapi~propertyfinder-ae-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-propertyfinder-ae-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/abotapi~propertyfinder-ae-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-propertyfinder-ae-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "What do you want to scrape?", "enum": [ "search", "url", "agents", "brokers", "newProjects", "transactions", "areaInsights" ], "type": "string", "description": "Pick one mode. Each mode has its own section below; fields in other modes' sections are ignored.", "default": "search" }, "locations": { "title": "Locations", "type": "array", "description": "City or community names or slugs, e.g. 'Downtown Dubai', 'Dubai Marina' (typed names are looked up on the site; no match stops the run with a clear message), or slugs such as 'dubai', 'abu-dhabi', 'dubai/downtown-dubai', 'dubai/dubai-marina/marina-gate'. What an empty list means depends on the mode: listing search, agents, brokers and new projects = all UAE; DLD transactions = all of Dubai (transactions are published for Dubai only, other cities are skipped); area insights = required, list the areas you want (e.g. 'dubai/jumeirah-village-circle'). Ignored in URL mode.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "buy", "rent", "commercial-buy", "commercial-rent" ], "type": "string", "description": "Buy or rent, residential or commercial. Used by listing search, agents, brokers (which market they work in) and transactions (buy or rent; commercial = commercial deals).", "default": "buy" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Listing search: any of the types below. DLD transactions: one of apartments, villas, townhouses, penthouses, duplexes, land, whole-buildings, hotel-apartments, offices, retail-spaces, warehouses, shops. Residential: properties, apartments, studio-apartments, villas, townhouses, penthouses, hotel-apartments, compounds, land, duplexes, whole-buildings, bulk-sale-units, bungalows, full-floors, half-floors. Commercial: properties, offices, retail-spaces, warehouses, shops, showrooms, labor-camps, staff-accommodation, factories, business-centres, co-working-spaces, farms, whole-buildings, land, full-floors, half-floors, villas, bulk-sale-units (buy), bulk-rent-units (rent).", "items": { "type": "string" } }, "sort": { "title": "Sort listings by", "enum": [ "nd", "mr", "pa", "pd", "ba", "bd", "da", "dd" ], "type": "string", "description": "Sort order for results (Search mode only)", "default": "nd" }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text keywords matched against the listing, e.g. 'sea view' or 'upgraded'. Search mode only." }, "listedWithin": { "title": "Listed within", "enum": [ "any", "1", "7", "15", "30", "90" ], "type": "string", "description": "Only listings added in the last N days. Search mode only.", "default": "any" }, "virtualViewing": { "title": "Virtual viewing", "enum": [ "any", "video", "360_tours", "floor_plan", "live" ], "type": "string", "description": "Only listings that offer this kind of virtual viewing. Search mode only.", "default": "any" }, "propertyCondition": { "title": "Property condition", "type": "array", "description": "Only listings marked with one of these conditions. Search mode only.", "items": { "type": "string", "enum": [ "upgraded", "extended", "landscaped" ], "enumTitles": [ "Upgraded", "Extended", "Landscaped" ] } }, "mortgageCashbackOnly": { "title": "Mortgage cashback only (for sale)", "type": "boolean", "description": "Only sale listings that offer mortgage cashback. Search mode only.", "default": false }, "rentPeriod": { "title": "Rent period (for rent)", "enum": [ "yearly", "monthly", "weekly", "daily", "all" ], "type": "string", "description": "Which rent period to search. The site shows yearly rentals by default; pick monthly, weekly or daily for short-term rentals, or 'All periods' to search each period in turn (a listing shown under two periods is returned once). Search mode only.", "default": "yearly" }, "minCheques": { "title": "Min number of cheques (for rent)", "minimum": 1, "maximum": 12, "type": "integer", "description": "Minimum number of rent cheques accepted. Search mode only." }, "maxCheques": { "title": "Max number of cheques (for rent)", "minimum": 1, "maximum": 12, "type": "integer", "description": "Maximum number of rent cheques accepted. Search mode only." }, "urls": { "title": "Page URLs", "type": "array", "description": "PropertyFinder URLs, any supported shape: search pages (buy / rent / commercial / off-plan / community / paginated / filtered / sorted), a listing page, an agent or broker profile, the agents or brokers directory, new projects (all UAE, by city, or one project), DLD transactions and area insights. Tracking parameters (utm_*, fk) are removed; the non-www and m. hosts are normalised to www. Query filters (and page=N) on a pasted agents / brokers directory, new-projects, transactions or area URL are NOT applied: set them in the input form instead (the log names each ignored parameter). Search-page filters and page=N are applied. Unsupported pages (for example /ar/ which is 404) are skipped with a warning in the log. Left untouched the field runs one example of every distinct shape; the tracking-parameter and non-www examples in the prefill are cleaned to an already-listed page, so they are not in the default list.", "default": [ "https://www.propertyfinder.ae/en/buy/dubai/apartments-for-sale.html", "https://www.propertyfinder.ae/en/buy/dubai/apartments-for-sale.html?page=2", "https://www.propertyfinder.ae/en/buy/dubai/apartments-for-sale.html?bdr%5B%5D=2&pf=1000000&pt=2000000&ob=pa", "https://www.propertyfinder.ae/en/buy/dubai/apartments-for-sale.html?ob=pa&page=2", "https://www.propertyfinder.ae/en/buy/dubai/apartments-for-sale-downtown-dubai.html", "https://www.propertyfinder.ae/en/buy/dubai/apartments-for-sale-dubai-marina-marina-gate.html", "https://www.propertyfinder.ae/en/buy/dubai/1-bedroom-apartments-for-sale.html", "https://www.propertyfinder.ae/en/buy/dubai/properties-for-sale.html", "https://www.propertyfinder.ae/en/rent/dubai/apartments-for-rent.html", "https://www.propertyfinder.ae/en/commercial-rent/dubai/offices-for-rent.html", "https://www.propertyfinder.ae/en/for-sale/off-plan/apartments/dubai", "https://www.propertyfinder.ae/en/search?c=1&t=1&l=1&ob=nd", "https://www.propertyfinder.ae/en/plp/buy/apartment-for-sale-dubai-downtown-dubai-bellevue-towers-bellevue-tower-2-158222918.html", "https://www.propertyfinder.ae/en/agent/mamoun-hemora-276469", "https://www.propertyfinder.ae/en/find-agent/search?page=1", "https://www.propertyfinder.ae/en/broker/elite-property-brokerage-4428", "https://www.propertyfinder.ae/en/find-broker/search?page=1", "https://www.propertyfinder.ae/en/new-projects", "https://www.propertyfinder.ae/en/new-projects/lp/dubai", "https://www.propertyfinder.ae/en/new-projects/emaar-properties/valia-tower", "https://www.propertyfinder.ae/en/transactions/buy/dubai", "https://www.propertyfinder.ae/en/area-insights/dubai/downtown-dubai" ], "items": { "type": "string" } }, "minPrice": { "title": "Min price (AED)", "minimum": 0, "type": "integer", "description": "Minimum price in AED (for rentals, per rent period)." }, "maxPrice": { "title": "Max price (AED)", "minimum": 0, "type": "integer", "description": "Maximum price in AED (for rentals, per rent period)." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum bedrooms filter." }, "maxBedrooms": { "title": "Max bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum bedrooms filter." }, "minBathrooms": { "title": "Min bathrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum number of bathrooms." }, "maxBathrooms": { "title": "Max bathrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum number of bathrooms." }, "minAreaSqft": { "title": "Min size (sqft)", "minimum": 0, "type": "integer", "description": "Minimum built-up size in square feet." }, "maxAreaSqft": { "title": "Max size (sqft)", "minimum": 0, "type": "integer", "description": "Maximum built-up size in square feet." }, "minPricePerSqft": { "title": "Min price per sqft (AED)", "minimum": 0, "type": "integer", "description": "Minimum price per square foot." }, "maxPricePerSqft": { "title": "Max price per sqft (AED)", "minimum": 0, "type": "integer", "description": "Maximum price per square foot." }, "furnishing": { "title": "Furnishing", "enum": [ "any", "furnished", "unfurnished", "partly-furnished" ], "type": "string", "description": "Furnishing filter", "default": "any" }, "completionStatus": { "title": "Completion status", "enum": [ "any", "completed", "off_plan" ], "type": "string", "description": "Property completion status. 'off_plan' includes both off-plan and off-plan primary.", "default": "any" }, "amenities": { "title": "Amenities", "type": "array", "description": "Only listings that have ALL selected amenities.", "items": { "type": "string", "enum": [ "AC", "MR", "BA", "SP", "SS", "SY", "CS", "CP", "VW", "BL", "PA", "ST", "PG", "PP", "PY", "PJ", "BW", "WC", "BK", "MS", "PR", "CO", "BR" ], "enumTitles": [ "Central A/C", "Maids Room", "Balcony", "Shared Pool", "Shared Spa", "Shared Gym", "Concierge Service", "Covered Parking", "View of Water", "View of Landmark", "Pets Allowed", "Study", "Private Garden", "Private Pool", "Private Gym", "Private Jacuzzi", "Built in Wardrobes", "Walk-in Closet", "Built in Kitchen Appliances", "Maid Service", "Children's Play Area", "Children's Pool", "Barbecue Area" ] } }, "dealBadges": { "title": "Deal badges", "type": "array", "description": "Only listings carrying at least one of these site badges.", "items": { "type": "string", "enum": [ "price_drop", "great_value", "high_demand" ], "enumTitles": [ "Price drop", "Great value", "High demand" ] } }, "verifiedOnly": { "title": "Verified listings only", "type": "boolean", "description": "Only listings the site marks as verified.", "default": false }, "superAgentOnly": { "title": "SuperAgent listings only", "type": "boolean", "description": "Only listings posted by a SuperAgent.", "default": false }, "searchText": { "title": "Name search", "type": "string", "description": "Only agents or brokers whose name matches this text, e.g. 'emaar'." }, "directorySort": { "title": "Sort by", "enum": [ "featured", "most_sale_listings", "most_rent_listings" ], "type": "string", "description": "Order of the agent or broker directory.", "default": "featured" }, "agentLanguages": { "title": "Languages spoken (agents only)", "type": "array", "description": "Only agents who speak one of these languages, e.g. 'Arabic', 'Russian', 'Hindi'.", "items": { "type": "string" } }, "agentNationality": { "title": "Nationality (agents only)", "type": "string", "description": "Two-letter country code, e.g. 'IN', 'GB', 'AE'." }, "transactionsPeriod": { "title": "Period", "enum": [ "1w", "1m", "3m", "6m", "ytd", "1y", "3y", "10y" ], "type": "string", "description": "How far back to read Dubai Land Department transactions (ignored when a From date is set).", "default": "1m" }, "transactionsFrom": { "title": "From date", "type": "string", "description": "Start date (YYYY-MM-DD). Overrides the period." }, "transactionsTo": { "title": "To date", "type": "string", "description": "End date (YYYY-MM-DD). Defaults to today." }, "transactionsSort": { "title": "Sort transactions by", "enum": [ "newest", "oldest", "price_high", "price_low" ], "type": "string", "description": "Order of transactions. For ranges above 500 deals the walk goes day by day, newest first (oldest first for 'Oldest').", "default": "newest" }, "maxReviewsPerArea": { "title": "Max reviews per area", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Resident reviews to include in each area row (the area's own reviews first, then its sub-areas and buildings). Billed per review. Set 0 for none.", "default": 20 }, "maxListings": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of rows to return (listings, agents, brokers, projects, transactions or areas). Set 0 for unlimited. API calls that leave this out get 100.", "default": 100 }, "maxItemsPerUrl": { "title": "Max results per URL", "minimum": 0, "type": "integer", "description": "Optional cap on rows taken from each search URL or query (on top of Max results). Leave empty for no per-URL cap." }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Maximum pages to paginate per search URL (~25 listings/page). Leave empty to walk every result page." }, "includeDetails": { "title": "Add listing details (listing modes, extra charge per listing)", "type": "boolean", "description": "Also open each listing's own page to add the full photo gallery in full resolution, the DLD permit number and validation link, broker and agent licence numbers, project/developer data for off-plan units, the price vs the area average, and the community rating. Slower (one extra page per listing) and billed per enriched listing.", "default": false }, "proxy": { "title": "Proxy", "type": "object", "description": "Proxy settings. Apify residential proxy in the UAE by default. Datacenter proxies also read this site, so you can pick a datacenter group to lower proxy cost. If the selected connection is unavailable to your plan, the run continues on a backup connection.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AE" } }, "resumeFromRunId": { "title": "Resume from run ID", "type": "string", "description": "Run ID (or dataset ID) of a previous run of this Actor. Listings already collected there are skipped, so this run returns only the delta. Leave empty for a normal run. For recurring daily/weekly monitoring of the same search, use Incremental mode below instead." }, "incrementalMode": { "title": "Incremental changes for scheduled runs", "type": "boolean", "description": "Turn this on for daily or recurring monitoring. A listing is UPDATED when any tracked field changes (price, status, agent, description, amenities and so on); it is compared on content only. Not compared: last_refreshed, image URL cache-busting query strings (?v=...), site badges (price drop, great value, high demand, spotlight), area price comparison, ratings and review counts, and broker listing counters. The first run returns all matching listings as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED listings. Turn on \"Emit unchanged\" or \"Emit expired\" only when you also want those listings returned (and billed). State is kept separately for each search/URL and filter setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from run ID above.", "default": false }, "stateKey": { "title": "State key (optional, incremental mode only)", "type": "string", "description": "Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the search/URL and filter settings — different searches then never mix state with each other." }, "emitUnchanged": { "title": "Emit unchanged listings (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return listings that have not changed since the last run, marked UNCHANGED. This returns — and bills — extra rows you already have, so leave it off unless you specifically want the full snapshot every run.", "default": false }, "emitExpired": { "title": "Emit expired listings (incremental mode only)", "type": "boolean", "description": "Off by default. Turn on to also return listings that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned every search URL — not when Max listings capped it, or when Resume was used. This returns — and bills — extra synthetic rows, so leave it off unless you need expiry tracking.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Field names whose changes alone should not make a listing UPDATED. Site badges (price drop, great value, high demand, spotlight) and the area price comparison and ratings are already ignored by default.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }