# Realestate Search

## Overview

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

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

Search realestate.com.au property listings by suburb or postcode and get price, bedrooms, land size, and agent details 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search houses for sale in Tarneit VIC

```json
{
  "page": 1,
  "results": [
    {
      "id": "143160680",
      "url": "https://www.realestate.com.au/property-house-vic-tarneit-143160680",
      "price": "$689,000",
      "images": [
        "https://i2.au.reastatic.net/800x600/d8d3607342301e4e1b5b4cb84e3fc3d8cf48849a6311dd38e44bf3977fc593d8/image.jpg"
      ],
      "address": {
        "state": "VIC",
        "suburb": "Tarneit",
        "postcode": "3029",
        "full_address": "28 Chantelle Parade, Tarneit, VIC 3029",
        "short_address": "28 Chantelle Parade"
      },
      "bedrooms": 4,
      "features": [
        "Built-in wardrobes",
        "Ducted heating",
        "Double garage"
      ],
      "bathrooms": 2,
      "agent_name": "Renowned Real Estate - CRAIGIEBURN",
      "agent_phone": "0452060566",
      "price_value": 689000,
      "land_size_m2": 336,
      "listing_type": "buy",
      "published_at": "2026-04-20T08:30:00Z",
      "property_type": "House",
      "parking_spaces": 2,
      "building_size_m2": 195
    },
    {
      "id": "143029712",
      "url": "https://www.realestate.com.au/property-house-vic-wollert-143029712",
      "price": "$620,000 - $660,000",
      "images": [
        "https://i2.au.reastatic.net/800x600/b9c8d7e6f5a43210fedcba9876543210fedcba9876543210fedcba9876543210/image.jpg"
      ],
      "address": {
        "state": "VIC",
        "suburb": "Wollert",
        "postcode": "3750",
        "full_address": "12 Geary Avenue, Wollert, VIC 3750",
        "short_address": "12 Geary Avenue"
      },
      "bedrooms": 4,
      "features": [
        "Ducted heating",
        "Evaporative cooling",
        "Walk-in robe"
      ],
      "bathrooms": 2,
      "agent_name": "Carvera Property",
      "agent_phone": "0466229631",
      "price_value": 620000,
      "land_size_m2": 331,
      "listing_type": "buy",
      "published_at": "2026-04-18T10:00:00Z",
      "property_type": "House",
      "parking_spaces": 2,
      "building_size_m2": 195
    }
  ],
  "total_pages": 117,
  "total_results": 2341
}
```

### Search apartments for rent by postcode 3029

```json
{
  "page": 1,
  "results": [
    {
      "id": "143451923",
      "url": "https://www.realestate.com.au/property-apartment-vic-tarneit-143451923",
      "price": "$420/week",
      "images": [
        "https://i2.au.reastatic.net/800x600/e7f8a9b0c1d234567890fedcba9876543210fedcba9876543210fedcba987654/image.jpg"
      ],
      "address": {
        "state": "VIC",
        "suburb": "Tarneit",
        "postcode": "3029",
        "full_address": "5/14 Horizon Drive, Tarneit, VIC 3029",
        "short_address": "5/14 Horizon Drive"
      },
      "bedrooms": 2,
      "features": [
        "Built-in wardrobes",
        "Air conditioning"
      ],
      "bathrooms": 1,
      "agent_name": "Ray White - Werribee",
      "agent_phone": "0397413000",
      "price_value": 420,
      "land_size_m2": null,
      "listing_type": "rent",
      "published_at": "2026-04-21T07:00:00Z",
      "property_type": "Apartment",
      "parking_spaces": 1,
      "building_size_m2": 72
    }
  ],
  "total_pages": 5,
  "total_results": 87
}
```

## Documentation

## Overview
Realestate.com.au is Australia's largest property portal. Listings update daily. The site blocks automated data extraction. Piloterr returns structured search results as clean JSON with a single GET request.

## Quickstart
```
GET https://api.piloterr.com/v2/realestate/search?query=Tarneit+VIC&type=buy
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Suburb name, postcode, or suburb with state |
| `type` | string | no | Listing type: `buy`, `rent`, `sold` (default: `buy`) |
| `property_type` | string | no | Filter: `house`, `apartment`, `land` |
| `min_price` | integer | no | Minimum price in AUD |
| `max_price` | integer | no | Maximum price in AUD |
| `min_bedrooms` | integer | no | Minimum bedrooms |
| `min_bathrooms` | integer | no | Minimum bathrooms |
| `page` | integer | no | Page number |
| `per_page` | integer | no | Results per page (max: 50) |

## Main use cases
- Track median sale prices and days-on-market across Australian suburbs
- Monitor new listings in target postcodes for buyer alert applications
- Feed investment models with live price-per-m² data
- Aggregate listing volume by suburb to identify supply-side pressure
- Extract agent contact data at scale for CRM enrichment

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