{ "openapi": "3.0.1", "info": { "title": "PropertyGuru / DDProperty Scraper (SG · MY · TH)", "description": "Scrapes property listings from PropertyGuru Singapore, PropertyGuru Malaysia and DDProperty Thailand — one actor, three SEA markets sharing one platform, 630,000+ listings. Filter by keyword, type, price, bedrooms and size; returns price, beds, baths, size, address, agent, photos and transit info.", "version": "0.1", "x-build-id": "mwrsS6gJA92DCEmSO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~propertyguru-properties-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-propertyguru-properties-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/scrapyx~propertyguru-properties-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-propertyguru-properties-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/scrapyx~propertyguru-properties-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-propertyguru-properties-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": { "markets": { "title": "Markets", "type": "array", "description": "Which markets to search — one search per market, each with its own SEARCH_SUMMARY row. All three run on the same platform, so results share an identical field shape and can be compared directly.", "items": { "type": "string", "enum": [ "th", "sg", "my" ], "enumTitles": [ "Thailand — DDProperty", "Singapore — PropertyGuru", "Malaysia — PropertyGuru" ] }, "default": [ "th" ] }, "listingType": { "title": "For sale or for rent", "enum": [ "sale", "rent" ], "type": "string", "description": "Which side of the market to search.", "default": "sale" }, "keyword": { "title": "Keyword / location", "type": "string", "description": "Free-text search, e.g. a district or project name: bangkok, sukhumvit, orchard, mont kiara. Leave empty to browse the whole market.", "default": "" }, "propertyType": { "title": "Property type", "enum": [ "", "CONDO", "APT", "BUNG", "SEMI", "LAND", "TER", "HDB" ], "type": "string", "description": "IMPORTANT: these codes are market-specific. Condo and Apartment work on all three markets; Bungalow and Semi-detached work on all three; Land only narrows Thailand; Terraced and HDB are not honoured on any market as of 2026-08-13. An unsupported code is silently dropped upstream and returns an UNFILTERED search — this actor detects that and reports propertyTypeApplied=false on the summary row rather than letting it pass as filtered.", "default": "" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "In the market's own currency (THB / SGD / MYR). Leave empty or 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "In the market's own currency (THB / SGD / MYR). Leave empty or 0 for no maximum.", "default": 0 }, "bedrooms": { "title": "Bedrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms. Leave empty or 0 for any.", "default": 0 }, "minSize": { "title": "Minimum floor area", "minimum": 0, "type": "integer", "description": "In the market's own unit (sqm in TH/MY, sqft in SG). Leave empty or 0 for any.", "default": 0 }, "maxItems": { "title": "Max listings per market", "minimum": 0, "type": "integer", "description": "Stop paginating a market after this many listings. Set to 0 for unlimited — note Malaysia alone advertises over 224,000 listings for sale, so set a bound unless you mean it.", "default": 100 }, "includePropertyDetails": { "title": "Fetch full listing details", "type": "boolean", "description": "Fetch each listing's own page for the full description, complete facility list, project data and agent contact — one extra request per listing. Off by default because the search row is already rich (price, beds, baths, size, address, agent, photos, features, MRT/transit info), and detail pages are the slowest part of any run.", "default": false }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 12, "type": "integer", "description": "Upper bound on requests in flight at once, across market pagination and detail fetches.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy on the shared datacenter pool. This is the default because it is included in your plan at no extra cost and this target works through it. If you start seeing blocks, challenges or empty results, switch the group here to Residential -- it uses real consumer IPs and gets through more, but Apify bills residential traffic per gigabyte, so leave it off unless you need it.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }