{ "openapi": "3.0.1", "info": { "title": "Property Finder Scraper — Dubai & UAE, Saudi, Qatar, Egypt", "description": "Scrape Property Finder real estate listings in Dubai and the rest of the UAE, Saudi Arabia, Qatar, Egypt and Bahrain by city, area, type and bedrooms, or from pasted links: price, size, beds, baths, amenities, coordinates, verified flag, agent and broker details, photos. No login.", "version": "0.1", "x-build-id": "Qy7JPgyJhakHfOLpg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~propertyfinder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-propertyfinder-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/yugenox~propertyfinder-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-propertyfinder-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/yugenox~propertyfinder-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-propertyfinder-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "country": { "title": "🌍 Country", "enum": [ "ae", "qa", "bh", "eg", "sa" ], "type": "string", "description": "Which Property Finder site to search. Pasted links always use their own site.", "default": "ae" }, "purpose": { "title": "Buy or rent", "enum": [ "buy", "rent", "commercial-buy", "commercial-rent" ], "type": "string", "description": "Residential for sale or rent, or commercial for sale or rent.", "default": "buy" }, "city": { "title": "🏙️ City", "type": "string", "description": "City or emirate, e.g. Dubai, Abu Dhabi, Sharjah, Doha, Riyadh, Cairo. Leave empty to search the whole country." }, "locations": { "title": "📍 Areas", "type": "array", "description": "Areas or communities in that city, e.g. Dubai Marina, Business Bay, Jumeirah Village Circle. Each area is a separate search. Close spellings are matched to the site's area names.", "items": { "type": "string" } }, "propertyType": { "title": "🏠 Property type", "enum": [ "properties", "apartments", "villas", "townhouses", "penthouses", "duplexes", "land", "compounds", "hotel-apartments", "full-floors", "whole-buildings", "bungalows", "offices", "shops", "warehouses", "showrooms" ], "type": "string", "description": "Type of property. \"Any\" searches every type.", "default": "properties" }, "bedrooms": { "title": "🛏️ Bedrooms", "type": "array", "description": "Only these bedroom counts. Leave empty for any. \"7+\" means 7 or more.", "items": { "type": "string", "enum": [ "studio", "1", "2", "3", "4", "5", "6", "7" ], "enumTitles": [ "Studio", "1", "2", "3", "4", "5", "6", "7+" ] } }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "In the site's currency (AED, QAR, BHD, EGP, SAR), as listed — rentals are mostly yearly in the UAE and monthly in Qatar, Bahrain and Egypt." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "In the site's currency, as listed." }, "minArea": { "title": "Min size", "minimum": 0, "type": "integer", "description": "Property size, in the unit below." }, "maxArea": { "title": "Max size", "minimum": 0, "type": "integer", "description": "Property size, in the unit below." }, "areaUnit": { "title": "Size unit", "enum": [ "sqft", "sqm" ], "type": "string", "description": "Unit for Min/Max size. Every row has both sqft and sqm.", "default": "sqft" }, "furnishing": { "title": "Furnishing", "enum": [ "any", "furnished", "unfurnished", "partly-furnished" ], "type": "string", "description": "Only furnished, unfurnished or partly furnished listings.", "default": "any" }, "verifiedOnly": { "title": "Verified listings only", "type": "boolean", "description": "Keep only listings Property Finder marks as verified.", "default": false }, "startUrls": { "title": "🔗 Property Finder links", "type": "array", "description": "Search pages you opened on any Property Finder site (e.g. https://www.propertyfinder.ae/en/rent/dubai/apartments-for-rent-dubai-marina.html — add ?page=3 to start on page 3) or listing pages (…/en/plp/…). The filters above apply to them too.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Stop after this many listings in total (all searches together). 0 = no limit.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Each result page has 25 listings. With narrow price or size filters, the scraper reads pages until it has enough matches or reaches this number.", "default": 40 }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Also open each listing page: every photo in full size, DLD permit link, agency legal name, broker and agent licence numbers, service charge, available-from date, nearby recent transactions and agent stats. One extra page per listing.", "default": false }, "includeNewProjects": { "title": "Include new-project cards", "type": "boolean", "description": "Buy searches also show developer off-plan projects. Turn on to save them as rows (listingType project / project_unit).", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is the default and works for most runs. If the site starts refusing datacenter IPs, the run switches to residential proxies automatically when your account has them.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Pages loaded in parallel.", "default": 4 } } }, "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 } } } } } } } } } }