{ "openapi": "3.0.1", "info": { "title": "Propertyfinder Agents & Brokers Scraper", "description": "[💰 $0.9 / 1K] Extract real estate agents and brokerage profiles from Propertyfinder (UAE, Qatar, Bahrain). Get names, phones, languages, nationalities, listing counts, brokerage affiliation, ratings and more. Search by country, emirate, and keyword, or paste direct Propertyfinder search URLs.", "version": "1.0", "x-build-id": "5NxKLhAaBUjR4N0Lx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~propertyfinder-agents-brokers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-propertyfinder-agents-brokers-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/solidcode~propertyfinder-agents-brokers-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-propertyfinder-agents-brokers-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/solidcode~propertyfinder-agents-brokers-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-propertyfinder-agents-brokers-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": { "searchType": { "title": "What to Scrape", "enum": [ "agents", "brokers" ], "type": "string", "description": "Collect individual real estate agents (from /en/find-agent/search) or entire brokerage companies (from /en/find-broker/search). Ignored when you provide Start URLs below.", "default": "agents" }, "country": { "title": "Country", "enum": [ "ae", "qa", "bh" ], "type": "string", "description": "Propertyfinder regional site to search. Only markets where Propertyfinder currently operates an agent/broker directory are listed.", "default": "ae" }, "emirate": { "title": "Emirate / City (UAE only)", "enum": [ "all", "dubai", "abu-dhabi", "sharjah", "ajman", "ras-al-khaimah", "umm-al-quwain", "fujairah", "al-ain" ], "type": "string", "description": "Restrict results to agents or brokers active in a single UAE emirate. Applies only when Country is United Arab Emirates; ignored for Qatar and Bahrain. Leave as 'All' to search the whole country.", "default": "all" }, "searchQuery": { "title": "Name Search", "type": "string", "description": "Filter by agent name, brokerage name, or keyword (e.g. 'diana', 'allsopp', 'Emaar'). Leave empty to return everyone matching your country and emirate." }, "fetchDetails": { "title": "Fetch Full Profile Details", "type": "boolean", "description": "Also visit each agent's or brokerage's profile page to capture extra fields like bio, full transaction history, areas of expertise, awards, and description. Slower and more expensive but more complete. Leave off for lists/leads; turn on for research/enrichment.", "default": false }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Power-user input. Paste Propertyfinder URLs directly — agent search (e.g. https://www.propertyfinder.ae/en/find-agent/search?text=diana&category_id=2&location_id=1), broker search (/en/find-broker/search), or individual agent/broker profile pages. When provided these override the Country / Emirate / Name Search filters above.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of agent or broker profiles to collect per search. Set to 0 to collect every available profile (UAE currently indexes ~14,500 agents and ~4,000 brokerages). Results are collected in full pages of 20, so the actor may overshoot this cap by a few records on the final page.", "default": 500 } } }, "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 } } } } } } } } } }