# PropertyGuru Listing API Documentation

<p><strong>PropertyGuru Listing API</strong> returns the full record of one listing. Pass the listing id with its market, or the full listing URL. The record has price with currency, psf, floor size, bedrooms, bathrooms, tenure, property type and name, postcode, developer, district, region, project, posting date, description, facilities, amenities, photos, floor plans, coordinates, nearest MRT stations, nearby schools and the agent (name, agency, license, rating). Coordinates are null when the page has none. Phone numbers are never returned. An unknown or expired listing returns 404 and is not billed.</p>

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

## 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 | No | Market of the listing: sg or my. Needed with id. Example: sg. |
| `id` | string | No | Numeric listing id, 6 to 12 digits. Use either id or url. Example: 500227636. |
| `url` | string | No | Full listing URL on propertyguru.com.sg or propertyguru.com.my. Use either id or url. |

## Example response

```json
{
    "data": {
        "id": 500227636,
        "psf": 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",
            "agency": "ERA REALTY NETWORK PTE LTD",
            "rating": null,
            "license": "R074328A",
            "verified": false,
            "agency_id": 2,
            "profile_url": "https://www.propertyguru.com.sg/agent/eng-ong-901720421",
            "review_count": null
        },
        "price": {
            "type": "Negotiable",
            "value": 1050000,
            "pretty": "S$ 1,050,000",
            "currency": "SGD",
            "periodic": false
        },
        "title": "The Lakefront Residences",
        "images": [
            {
                "url": "https://sg1-cdn.pgimgs.com/listing/500227636/UPHO.161824615.V800/The-Lakefront-Residences-Boon-Lay-Jurong-Tuas-Singapore.jpg",
                "caption": "Private Patio (Virtually Staged)"
            },
            {
                "url": "https://sg1-cdn.pgimgs.com/listing/500227636/UPHO.161020856.V800/The-Lakefront-Residences-Boon-Lay-Jurong-Tuas-Singapore.jpg",
                "caption": "Private Patio"
            }
        ],
        "region": "West (D22-24)",
        "status": "ACT",
        "street": "Lakeside Drive",
        "address": "48 Lakeside Drive, Boon Lay / Jurong / Tuas",
        "details": [
            "Condominium for sale",
            "Unfurnished",
            "TOP in Jul 2014",
            "99-year lease"
        ],
        "project": {
            "id": 20561,
            "url": "https://www.propertyguru.com.sg/project/the-lakefront-residences-20561",
            "name": "The Lakefront Residences"
        },
        "schools": [
            {
                "name": "Yuan Ching Secondary School",
                "distance": "200 m",
                "duration": "2 mins",
                "coordinates": {
                    "latitude": 1.342006,
                    "longitude": 103.720899
                }
            }
        ],
        "bedrooms": 1,
        "district": "Boon Lay / Jurong / Tuas",
        "postcode": "648305",
        "amenities": [
            "Air conditioner",
            "Balcony",
            "Barbecue pavilion"
        ],
        "bathrooms": 1,
        "developer": "Keppel Land (Mayfair) Pte Ltd",
        "posted_at": "2026-10-25T12:57:30+00:00",
        "size_sqft": 624,
        "facilities": [
            "24 hours security",
            "Clubhouse",
            "Covered car park"
        ],
        "hdb_estate": null,
        "coordinates": {
            "latitude": 1.3427282,
            "longitude": 103.7203004
        },
        "description": {
            "text": "***Call or WhatsApp Eng Ong at [phone removed] for a viewing***\n\nYour own garden, without the landed price. \n\nAsking price matches indicative bank valuation, no...",
            "headline": "Ground Floor 1BR with Private Garden Patio, Priced at Bank Valuation"
        },
        "floor_plans": [
            {
                "url": "https://sg1-cdn.pgimgs.com/listing/500227636/UFLOO.161824509.V800.jpg",
                "caption": null
            }
        ],
        "nearest_mrt": [
            {
                "name": "EW26 Lakeside MRT Station",
                "distance": "270 m",
                "duration": "3 mins",
                "coordinates": {
                    "latitude": 1.34432881,
                    "longitude": 103.72083977
                }
            }
        ],
        "new_project": false,
        "region_code": "H",
        "tenure_code": "L99",
        "video_count": 2,
        "listing_type": "sale",
        "district_code": "D22",
        "property_name": "The Lakefront Residences",
        "property_type": "Condominium",
        "land_size_sqft": null,
        "property_group": "condo"
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a range is invalid. This response is not billable. |
| 404 | Not Found | The listing does not exist or has expired. 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)