{ "openapi": "3.0.1", "info": { "title": "Property24 Scraper — SA Property for Sale & Rent, No Phones", "description": "South African property listings from Property24, for sale or to rent: price, bedrooms, bathrooms, size, type, suburb and city, the agency, and optionally the listed date and full text. No phones.", "version": "0.1", "x-build-id": "37T0mxxrWwwyGKzoB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~property24-properties/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-property24-properties", "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/highbrow_fame~property24-properties/runs": { "post": { "operationId": "runs-sync-highbrow_fame-property24-properties", "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/highbrow_fame~property24-properties/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-property24-properties", "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 links", "type": "array", "description": "Set up a search on property24.com with all the filters you want and paste the address of the results page (…/for-sale/… or …/to-rent/…). One per line.", "items": { "type": "string" } }, "locations": { "title": "Places", "type": "array", "description": "Or search here without a link: suburbs, cities, regions or provinces (Sea Point, Sandton, Durban, Gauteng). Add \", \" to pick one of several suburbs with the same name (\"Parkhurst, Johannesburg\"). The filters below apply.", "items": { "type": "string" } }, "maxListingsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stops each search after this many listings. Property24 shows every page of a search, 20 listings a page.", "default": 200 }, "channel": { "title": "For sale or to rent", "enum": [ "sale", "rent" ], "type": "string", "description": "For the places above.", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "any", "house", "apartment", "townhouse", "vacant-land", "farm", "commercial", "industrial" ], "type": "string", "description": "For the places above.", "default": "any" }, "minPrice": { "title": "Min price (ZAR)", "minimum": 0, "type": "integer", "description": "Optional. For rent: per month." }, "maxPrice": { "title": "Max price (ZAR)", "minimum": 0, "type": "integer", "description": "Optional. For rent: per month." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Optional." }, "minBathrooms": { "title": "Min bathrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Optional." }, "sortBy": { "title": "Sort by", "enum": [ "default", "newest", "cheapest", "dearest" ], "type": "string", "description": "For the places above.", "default": "default" }, "onlyAuctions": { "title": "Only auctions", "type": "boolean", "description": "Optional: only properties on auction.", "default": false }, "onlyRepossessed": { "title": "Only repossessed properties", "type": "boolean", "description": "Optional.", "default": false }, "onlyOnShow": { "title": "Only properties on show", "type": "boolean", "description": "Optional: only properties with a show day.", "default": false }, "onlyRetirement": { "title": "Only retirement properties", "type": "boolean", "description": "Optional.", "default": false }, "includeDetails": { "title": "Open every listing for its details", "type": "boolean", "description": "Adds the date it was listed, the full description, the map point, rates and taxes, levies, and the agency for premium listings. One more page per listing, so slower.", "default": false }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to work on at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Property24 turns the Apify servers' own addresses away (\"Server unavailable\"), so the run goes through one South African residential address, held for the whole run and kept to about one request a second.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "ZA" } } } }, "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 } } } } } } } } } }