{ "openapi": "3.0.1", "info": { "title": "PropertyGuru SG & MY Listings Scraper", "description": "Scrape public PropertyGuru Singapore and Malaysia sale and rent listings from search or listing URLs. Returns price, type, area, tenure, GPS, amenities and agent, plus beds and baths when enriched.", "version": "0.1", "x-build-id": "PI7rJz33U9sYHxTsb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~propertyguru-all-in-one-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-propertyguru-all-in-one-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/khadinakbar~propertyguru-all-in-one-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-propertyguru-all-in-one-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/khadinakbar~propertyguru-all-in-one-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-propertyguru-all-in-one-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": { "market": { "title": "Market", "enum": [ "SG", "MY" ], "type": "string", "description": "Choose Singapore (propertyguru.com.sg) or Malaysia (propertyguru.com.my). Ignored when startUrls already include a full PropertyGuru host.", "default": "SG" }, "listingType": { "title": "Listing type", "enum": [ "sale", "rent" ], "type": "string", "description": "Sale or rent search when building a URL from filters. Ignored for pasted startUrls.", "default": "sale" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional PropertyGuru search or listing URLs (SG or MY). Example search: https://www.propertyguru.com.sg/property-for-sale?market=residential. Leave empty to build a search from Market / Listing type / filters.", "items": { "type": "string" } }, "searchLocation": { "title": "Location search", "type": "string", "description": "Optional free-text location (e.g. Orchard, Tampines, Petaling Jaya) when building a search URL." }, "propertyType": { "title": "Property type", "enum": [ "all", "condo", "hdb", "landed" ], "type": "string", "description": "Optional property-type filter for built searches.", "default": "all" }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price in local currency (SGD or MYR)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price in local currency (SGD or MYR)." }, "bedrooms": { "title": "Bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Exact bedroom filter (0 = studio)." }, "maxResults": { "title": "Maximum listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on validated listings returned and billed. Prefill 5 for a fast quality sample.", "default": 20 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Pagination cap per search URL (about 20 cards per page).", "default": 1 }, "enrichDetails": { "title": "Enrich listing details", "type": "boolean", "description": "Fetch each listing detail page for beds, baths, floor area, tenure, GPS, amenities, and agent. Adds the listing-enriched event.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Unblocker is the most reliable route (Cloudflare). Residential SG/MY usually works; if Residential returns 403 the Actor retries once with Unblocker automatically.", "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 }, "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 } } } } } } } } } }