Skip to content
Scrappa Get API key
PropertyGuru API 1 credit/request

PropertyGuru Search API Documentation

GET https://scrappa.co/api/propertyguru/v1/search

PropertyGuru Search API returns property for sale or rent in Singapore and Malaysia as JSON. Filter by price, bedrooms, floor size, property type, district or area and furnishing, sort by price, psf or size, and page through the results. Each item carries the title, address, price with currency, psf, bedrooms, bathrooms, size, tenure, property type, district, nearest MRT, agent, agency and photos. The response also returns the result count, the real page and total pages, the applied filters and the available sort options. Every returned item satisfies every requested filter. A valid empty result is a successful, billable response.

PropertyGuru Search API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/propertyguru/v1/search
Auth header
x-api-key
Cost
1 credit/request
market = US
Response preview
200 OK
{
    "data": {
        "items": [
            {
                "id": 500227636,
                "mrt": "270 m (3 min) from EW26 Lakeside MRT",
                "psf": {
                    "text": "S$ 1,682.69 psf",
                    "value": 1682.69
                },
                "url": "https://www.propertyguru.com.sg/listing/for-sale-the-lakefront-residences-500227636",
                "agent": {
                    "id": 901720421,
                    "name": "Eng Ong",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

13 optional filters available.

market string Required

Market to search: sg (Singapore) or my (Malaysia). Example: sg.

Example value US
listing_type string Optional

sale (default) or rent. Example: rent.

Example value example
page integer Optional

One-based page number. The response page always matches the request. Example: 2.

Example value 1
bedrooms integer Optional

Exact number of bedrooms, 0 for a studio. Example: 3.

Example value 10
min_price integer Optional

Minimum price in the local currency (rent: per month). Example: 3000.

Example value 10
max_price integer Optional

Maximum price in the local currency. Must be at least min_price. Example: 6000.

Example value 10
min_size integer Optional

Minimum floor size in square feet. Example: 800.

Example value 10
max_size integer Optional

Maximum floor size in square feet. Example: 1200.

Example value 10
property_type string Optional

Singapore only: condo, landed or hdb. Example: condo.

Example value example
district_code string Optional

Singapore only: district code D01 to D28. Use Autocomplete to find it. Example: D09.

Example value example
region_code string Optional

Malaysia only: area or region id from Autocomplete (search_filter). Example: 58jok.

Example value example
furnishing string Optional

Rent only: full, partial or unfurnished. Example: full.

Example value example
sort string Optional

Sort key: price, psf or size. Without it the site default order applies. Example: price.

Example value relevance
order string Optional

asc (default) or desc. Used with sort. Example: asc.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "items": [
            {
                "id": 500227636,
                "mrt": "270 m (3 min) from EW26 Lakeside MRT",
                "psf": {
                    "text": "S$ 1,682.69 psf",
                    "value": 1682.69
                },
                "url": "https://www.propertyguru.com.sg/listing/for-sale-the-lakefront-residences-500227636",
                "agent": {
                    "id": 901720421,
                    "name": "Eng Ong",
                    "photo": "https://sg1-cdn.pgimgs.com/agent/901720421/APHO.160706328.165139518.V120B.png",
                    "license": "R074328A",
                    "verified": false,
                    "profile_url": "https://www.propertyguru.com.sg/agent/eng-ong-901720421"
                },
                "media": {
                    "images": 26,
                    "videos": 2,
                    "floorPlans": 1
                },
                "price": {
                    "type": "Negotiable",
                    "value": 1050000,
                    "pretty": "S$ 1,050,000",
                    "currency": "SGD"
                },
                "title": "The Lakefront Residences",
                "agency": {
                    "id": 2,
                    "name": "ERA REALTY NETWORK PTE LTD"
                },
                "images": [
                    "https://sg1-cdn.pgimgs.com/listing/500227636/UPHO.161824615.V800/The-Lakefront-Residences-Boon-Lay-Jurong-Tuas-Singapore.jpg",
                    "https://sg1-cdn.pgimgs.com/listing/500227636/UPHO.161020856.V800/The-Lakefront-Residences-Boon-Lay-Jurong-Tuas-Singapore.jpg"
                ],
                "region": "West (D22-24)",
                "status": "ACT",
                "tenure": "99-year Leasehold",
                "address": "48 Lakeside Drive, Boon Lay / Jurong / Tuas",
                "bedrooms": 1,
                "district": "Boon Lay / Jurong / Tuas",
                "features": [
                    "624 sqft",
                    "Condominium",
                    "99-year Leasehold",
                    "Built: 2014"
                ],
                "bathrooms": 1,
                "posted_at": "2026-10-25T12:57:30+00:00",
                "size_sqft": 624,
                "build_year": "Built: 2014",
                "project_id": 20561,
                "new_project": false,
                "region_code": "H",
                "tenure_code": "L99",
                "district_code": "D22",
                "property_type": "Condominium",
                "short_address": "Boon Lay / Jurong / Tuas, West (D22-24)",
                "property_group": "condo"
            }
        ],
        "market": "sg",
        "currency": "SGD",
        "pagination": {
            "per_page": 20,
            "total_pages": 2729,
            "current_page": 1
        },
        "listing_type": "sale",
        "result_count": 54561,
        "sort_options": [
            {
                "sort": "price",
                "label": "Lowest Price",
                "order": "asc"
            },
            {
                "sort": "price",
                "label": "Highest Price",
                "order": "desc"
            }
        ],
        "applied_filters": {
            "listing_type": "sale"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required parameter or a range is invalid. This response is not billable.

{
    "errors": {
        "market": [
            "The market field is required."
        ]
    },
    "message": "The request validation failed"
}
503

Upstream Unavailable

PropertyGuru could not be reached or returned data that does not match the request. This response is not billable and is retryable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "PropertyGuru could not be reached. Please retry shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.