# Domain.com.au Property

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/domaincomau/property` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/domaincomau-property |

## Description

Read one Domain.com.au listing from its URL. The response is a flat object with price, address, agency, and photos.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/domaincomau/property' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### 7D/27-31 Ocean Street N, Bondi

```json
{
  "id": 2021178032,
  "url": "https://www.domain.com.au/7d-27-31-ocean-street-n-bondi-nsw-2026-2021178032",
  "image": "https://rimh2.domainstatic.com.au/Oq0vqQyOB632hw2pt9TRSB5RRag=/fit-in/1920x1080/filters:format(webp):quality(85):no_upscale()/2021178032_1_1_260923_012858-w4134-h2756",
  "price": 1750000,
  "state": "NSW",
  "agents": [
    {
      "name": "Danny Taylor",
      "email": "dtaylor@raywhite.com",
      "phone": "0417400553",
      "photo": "https://rimh2.domainstatic.com.au/vJmYCfoQPL0ciW3j9VpuWPHXaPw=/180x180/filters:format(webp):quality(85):no_upscale()/https://images.domain.com.au/img/425/contact_2005423.png?date=639287874683470000",
      "profile_url": "https://www.domain.com.au/real-estate-agent/danny-taylor-2005423"
    },
    {
      "name": "Nathan Ryland",
      "email": "nryland@raywhite.com",
      "phone": "0435959161",
      "photo": "https://rimh2.domainstatic.com.au/IPkCuwpWLumzeCAm4bCRagVZNIw=/180x180/filters:format(webp):quality(85):no_upscale()/https://images.domain.com.au/img/425/contact_1822769.png?date=639288820005100000",
      "profile_url": "https://www.domain.com.au/real-estate-agent/nathan-ryland-1822769"
    }
  ],
  "images": [
    "https://rimh2.domainstatic.com.au/Oq0vqQyOB632hw2pt9TRSB5RRag=/fit-in/1920x1080/filters:format(webp):quality(85):no_upscale()/2021178032_1_1_260923_012858-w4134-h2756",
    "https://rimh2.domainstatic.com.au/YC4YQ75EMRylMceVgtaGBVGHTeE=/fit-in/1920x1080/filters:format(webp):quality(85):no_upscale()/2021178032_2_1_260923_012858-w4134-h2756"
  ],
  "status": "live",
  "street": "Ocean Street N",
  "suburb": "Bondi",
  "address": "7D/27-31 Ocean Street N, Bondi NSW 2026",
  "bedrooms": 2,
  "currency": "AUD",
  "headline": "Elevated Apartment In The North East Corner With Ocean And Harbour Views",
  "latitude": -33.8918989,
  "postcode": "2026",
  "agency_id": 425,
  "bathrooms": 1,
  "carspaces": 1,
  "listed_at": "2026-09-23T11:29:00+10:00",
  "longitude": 151.2623893,
  "price_max": null,
  "agency_url": "https://www.domain.com.au/real-estate-agencies/raywhitedoublebay-425/",
  "auction_at": null,
  "promo_type": "premium_plus",
  "updated_at": "2026-10-23T09:38:50.46",
  "agency_name": "Ray White Double Bay",
  "description": "Poised in a rare north east corner position, this updated apartment delivers a generous design capturing elevated views spanning over to both the harbour and azure ocean's horizon.",
  "property_id": "CF-0183-PL",
  "sale_method": "private_treaty",
  "unit_number": "7D",
  "agency_phone": "02 93639999",
  "listing_mode": "sale",
  "price_period": null,
  "land_area_sqm": null,
  "price_display": "$1,750,000",
  "property_type": "Apartment / Unit / Flat",
  "street_number": "27-31",
  "agency_website": "https://raywhitedoublebay.com/",
  "inspection_end": "2026-10-31T13:30:00",
  "inspection_start": "2026-10-31T13:00:00",
  "building_area_sqm": null
}
```

## Documentation

## Overview
Read one Domain.com.au listing. `query` is the listing URL from search. The path ends with the listing id. The response is one flat object.

`price` is the dollar amount. `price_display` is that amount written again. A two-sided guide uses `price` and `price_max`.

## Quickstart
Listing URL:

```
GET https://api.piloterr.com/v2/domaincomau/property?query=https://www.domain.com.au/7d-27-31-ocean-street-n-bondi-nsw-2026-2021178032
```

## Parameters
### query
Required string. A Domain listing URL whose path ends in the listing id.

- The JSON is one flat object. There is no `results` wrapper.
- `id` is the listing id from the path. `url` is the canonical listing URL.
- A search URL returns 400.
- A page with no listing returns 404.

### return_page_source
Optional boolean. Default `false`. `true` returns `{ "result": "<html>" }` instead of the listing.

## Response fields
| Field | Type | Description |
|---|---|---|
| `id` | integer | Listing id |
| `url` | string | Canonical listing URL |
| `headline` | string or null | Listing headline |
| `description` | string or null | Description |
| `status` | string or null | Listing status. `archived` when the page says so |
| `listing_mode` | string or null | `sale`, `rent`, or `sold` |
| `sale_method` | string or null | Sale method |
| `property_type` | string or null | Property type |
| `bedrooms` | integer or null | Bedrooms |
| `bathrooms` | integer or null | Bathrooms |
| `carspaces` | integer or null | Car spaces |
| `land_area_sqm` | number or null | Land size |
| `building_area_sqm` | number or null | Building size |
| `price` | integer or null | Dollar amount, or the lower amount of a range |
| `price_max` | integer or null | Upper amount of a range |
| `price_display` | string or null | Price rebuilt from those amounts |
| `currency` | string or null | `AUD` when a price is present |
| `price_period` | string or null | `week`, `month`, or `year` |
| `address` | string or null | Full address |
| `suburb` | string or null | Suburb |
| `state` | string or null | State |
| `postcode` | string or null | Postcode |
| `latitude` | number or null | Latitude |
| `longitude` | number or null | Longitude |
| `image` | string or null | Hero photo |
| `images` | array | Photo URLs |
| `agency_name` | string or null | Agency |
| `agency_phone` | string or null | Agency phone |
| `agency_url` | string or null | Agency profile |
| `agents` | array | Name, phone, and profile URL |
| `inspection_start` | string or null | Next inspection open time |
| `inspection_end` | string or null | Next inspection close time |
| `auction_at` | string or null | Auction time |

## Notes
When `price` is present, it is the first amount in `price_display`. A trailing dash on the source label is not kept.

## Use cases
- Open the home that a search card pointed to
- Read the asking price, agency, and inspection time

## Error codes
| Code | Meaning |
|---|---|
| 400 | Missing query, wrong host, or a URL that is not a listing |
| 401 | Missing API key |
| 403 | Domain blocked the page |
| 404 | No listing on the page |
| 500 | Render or parse failure |