# realestate.co.nz Listing Detail API Documentation Retrieve one realestate.co.nz listing (sale or rent) by id: price text and number, price history, address with coordinates, bedrooms, bathrooms, parking, land and floor area, auction details, open homes, features, plain-text and HTML description, all photos with sizes, videos, floor plans, virtual tours, nearby schools and child care, and the listing agents and office. An unknown or removed listing id returns a non-billable 404. - **Documentation:** [https://scrappa.co/docs/realestate-co-nz-api/realestate_co_nz_listing](https://scrappa.co/docs/realestate-co-nz-api/realestate_co_nz_listing) - **API group:** realestate.co.nz API - **Endpoint:** `GET https://scrappa.co/api/realestate-co-nz/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 listing id from a search result or autocomplete, e.g. 43156911. | ## Example request ```bash #!/bin/bash curl -X GET \ -H "x-api-key: YOUR_API_KEY_HERE" \ "https://scrappa.co/api/realestate-co-nz/listing?id=43156911" ``` ## Example response ```json { "success": true, "data": { "listing": { "id": 43156911, "listing_no": "1973289", "url": "https://www.realestate.co.nz/43156911/residential/sale/67-lough-bourne-drive-pukekohe", "title": "Where design meets tranquillity", "status": "active", "category": "res_sale", "property_type": "House", "price_text": "Auction", "currency": "NZD", "price_code": 5, "auction_at": "2026-11-24T02:00:00Z", "auction_location": "8 Massey Avenue, Pukekohe", "address": { "full": "67 Lough Bourne Drive, Pukekohe, Franklin, Auckland", "display": "67 Lough Bourne Drive, Pukekohe", "street_number": "67", "street": "Lough Bourne Drive", "suburb": "Pukekohe", "district": "Franklin", "region": "Auckland", "postcode": "2120", "suburb_slug": "auckland_franklin_pukekohe_pukekohe", "district_slug": "auckland_franklin", "region_slug": "auckland", "latitude": -37.1880619, "longitude": 174.8975293 }, "bedrooms": 4, "bathrooms": 2, "parking": { "garage": 3, "carport": 0, "off_street": 0 }, "land_area": 1024, "land_area_unit": "sqm", "land_area_sqm": 1024, "floor_area": 237, "floor_area_unit": "sqm", "floor_area_sqm": 237, "published_at": "2026-10-25T02:57:04Z", "created_at": "2026-10-25T02:57:04Z", "open_homes": [ { "start": "2026-10-31T00:15:00Z", "end": "2026-10-31T00:45:00Z" }, { "start": "2026-11-01T00:15:00Z", "end": "2026-11-01T00:45:00Z" } ], "is_new_construction": false, "is_mortgagee_sale": false, "is_coastal_waterfront": false, "has_swimming_pool": false, "is_featured": true, "features": [], "description": "Positioned in a peaceful cul-de-sac and backing directly onto a tranquil bush setting, this striking Jennian-built residence offers a level of design distinctio\u2026", "photo_count": 24, "photos": [ { "url": "https://mediaserver.realestate.co.nz/listings/43156911/a876efeb05261acef191a50300b13ddd.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43156911/a876efeb05261acef191a50300b13ddd.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43156911/a876efeb05261acef191a50300b13ddd.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43156911/a876efeb05261acef191a50300b13ddd.crop.140x178.jpg" }, { "url": "https://mediaserver.realestate.co.nz/listings/43156911/a53dd85cc85c47ee7a6d723eb391452b.jpg", "thumbnail_url": "https://mediaserver.realestate.co.nz/listings/43156911/a53dd85cc85c47ee7a6d723eb391452b.crop.31x40.jpg", "medium_url": "https://mediaserver.realestate.co.nz/listings/43156911/a53dd85cc85c47ee7a6d723eb391452b.crop.105x134.jpg", "large_url": "https://mediaserver.realestate.co.nz/listings/43156911/a53dd85cc85c47ee7a6d723eb391452b.crop.140x178.jpg" } ], "agents": [ { "id": 564606, "name": "Mike Murphy", "first_name": "Mike", "last_name": "Murphy", "slug": "mike-murphy", "phone": "021 000 000", "email": "agent@example.co.nz", "website_url": "https://www.bayleys.co.nz/mike-murphy", "image": { "url": "https://mediaserver.realestate.co.nz/per_orgs/564606/4d7c20ec2f11518976580b049896b4da.jpg" }, "office_name": "Bayleys Real Estate Ltd (Licensed: REAA 2008) - Pukekohe", "listing_count": 26 }, { "id": 945281, "name": "Patrick Murphy", "first_name": "Patrick", "last_name": "Murphy", "slug": "patrick-murphy", "phone": "021 000 000", "email": "agent@example.co.nz", "website_url": "https://www.bayleys.co.nz/patrick-murphy", "image": { "url": "https://mediaserver.realestate.co.nz/per_orgs/945281/c4478c9aec106daf8f7dfd60e64550f8.jpg" }, "office_name": "Bayleys Real Estate Ltd (Licensed: REAA 2008) - Pukekohe", "listing_count": 14 } ], "office": { "id": 231240, "name": "Bayleys Real Estate Ltd (Licensed: REAA 2008) - Pukekohe", "colloquial_name": "Bayleys - Pukekohe", "slug": "bayleys-real-estate-ltd-licensed-reaa-2008-pukekohe", "phone": "021 000 000", "email": "agent@example.co.nz", "logo_url": "https://mediaserver.realestate.co.nz/per_orgs/231240/317fb1fad9daaf5bd0f93986120e4ebe.jpg", "brand_colour": "#00263A" }, "description_html": "

Positioned in a peaceful cul-de-sac and backing directly onto a tranquil bush setting, this striking Jennian-built residence offers a level of design distinc\u2026", "price_history": [], "videos": [], "virtual_tours": [], "floor_plans": [ { "url": "https://mediaserver.realestate.co.nz/listings/43156911/271231488399ba7219e41fc896e7f0b0.jpg" } ], "additional_websites": [ { "url": "https://www.bayleys.co.nz/1973289?ps-preview=true", "title": "here" } ], "schools": [ { "name": "Pukekohe North School", "slug": "pukekohe-north-school", "in_zone": true, "distance": "0.87km", "longitude": 174.895974, "latitude": -37.195792 }, { "name": "Pukekohe High School", "slug": "pukekohe-high-school", "in_zone": true, "distance": "1.98km", "longitude": 174.905826, "latitude": -37.204552 } ], "child_cares": [ { "name": "Lambs Preschool Pukekohe", "slug": "lambs-preschool-pukekohe", "in_zone": false, "distance": "1.52km", "longitude": 174.8941803, "latitude": -37.20146942 }, { "name": "Wild and Love Early Learning Village", "slug": "wild-and-love-early-learning-village", "in_zone": false, "distance": "3.08km", "longitude": 174.886747, "latitude": -37.2143534 } ], "broadbands": [] } }, "meta": { "endpoint_family": "listing", "billable": true } } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | | Error | page times rows is above 10000. Narrow the search. Not billed. | | | Error | The listing, agent or office does not exist. Not billed. | | | Error | realestate.co.nz could not be reached. Not billed. | | | Error | realestate.co.nz refused the request. Not billed. | | | Error | The upstream service is temporarily unavailable. Please retry shortly. | | | Error | realestate.co.nz returned an unexpected payload shape. Not billed. | | | Error | realestate.co.nz 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)