{ "openapi": "3.0.1", "info": { "title": "PropertyFinder Scraper | Contacts & History", "description": "Extract Property Finder UAE listings and transaction history with rich property detail, agent and broker contacts, media, pricing, amenities, and market filters. Built for enterprise-grade UAE real estate intelligence, lead enrichment, and automated analytics pipelines.", "version": "0.1", "x-build-id": "2xH3EPWctxzjT1Pxn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~propertyfinder-scraper-all-in-one/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-propertyfinder-scraper-all-in-one", "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/fatihtahta~propertyfinder-scraper-all-in-one/runs": { "post": { "operationId": "runs-sync-fatihtahta-propertyfinder-scraper-all-in-one", "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/fatihtahta~propertyfinder-scraper-all-in-one/run-sync": { "post": { "operationId": "run-sync-fatihtahta-propertyfinder-scraper-all-in-one", "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": { "search_type": { "title": "Choose Search Type", "enum": [ "active_listings", "transaction_history" ], "type": "string", "description": "Choose Active listings for live Buy/Rent ads on Property Finder. Choose Transaction history for historic Dubai rent/sold records. After choosing transaction history, fill Historic Deal Type and any historic filters in the Alternative Method section.", "default": "active_listings" }, "deal_type": { "title": "Choose Deal Type", "enum": [ "rent", "buy" ], "type": "string", "description": "Choose Buy to collect active properties for sale, or Rent to collect active properties for rent. This does not control transaction history; use Historic Deal Type for sold/rented transaction records.", "default": "buy" }, "property_type": { "title": "Choose Listing Type", "enum": [ "residential_all", "commercial_all", "residential_apartment", "residential_villa", "residential_townhouse", "residential_penthouse", "residential_compound", "residential_duplex", "residential_full_floor", "residential_half_floor", "residential_whole_building", "residential_land", "residential_bulk_unit", "residential_bungalow", "residential_hotel_and_hotel_apartment", "commercial_office_space", "commercial_retail", "commercial_warehouse", "commercial_shop", "commercial_villa", "commercial_show_room", "commercial_full_floor", "commercial_half_floor", "commercial_whole_building", "commercial_land", "commercial_bulk_unit", "commercial_factory", "commercial_labor_camp", "commercial_staff_accommodation", "commercial_business_centre", "commercial_co_working_space", "commercial_farm" ], "type": "string", "description": "Select Residential All or Commercial All for wide active-listing coverage, or choose a specific subtype such as Apartment, Villa, Office Space, or Warehouse for a narrower search. Transaction history has its own Historic Property Type field.", "default": "residential_all" }, "location": { "title": "Enter Active Listing Location", "type": "string", "description": "Enter a UAE location such as Dubai, Business Bay, Dubai Marina, or a building name. Leave empty to search active listings without a location filter. For transaction history, use Historic Location instead." }, "completion": { "title": "Filter by Completion Status", "enum": [ "off_plan", "ready" ], "type": "string", "description": "Choose Off-plan for projects still under development, or Ready for completed active sale listings. Property Finder does not apply this active-listing control to Rent searches. For sold transaction history, use Historic Completion Status." }, "furnishing": { "title": "Filter by Furnishing", "enum": [ "furnished", "unfurnished", "partially_furnished" ], "type": "string", "description": "Choose Furnished, Unfurnished, or Partially furnished to narrow active listing results. Leave blank when furnishing is not important. Transaction-history records do not use furnishing filters." }, "bedroom_count": { "title": "Filter by Bedroom Count", "type": "array", "description": "Select any active-listing bedroom counts you want to include, such as Studio, 1, 2, or 7+. This is a multi-select field. Transaction history uses Historic Bedroom Count, which is single-select.", "items": { "type": "string", "enum": [ "studio", "1", "2", "3", "4", "5", "6", "7", "7_plus" ], "enumTitles": [ "studio", "1", "2", "3", "4", "5", "6", "7", "7+" ] } }, "bathroom": { "title": "Filter by Bathroom Count", "type": "array", "description": "Select one or more active-listing bathroom counts, including 7+. Leave blank when any bathroom count is acceptable. Transaction-history searches do not support bathroom filtering.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "7_plus" ], "enumTitles": [ "1", "2", "3", "4", "5", "6", "7", "7+" ] } }, "amenities": { "title": "Filter by Amenities", "type": "array", "description": "Select amenities such as Balcony, Shared Pool, Shared Gym, Covered Parking, Pets Allowed, or Children's Play Area. Amenities are active residential listing filters; they are not sent for commercial listing searches or transaction-history searches.", "items": { "type": "string", "enum": [ "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", "childrens_play_area", "childrens_pool", "barbecue_area" ], "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" ] } }, "keyword": { "title": "Filter by Keyword", "type": "string", "description": "Enter a short phrase such as beach, chiller free, sea view, or brand new. Keep it specific; broad keywords can hide otherwise relevant listings. Transaction history does not use keyword search." }, "multimedia": { "title": "Filter by Multimedia", "enum": [ "360_tours", "video" ], "type": "string", "description": "Choose 360 Tours or Video Tours to collect only active listings that advertise that media type. Leave blank when media availability should not affect coverage. Transaction history has no media filter." }, "sort_by": { "title": "Sort Active Listings", "enum": [ "featured", "newest", "lowest_price", "highest_price" ], "type": "string", "description": "Featured follows Property Finder's default relevance order. Newest is useful for monitoring fresh listings. Lowest price and Highest price are useful for price-bound sampling. Transaction-history rows use Property Finder's transaction ordering instead.", "default": "featured" }, "min_price": { "title": "Set Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum asking price for active listings, in AED. Set only this field for open-ended searches such as 500,000 AED and above. Transaction history uses Historic Minimum Price." }, "max_price": { "title": "Set Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum asking price for active listings, in AED. Set only this field for searches up to a budget ceiling. Transaction history uses Historic Maximum Price." }, "min_property_area": { "title": "Set Minimum Property Area", "minimum": 0, "type": "integer", "description": "Minimum property size for active listings, in square feet. Leave blank when smaller units are acceptable. Transaction history uses Historic Minimum Property Area." }, "max_property_area": { "title": "Set Maximum Property Area", "minimum": 0, "type": "integer", "description": "Maximum property size for active listings, in square feet. Leave blank when larger units are acceptable. Transaction history uses Historic Maximum Property Area." }, "historic_deal_type": { "title": "Choose Historic Deal Type", "enum": [ "rent", "buy" ], "type": "string", "description": "Choose Rent transaction history for rental contracts, or Sold transaction history for sale transactions. This is required when Search Type is Transaction history. Older inputs that set this field without Search Type still run the transaction-history method." }, "historic_location": { "title": "Enter Historic Location", "type": "string", "description": "Enter a Dubai community, neighborhood, or building for transaction history, such as Business Bay or Dubai Creek Harbour. Leave empty to search Dubai-wide transaction records. Non-Dubai locations are not supported by this transaction-history route." }, "historic_timeframe": { "title": "Choose Historic Timeframe", "enum": [ "ytd", "1w", "1m", "3m", "6m", "1y", "3y" ], "type": "string", "description": "Choose the transaction period to request from DataGuru. Use shorter periods such as 1w, 1m, or 3m for recent market movement, YTD for the current calendar year, or 3y for a broader historical view.", "default": "1y" }, "historic_property_type": { "title": "Choose Historic Property Type", "enum": [ "all", "apartment", "villa", "hotel_and_hotel_apartment" ], "type": "string", "description": "Narrow transaction history to one property type. Choose All when you want the complete market view, or choose Apartment, Villa, or Hotel & Hotel Apartment when comparing like-for-like transactions.", "default": "all" }, "historic_bedroom_count": { "title": "Choose Historic Bedroom Count", "enum": [ "studio", "1", "2", "3", "4", "5", "6", "7", "7_plus" ], "type": "string", "description": "Narrow transaction history to exactly one bedroom count, including Studio and 7+. DataGuru transaction history accepts a single bedroom value, unlike the active listing bedroom filter." }, "historic_min_price": { "title": "Set Historic Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum recorded transaction price in AED. Use it to exclude lower-value transactions from the historic dataset. Leave blank for no lower bound." }, "historic_max_price": { "title": "Set Historic Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum recorded transaction price in AED. Use it to focus the historic dataset on a budget or valuation band. Leave blank for no upper bound." }, "historic_min_property_area": { "title": "Set Historic Minimum Property Area", "minimum": 0, "type": "integer", "description": "Minimum recorded transaction property size in square feet. Use it when comparing only larger units or villas. Leave blank for no lower size bound." }, "historic_max_property_area": { "title": "Set Historic Maximum Property Area", "minimum": 0, "type": "integer", "description": "Maximum recorded transaction property size in square feet. Use it to exclude unusually large units from the historic dataset. Leave blank for no upper size bound." }, "historic_completion": { "title": "Choose Historic Completion Status", "enum": [ "off_plan", "ready" ], "type": "string", "description": "For sold transaction history, choose Off-plan or Ready to compare the right completion segment. This filter is ignored for rent transaction history because rental contracts do not use sale completion status." }, "maximize_coverage": { "title": "Maximize Coverage", "type": "boolean", "description": "Enabled by default for broad active listing or transaction-history searches, especially no-location, city-wide, Dubai-wide, or high-limit runs. The actor keeps the same criteria but collects through smaller price ranges when the target caps pagination. Turn it off for small, focused searches.", "default": true }, "limit": { "title": "Set Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of records to save. Use a small number such as 10 or 50 for quick checks, or leave blank to continue until pagination, coverage rules, or available results are exhausted." } } }, "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 } } } } } } } } } }