# realestateVIEW Listing Details API Documentation

Scrappa's `GET /api/realestateview/listing` returns the full record of one realestateVIEW listing. Send the numeric `id` from search.

## What you get

All the fields of a search row, plus `heading`, the written `description`, `features`, `floor_plans`, `statements_of_information`, `land_price_per_sqm`, `year_built`, `zoning`, `video_url`, `virtual_tour_url`, `suburb_trends`, `suburb_price_trend` and `similar_listings`. Prices are in Australian dollars and rent is per week.

## Contact details

Agent phone, mobile and email are returned only when the agent shows them publicly. A hidden mobile is never returned.

## Unknown ids

An id that realestateVIEW does not know answers `404` (`not_found`) and is not billed. A listing that was taken down answers the same way. An id that is not a number answers `422`.

- **Documentation:** [https://scrappa.co/docs/realestateview-api/realestateview_listing](https://scrappa.co/docs/realestateview-api/realestateview_listing)
- **API group:** realestateVIEW API
- **Endpoint:** `GET https://scrappa.co/api/realestateview/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` | string | Yes | Numeric listing id from search, for example 18245247. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "listing": {
        "id": 18245247,
        "status": "On Market",
        "listing_type": "sale",
        "sale_method": "Sale",
        "listing_path": "/property/vic/melbourne-3000/1409-260-spencer-street-18245247/",
        "price_text": "$645,000",
        "price_numeric": 645000,
        "price_to": null,
        "is_price_hidden": false,
        "rent_per_week": null,
        "sold_price": null,
        "is_sold_price_hidden": false,
        "sold_on": null,
        "beds": 2,
        "baths": 2,
        "cars": 0,
        "land_size_sqm": 84,
        "property_type": "Apartment & Unit",
        "property_types": [
            "Apartment & Unit"
        ],
        "source_property_type": "Apartment",
        "is_new_construction": false,
        "is_home_and_land": false,
        "address": {
            "unit_number": "1409",
            "street_number": "260",
            "street": "Spencer Street",
            "suburb": "Melbourne",
            "postcode": "3000",
            "state": "VIC",
            "city": "Melbourne",
            "region": "Melbourne",
            "lga": "Melbourne Council",
            "gnaf_id": "GAVIC720552251",
            "is_street_hidden": false
        },
        "lat": -37.814655,
        "lng": 144.952675,
        "images": [
            {
                "sequence": 1,
                "caption": null,
                "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18245247-1-D2A9EB3.jpg",
                "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18245247-1-D2A9EB3.jpg",
                "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18245247-1-D2A9EB3.jpg"
            }
        ],
        "inspections": [
            {
                "starts_at": "2026-10-31 12:00:00",
                "ends_at": "2026-10-31 12:15:00"
            }
        ],
        "auction_at": null,
        "created_at": "2026-10-26 07:50:49",
        "updated_at": "2026-10-26 07:50:55",
        "on_market_at": "2026-10-26 07:50:49",
        "agents": [
            {
                "id": 104933,
                "name": "Sample Agent",
                "first_name": "Sample",
                "last_name": "Agent",
                "position": null,
                "phone": "1300 000 000",
                "mobile": "0400 000 000",
                "email": null,
                "photo_url": null,
                "profile_path": "/agent-profile/sample-agent-104933/",
                "agency_id": null,
                "sold_listings": 16,
                "average_sold_price": 569161
            }
        ],
        "agency": {
            "id": 24798,
            "name": "Sample Realty",
            "slug": "sample-realty",
            "address": "Suite 1, Level 2, 34 Sample Street, Melbourne, VIC 3000",
            "suburb": "Melbourne",
            "postcode": "3000",
            "logo_url": "https://view.com.au/viewstatic/images/listing/300-min/f9a416dc651440608bd7cbc8b2450bae.png",
            "brand_colour": "00202F",
            "profile_path": "/real-estate-agency/sample-realty-24798/"
        },
        "heading": "Sophisticated apartment with resort-style amenities",
        "description": "A two bedroom apartment in the heart of the city.",
        "features": [
            "Balcony",
            "Gym",
            "Pool"
        ],
        "ai_features": [],
        "floor_plans": [],
        "statements_of_information": [],
        "land_price_per_sqm": 7678.57,
        "year_built": null,
        "zoning": null,
        "available_on": null,
        "video_url": null,
        "virtual_tour_url": null,
        "external_url": null,
        "static_map_url": null,
        "suburb_trends": [],
        "suburb_price_trend": [],
        "similar_listings": []
    },
    "meta": {
        "endpoint_family": "listing_detail",
        "billable": true,
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No listing exists with that id, or it was taken down (`not_found`). Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored (`request_rejected` is the same failure raised by the source). Non-billable. |
| 503 | Source Unavailable | realestateVIEW could not be reached in time, refused the request, or its answer changed shape (`upstream_unavailable`, `request_blocked`, `deadline_exhausted`, `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)