# PropertyGuru Search API Documentation

<p><strong>PropertyGuru Search API</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/propertyguru-api/propertyguru_search](https://scrappa.co/docs/propertyguru-api/propertyguru_search)
- **API group:** PropertyGuru API
- **Endpoint:** `GET https://scrappa.co/api/propertyguru/v1/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `market` | string | Yes | Market to search: sg (Singapore) or my (Malaysia). Example: sg. |
| `listing_type` | string | No | sale (default) or rent. Example: rent. |
| `page` | integer | No | One-based page number. The response page always matches the request. Example: 2. |
| `bedrooms` | integer | No | Exact number of bedrooms, 0 for a studio. Example: 3. |
| `min_price` | integer | No | Minimum price in the local currency (rent: per month). Example: 3000. |
| `max_price` | integer | No | Maximum price in the local currency. Must be at least min_price. Example: 6000. |
| `min_size` | integer | No | Minimum floor size in square feet. Example: 800. |
| `max_size` | integer | No | Maximum floor size in square feet. Example: 1200. |
| `property_type` | string | No | Singapore only: condo, landed or hdb. Example: condo. |
| `district_code` | string | No | Singapore only: district code D01 to D28. Use Autocomplete to find it. Example: D09. |
| `region_code` | string | No | Malaysia only: area or region id from Autocomplete (search_filter). Example: 58jok. |
| `furnishing` | string | No | Rent only: full, partial or unfurnished. Example: full. |
| `sort` | string | No | Sort key: price, psf or size. Without it the site default order applies. Example: price. |
| `order` | string | No | asc (default) or desc. Used with sort. Example: asc. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. This response is not billable. |
| 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)