{ "openapi": "3.0.1", "info": { "title": "PropertyGuru Scraper | All-In-One | $1 / 1k", "description": "Extracts detailed listings from Singapore (PropertyGuru), Malaysia (PropertyGuru),Thailand (DDProperty) and Vietnam (Batdongsan.com.vn). Gathers rich data including photos, videos, prices, and agent info. Fast, reliable scraper that deliver clean, structured data for your market research.", "version": "0.4", "x-build-id": "UHTVqsqPJu4CFSWtO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~propertyguru-scraper-ddproperty-batdongsan-ppe/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-propertyguru-scraper-ddproperty-batdongsan-ppe", "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/fatihtahta~propertyguru-scraper-ddproperty-batdongsan-ppe/runs": { "post": { "operationId": "runs-sync-fatihtahta-propertyguru-scraper-ddproperty-batdongsan-ppe", "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/fatihtahta~propertyguru-scraper-ddproperty-batdongsan-ppe/run-sync": { "post": { "operationId": "run-sync-fatihtahta-propertyguru-scraper-ddproperty-batdongsan-ppe", "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": { "startUrls": { "title": "Start URLs (PropertyGuru, Batdongsan, DDProperty)", "type": "array", "description": "Enter specific search result URLs to scrape. If you provide any URLs here, the 'Search Queries' and 'Country' settings below will be ignored.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "sg", "my", "th", "vn" ], "type": "string", "description": "Select the country to run the search queries on. This setting is ignored if you provide Start URLs above.", "default": "sg" }, "listingType": { "title": "Listing Type", "enum": [ "sale", "rent" ], "type": "string", "description": "Choose whether search queries target sale or rent listings when building URLs. Ignored when Start URLs are provided.", "default": "sale" }, "propertyType": { "title": "Property Type", "enum": [ "auto", "sg_all", "sg_condo", "sg_landed", "sg_hdb", "my_all", "my_bungalow", "my_apartment", "my_semi_detached", "my_terrace", "my_land", "th_all", "th_condo", "th_single_detached", "th_semi_detached", "th_villa", "th_townhouse", "th_land", "th_apartment", "vn_all", "vn_apartment", "vn_mini_apartment", "vn_house", "vn_land", "vn_farm_resort", "vn_warehouse_factory", "vn_other" ], "type": "string", "description": "Optional property type preset applied when building search URLs. Pick a value that matches your selected country; unsupported combinations fall back to all property types.", "default": "auto" }, "minPrice": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Optional minimum price filter applied when building search URLs. Ignored when Start URLs are provided." }, "maxPrice": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Optional maximum price filter applied when building search URLs. Ignored when Start URLs are provided." }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Enter one or more search terms, like 'villa with pool' or '2 bedroom apartment'. The actor will run a search for each query in the selected country.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum Items Per Query/URL", "minimum": 10, "type": "integer", "description": "The maximum number of listings to scrape per search query or start URL. The scraper will stop scraping for a specific query once it reaches this number. Leave empty for no limit." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Using RESIDENTIAL proxies is strongly recommended for all runs and is effectively required for PropertyGuru Singapore, PropertyGuru Malaysia, and DDProperty if you want reliable completion without frequent blocking.", "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 } } }, "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 } } } } } } } } } }