# Trade Me Property Listing Detail API Documentation

Retrieve one Trade Me property listing (sale or rent) by its listing id: title, plain-text description, category, property type, price text, price or weekly price with currency, start, end and as-at dates in ISO 8601 UTC, view count, region, district, suburb, coordinates, bedrooms, bathrooms, the full attributes table, photos in thumbnail, medium and large sizes, open homes, agency name, website and logo, and the boundary image. Member profiles and personal contact data are never returned. An unknown or expired listing id returns a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/trademe-property-api/trademe_property_listing](https://scrappa.co/docs/trademe-property-api/trademe_property_listing)
- **API group:** Trade Me Property API
- **Endpoint:** `GET https://scrappa.co/api/trademe_property/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 |
| --- | --- | --- | --- |
| `id` | integer | Yes | Numeric Trade Me listing id from a search result, e.g. 6136706339. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/trademe_property/listing?id=6136706339"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": 6136706339,
            "url": "https://www.trademe.co.nz/a/listing/6136706339",
            "title": "BENEATH PAINTED SKIES",
            "description": "High above one of Kapiti Coast\u2019s most coveted stretches of coastline, this property occupies a remarkable position between land, sea and sky.\n\nBuilt in 2019 and spanning approximately 377 sqm, this ex\u2026",
            "category": "Lifestyle property",
            "property_type": "Dwelling",
            "price_text": "Price by negotiation",
            "start_date": "2026-09-17T09:50:54Z",
            "end_date": "2026-11-23T00:19:54Z",
            "as_at": "2026-10-15T14:49:59Z",
            "view_count": 7337,
            "region": "Wellington",
            "district": "Kapiti Coast",
            "suburb": "Te Horo",
            "location": {
                "latitude": -40.7864944,
                "longitude": 175.100751
            },
            "bedrooms": 4,
            "bathrooms": 3,
            "attributes": [
                {
                    "name": "bedrooms",
                    "label": "Bedrooms",
                    "value": "4 bedrooms"
                },
                {
                    "name": "bathrooms",
                    "label": "Bathrooms",
                    "value": "3 bathrooms"
                },
                {
                    "name": "property_type",
                    "label": "Property type",
                    "value": "Dwelling"
                },
                {
                    "name": "land_area",
                    "label": "Land area",
                    "value": "0.71 hectares"
                },
                {
                    "name": "rateable_value_(rv)",
                    "label": "Capital value (CV)",
                    "value": "$2,579,200"
                },
                {
                    "name": "price",
                    "label": "Price",
                    "value": "Price by negotiation"
                }
            ],
            "photos": [
                {
                    "thumbnail": "https://trademe.tmcdn.co.nz/photoserver/thumb/2329626909.jpg",
                    "medium": "https://trademe.tmcdn.co.nz/photoserver/med/2329626909.jpg",
                    "large": "https://trademe.tmcdn.co.nz/photoserver/tq/2329626909.jpg"
                }
            ],
            "agency": {
                "name": "Kelly & Co, (Licensed: REAA 2008)",
                "website": "https://www.kellyandco.nz",
                "logo_url": "https://trademe.tmcdn.co.nz/tm/property/agent_logos/7952048-6.jpg"
            }
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | The listing was not found or has expired. Not billed. |
|  | Error | Trade Me could not be reached. Not billed. |
|  | Error | Trade Me rejected the request. Not billed. |
|  | Error | The upstream service is temporarily unavailable. Please retry shortly. |
|  | Error | Trade Me returned an unexpected payload shape. Not billed. |
|  | Error | Trade Me rejected the request parameters. Not billed. |

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