Use Southeast Asia Property Listings by Country & Bedroom Count with Python

Search PropertyGuru for-sale and for-rent listings across Singapore, Malaysia, Thailand and Indonesia by property type, bedrooms and price, with agent details, area and photos per listing.

1. Choose the data you need

Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.

2. Prepare a source-based input

This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.

{
  "availability": "any",
  "bathrooms": [],
  "bedrooms": [],
  "country": "SG",
  "district": "any",
  "floorLevel": "any",
  "furnishing": "any",
  "includeDetails": false,
  "listingType": "sale",
  "maxDistanceToMrt": "any",
  "maxItems": 2,
  "maxPages": 1,
  "mode": "search",
  "propertyType": "any",
  "sort": "recommended",
  "startUrls": [],
  "tenure": "any"
}

Download input.example.json and save your reviewed copy as input.json.

Field	Type	Required	Description
`mode`	string	required	Search listings by filters, or scrape specific search, listing and project URLs.
`country`	string	optional	Market to search (mode=search). Singapore and Malaysia use PropertyGuru; Thailand uses DDProperty.
`listingType`	string	optional	Sale or rental listings (mode=search).
`searchQuery`	string	optional	Free-text area, project, MRT station or keyword, for example 'Thomson', 'Mont Kiara' or 'Sukhumvit' (mode=search).
`propertyType`	string	optional	Filter by property type (mode=search). Types a market does not have are ignored with a status note.
`district`	string	optional	Filter by Singapore district D01-D28 (mode=search). Ignored for Malaysia and Thailand.
`minPrice`	integer	optional	Minimum asking price in the market's local currency (SGD, MYR or THB).
`maxPrice`	integer	optional	Maximum asking price in the market's local currency (SGD, MYR or THB).
`bedrooms`	array	optional	Return any of these exact bedroom counts. 0 means studio. Leave empty for all.
`bathrooms`	array	optional	Return any of these exact bathroom counts. Leave empty for all.
`minSize`	integer	optional	Minimum floor area in square feet for Singapore and Malaysia, square metres for Thailand.
`maxSize`	integer	optional	Maximum floor area in square feet for Singapore and Malaysia, square metres for Thailand.
`tenure`	string	optional	Freehold or leasehold (mode=search, sale only).
`furnishing`	string	optional	Furnishing level of the property (mode=search).
`floorLevel`	string	optional	Floor level of the unit (mode=search).
`availability`	string	optional	Move-in availability (mode=search, rent only).
`maxDistanceToMrt`	string	optional	Maximum walking distance to an MRT/LRT station (Singapore and Thailand).
`sort`	string	optional	Order of the results (mode=search).
`maxItems`	integer	optional	Stop after this many listings.
`maxPages`	integer	optional	Stop after this many search-result pages. The site's own last page also stops the run.
`includeDetails`	boolean	optional	Open each listing page for description, agent mobile, coordinates, transit, schools, amenities and media. One extra request per listing.
`startUrls`	array	optional	Paste PropertyGuru SG/MY or DDProperty TH search-result, listing or project URLs (mode=byUrl).

3. Start an Actor run

Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.

Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.

import json
import os
import urllib.request

# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
    actor_input = json.load(stream)

token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
    "https://api.apify.com/v2/acts/qPkm9zhap3uCleMSt/runs?timeout=120&maxTotalChargeUsd=0.50",
    data=json.dumps(actor_input).encode("utf-8"),
    headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
    method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
    run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.

4. Inspect the actual results

Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.

Property listings from Singapore, Malaysia and Thailand with prices, property details, agent or developer contact, transit, schools, project unit types and media.

Questions before you run

Which inputs are required?

The published required fields are mode

What does this guide verify?

The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.

What if the run request times out?

Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.

Open on Apify Full Actor reference

Generated from source build nYkOHZZmevFgyM1O5 and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.