# Realestate Ad

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/realestate/ad` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/realestate-ad |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Fetch a single realestate.com.au property listing by URL or ID and get full price, rooms, land size, features, and agent as structured JSON.

## 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/realestate/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by URL

```json
{
  "id": "143160680",
  "lat": -37.8472,
  "lon": 144.6921,
  "url": "https://www.realestate.com.au/property-house-vic-tarneit-143160680",
  "price": "$689,000",
  "state": "VIC",
  "title": "Renowned Real Estate proudly presents this sensational opportunity in the heart of Tarneit",
  "images": [
    "https://i2.au.reastatic.net/800x600/d8d3607342301e4e1b5b4cb84e3fc3d8cf48849a6311dd38e44bf3977fc593d8/image.jpg",
    "https://i2.au.reastatic.net/800x600/a1b2c3d4e5f67890abcdef1234567890abcdef1234567890abcdef1234567890/image.jpg"
  ],
  "suburb": "Tarneit",
  "bedrooms": 4,
  "features": [
    "Built-in wardrobes",
    "Ducted heating",
    "Evaporative cooling",
    "Double garage",
    "Alfresco entertaining",
    "Solar panels",
    "Dishwasher"
  ],
  "postcode": "3029",
  "bathrooms": 2,
  "agent_name": "Him Raj Parajuli",
  "highlights": [
    "4 bedrooms",
    "336m² land",
    "Double garage"
  ],
  "updated_at": "2026-04-22T11:00:00Z",
  "year_built": 2019,
  "agency_name": "Renowned Real Estate - CRAIGIEBURN",
  "agent_phone": "0452060566",
  "description": "Set on a generous 336m² block, this stunning four-bedroom family home offers the perfect blend of modern living and suburban convenience. Features include open-plan living, a double garage, and a beautifully landscaped backyard.",
  "price_value": 689000,
  "auction_date": null,
  "full_address": "28 Chantelle Parade, Tarneit, VIC 3029",
  "land_size_m2": 336,
  "listing_type": "buy",
  "price_per_m2": 3533,
  "published_at": "2026-04-20T08:30:00Z",
  "property_type": "House",
  "short_address": "28 Chantelle Parade",
  "floor_plan_url": "https://i2.au.reastatic.net/800x600/floorplan_143160680.jpg",
  "parking_spaces": 2,
  "building_size_m2": 195,
  "virtual_tour_url": null
}
```

### Lookup by listing ID

```json
{
  "id": "143029712",
  "lat": -37.6301,
  "lon": 145.0114,
  "url": "https://www.realestate.com.au/property-house-vic-wollert-143029712",
  "price": "$620,000 - $660,000",
  "state": "VIC",
  "title": "Set in the sought-after Aurora Estate in a prime location close to all amenities",
  "images": [
    "https://i2.au.reastatic.net/800x600/b9c8d7e6f5a43210fedcba9876543210fedcba9876543210fedcba9876543210/image.jpg"
  ],
  "suburb": "Wollert",
  "bedrooms": 4,
  "features": [
    "Ducted heating",
    "Evaporative cooling",
    "Walk-in robe",
    "Double garage"
  ],
  "postcode": "3750",
  "bathrooms": 2,
  "agent_name": "Chad Gamage",
  "highlights": [
    "4 bedrooms",
    "331m² land"
  ],
  "updated_at": "2026-04-19T09:00:00Z",
  "year_built": 2020,
  "agency_name": "Carvera Property",
  "agent_phone": "0424876263",
  "description": "A beautifully presented four-bedroom family home in the Aurora Estate, surrounded by parks, schools, and shopping. This home features a modern kitchen, open-plan living and dining, and a low-maintenance backyard.",
  "price_value": 620000,
  "auction_date": null,
  "full_address": "12 Geary Avenue, Wollert, VIC 3750",
  "land_size_m2": 331,
  "listing_type": "buy",
  "price_per_m2": 3179,
  "published_at": "2026-04-18T10:00:00Z",
  "property_type": "House",
  "short_address": "12 Geary Avenue",
  "floor_plan_url": null,
  "parking_spaces": 2,
  "building_size_m2": 195,
  "virtual_tour_url": null
}
```

## Documentation

## Overview
Realestate.com.au is Australia's largest property portal. The site blocks automated data extraction. Piloterr returns the full listing as clean JSON with a single GET request.

## Quickstart
```
GET https://api.piloterr.com/v2/realestate/ad?query=143160680
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Listing URL or numeric listing ID |

## Main use cases
- Enrich property datasets with full listing details
- Collect features and land size for automated valuation models
- Monitor specific listings for price changes
- Build property comparison tools with full specs
- Power buyer apps with on-demand listing data

Get access at https://www.piloterr.com/pricing