{ "openapi": "3.0.1", "info": { "title": "Property Finder Scraper - All Countries, Broker Phone & Email", "description": "Scrape Property Finder sale and rent listings in Egypt, UAE, Saudi Arabia, Qatar and Bahrain. Price per sqm, district, coordinates, days on market, amenities, plus optional broker phone and email. Paste a search link to keep your filters. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "tFsBclgWvI0Tf4zia" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabl8h3~property-finder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabl8h3-property-finder-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/nabl8h3~property-finder-scraper/runs": { "post": { "operationId": "runs-sync-nabl8h3-property-finder-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/nabl8h3~property-finder-scraper/run-sync": { "post": { "operationId": "run-sync-nabl8h3-property-finder-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": { "searchUrl": { "title": "Search link (optional)", "type": "string", "description": "Want only certain listings? Go to Property Finder, set your filters (location, price, bedrooms, property type), then copy the link from your browser and paste it here. When this is filled in, the Countries box below is ignored." }, "markets": { "title": "Countries", "type": "array", "description": "Tick the countries you want. Ignored if you paste a search link above.", "items": { "type": "string", "enum": [ "eg", "ae", "sa", "qa", "bh" ], "enumTitles": [ "Egypt", "United Arab Emirates", "Saudi Arabia", "Qatar", "Bahrain" ] }, "default": [ "eg", "ae", "sa" ] }, "purpose": { "title": "For sale or for rent", "enum": [ "buy", "rent" ], "type": "string", "description": "Select whether to scrape properties for sale or properties for rent. Ignored if you paste a search link above.", "default": "buy" }, "maxPagesPerMarket": { "title": "Max pages per country or search link", "minimum": 1, "maximum": 500, "type": "integer", "description": "About 25 listings per page. 5 pages x 3 countries = about 340 listings.", "default": 5 }, "maxListings": { "title": "Hard limit on total listings", "minimum": 1, "type": "integer", "description": "Maximum number of total listings to collect before stopping.", "default": 20000 }, "includeExtras": { "title": "Include description, amenities, photos and permit", "type": "boolean", "description": "On by default. Adds the listing description, amenities list, the first photo links (the search page shares up to 3 per listing), the permit number (when the listing has one) and the price-drop flag to each row. Turn off for smaller, faster results.", "default": true }, "includeBrokerContacts": { "title": "Include broker phone and email", "type": "boolean", "description": "Off by default. Turn on only if you need broker contact details and you are allowed to use them under the laws and rules that apply to you.", "default": false } } }, "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 } } } } } } } } } }