{
"openapi": "3.0.1",
"info": {
"title": "PropertyFinder Scraper - UAE Listings & Agent Leads",
"description": "Scrape PropertyFinder.ae property listings: price, size, bedrooms and bathrooms, location with coordinates, amenities, and the listing agent and broker contact (name, email, phone). Paste a search URL, get structured rows. No browser, cents per listing.",
"version": "0.1",
"x-build-id": "0gPoARIfRZAXChfe1"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~propertyfinder-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~propertyfinder-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~propertyfinder-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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": {
"searchUrls": {
"title": "Search URLs",
"type": "array",
"description": "PropertyFinder.ae search-result URLs. Build the search you want on the site (buy/rent, city, property type, price, beds), then paste the result-page URL here - one per line. Leave empty and the run returns a small free sample.",
"items": {
"type": "string"
}
},
"urlsFromFile": {
"title": "Import search URLs from a file",
"type": "string",
"description": "Bulk-load search URLs. Either paste the whole list (one per line), or give a single link to a public .txt/.csv, a Google Sheet/Drive link, or an Apify key-value-store record. A file that cannot be read says so and charges nothing."
},
"maxItems": {
"title": "Max results",
"minimum": 1,
"type": "integer",
"description": "Stop after this many listings in total (across all search URLs). You are only charged for listings actually saved.",
"default": 500
},
"maxPagesPerUrl": {
"title": "Max pages per search URL",
"minimum": 1,
"type": "integer",
"description": "How deep to page through each search. A PropertyFinder page holds about 20-25 listings.",
"default": 10
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those - handy for lean CSV/Sheets exports. Open the dropdown and tick, or type to filter (price, agentEmail).",
"items": {
"type": "string",
"enum": [
"type",
"id",
"url",
"title",
"purpose",
"propertyType",
"price",
"currency",
"pricePeriod",
"pricePerArea",
"pricePerAreaUnit",
"bedrooms",
"bathrooms",
"sizeValue",
"sizeUnit",
"furnished",
"completionStatus",
"isVerified",
"isNewConstruction",
"reference",
"listedDate",
"locationName",
"city",
"latitude",
"longitude",
"agentName",
"agentEmail",
"agentPhone",
"brokerName",
"amenities",
"imagesCount",
"imageUrl",
"description",
"searchUrl",
"page",
"scrapedAt"
],
"enumTitles": [
"Record type (type)",
"Listing ID (id)",
"Listing URL (url)",
"Title (title)",
"Purpose - sale/rent (purpose)",
"Property type (propertyType)",
"Price (price)",
"Currency (currency)",
"Price period (pricePeriod)",
"Price per area (pricePerArea)",
"Price/area unit (pricePerAreaUnit)",
"Bedrooms (bedrooms)",
"Bathrooms (bathrooms)",
"Size value (sizeValue)",
"Size unit (sizeUnit)",
"Furnished (furnished)",
"Completion status (completionStatus)",
"Verified (isVerified)",
"New construction (isNewConstruction)",
"Reference (reference)",
"Listed date (listedDate)",
"Location (locationName)",
"City (city)",
"Latitude (latitude)",
"Longitude (longitude)",
"Agent name (agentName)",
"Agent email (agentEmail)",
"Agent phone (agentPhone)",
"Broker name (brokerName)",
"Amenities (amenities)",
"Images count (imagesCount)",
"Main image (imageUrl)",
"Description (description)",
"Source search URL (searchUrl)",
"Page (page)",
"Scraped at (scrapedAt)"
]
}
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "PropertyFinder blocks datacenter IPs, so Residential proxy is required and is the default. Leave it as-is unless you have your own residential provider.",
"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
}
}
}
}
}
}
}
}
}
}