# Property.com.au Listing Detail API Documentation

Scrappa's `GET /api/property-com-au/listing` returns the full public record of one Australian property: address, features, images, value estimates, sales and rental timeline, market data and nearby places.

## Input

Pass `url` with a www.property.com.au property link, or `path` with its path. Take `path` from a search result, or `listing_path` from an address autocomplete result. Any other host returns `422`. A property id alone is not enough, because the link needs the state and suburb.

## What you get

- `pid`, `url`, `path`, `address`, `status` (For sale, For rent, Off market), `property_type`, `beds`, `baths`, `cars`, `land_size`, `latitude`, `longitude`, `description`, `features`.
- `images[]` with phone and desktop sizes in JPG and WebP, and `image_counts` for photos and floorplans.
- `value_estimates`: sale value and weekly rental estimate with range and confidence. `null` when none exists.
- `timeline[]`: every listing, auction, sale and rental event with price, date text, links and the agency and agent shown for it.
- `agents[]`: the agents and agencies named in the timeline. Property.com.au has no agent or agency profile page, so this is all there is.
- `market_insights`, `market_trends`, `similar_properties`, `neighbouring_properties`, `nearby_schools`, `nearby_childcare`, `internet_availability`, `planning_summary`, `breadcrumbs` and `json_ld`.

## What it does not have

Strata, council and water fees are not on the site, so there are no fee fields. Nothing is returned as `0` for them.

## Not found

An unknown property returns `404` (`not_found`), never billed.

- **Documentation:** [https://scrappa.co/docs/property-com-au-api/property_com_au_listing](https://scrappa.co/docs/property-com-au-api/property_com_au_listing)
- **API group:** Property.com.au API
- **Endpoint:** `GET https://scrappa.co/api/property-com-au/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 |
| --- | --- | --- | --- |
| `url` | string | No | A property.com.au property link, for example https://www.property.com.au/nsw/bondi-beach-2026/lamrock-ave/8-56-pid-11646090/. |
| `path` | string | No | The path of a search result or the listing_path of an address autocomplete result. Use instead of url. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/property-com-au/listing?url=https%3A%2F%2Fwww.property.com.au%2Fnsw%2Fbondi-beach-2026%2Flamrock-ave%2F8-56-pid-11646090%2F"
```

## Example response

```json
{
    "success": true,
    "data": {
        "pid": 11646090,
        "url": "https://www.property.com.au/nsw/bondi-beach-2026/lamrock-ave/8-56-pid-11646090/",
        "path": "/nsw/bondi-beach-2026/lamrock-ave/8-56-pid-11646090/",
        "address": {
            "full": "8/56 Lamrock Avenue, Bondi Beach, NSW 2026",
            "suburb": "Bondi Beach",
            "state": "NSW",
            "postcode": "2026"
        },
        "status": "Off market",
        "property_type": "Flat apartment",
        "beds": 2,
        "baths": 1,
        "cars": null,
        "land_size": {
            "value": 525,
            "unit": "m2",
            "text": "525m\u00b2"
        },
        "latitude": -33.89082563,
        "longitude": 151.27014554,
        "description": "8/56 Lamrock Avenue is a 2 bedroom, 1 bathroom flat apartment in Bondi Beach. The property was sold on the 24th of October, 2026 for $1,300,000.",
        "features": [
            {
                "name": "Floorboards",
                "value": null
            },
            {
                "name": "Mobile coverage",
                "value": "5G"
            }
        ],
        "images": [
            {
                "caption": "Sep 2026",
                "alt": "Property at 8/56 Lamrock Avenue, Bondi Beach NSW 2026",
                "phone_jpg": "https://i2.au.reastatic.net/1200x900-fit,progressive/653bfe33923b1fdb74d1e1c7f77daa1ff2c14c644a1206b0798d7110748ab1af/main.jpg",
                "phone_webp": "https://i2.au.reastatic.net/1200x900-fit,format=webp,progressive/653bfe33923b1fdb74d1e1c7f77daa1ff2c14c644a1206b0798d7110748ab1af/main.jpg",
                "desktop_jpg": "https://i2.au.reastatic.net/2560x1920-fit,progressive/653bfe33923b1fdb74d1e1c7f77daa1ff2c14c644a1206b0798d7110748ab1af/main.jpg",
                "desktop_webp": "https://i2.au.reastatic.net/2560x1920-fit,format=webp,progressive/653bfe33923b1fdb74d1e1c7f77daa1ff2c14c644a1206b0798d7110748ab1af/main.jpg"
            }
        ],
        "image_counts": {
            "images": 9,
            "floorplans": 1
        },
        "value_estimates": null,
        "timeline": [
            {
                "group": "2026",
                "type": "Sold",
                "title": "$1,300,000",
                "price_numeric": 1300000,
                "details": "24 Oct 2026 by Belle Property - Bondi Junction",
                "caption": null,
                "image_counts": [],
                "links": [
                    {
                        "title": "Realestate.com.au",
                        "url": "https://www.realestate.com.au/sold/property-apartment-nsw-bondi+beach-152423404"
                    }
                ],
                "agent": null,
                "agency": null
            },
            {
                "group": "1992",
                "type": "Sold",
                "title": "$153,000",
                "price_numeric": 153000,
                "details": "Sold 21 Mar 1992",
                "caption": null,
                "image_counts": [],
                "links": [],
                "agent": null,
                "agency": null
            }
        ],
        "agents": [],
        "market_insights": null,
        "market_trends": {
            "title": "Other similar properties recently sold",
            "properties": []
        },
        "similar_properties": [],
        "nearby_schools": [
            {
                "group": "Nearby primary schools",
                "name": "Bondi Beach Public School",
                "in_catchment": true,
                "facts": {
                    "grades": "K-6",
                    "sector": "Government",
                    "no_students": "413",
                    "distance": "0.64km"
                },
                "links": [
                    {
                        "title": "School website",
                        "url": "https://bondibeach-p.schools.nsw.gov.au/"
                    }
                ]
            }
        ],
        "nearby_childcare": [],
        "neighbouring_properties": [],
        "internet_availability": {
            "summary": "8/56 Lamrock Ave, Bondi Beach has an HFC NBN connection, updated Aug 2024",
            "nbn_technology": "HFC",
            "connection_quality": "EXCELLENT"
        },
        "planning_summary": null,
        "breadcrumbs": [
            {
                "title": "Home",
                "path": "/"
            },
            {
                "title": "NSW",
                "path": "/nsw/"
            },
            {
                "title": "Bondi Beach",
                "path": "/nsw/bondi-beach-2026/"
            }
        ],
        "json_ld": [
            {
                "@type": "Residence",
                "address": {
                    "@type": "PostalAddress",
                    "streetAddress": "8/56 Lamrock Avenue",
                    "addressLocality": "Bondi Beach",
                    "addressRegion": "NSW",
                    "postalCode": "2026"
                }
            }
        ]
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true,
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No property exists at that link (`not_found`). Non-billable. |
| 422 | Validation Error | A parameter is missing, unknown, or the link is not a www.property.com.au property link (`invalid_listing`). Other hosts are never fetched. Non-billable. |
| 503 | Upstream Unavailable | Property.com.au could not be reached after retries or answered with something unusable (`upstream_unavailable`, `upstream_blocked`, `parser_drift`). Retryable and never billed. Clients are never rate limited. |

## 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)
