# Realestate.com.au Search

Search Australian real estate listings by loading public realestate.com.au search pages through browser-orchestrator and extracting the embedded ArgonautExchange data. Supports buy, rent, and sold channels plus mapped URL filters such as price, bedrooms, bathrooms, parking, property types, keywords, pagination, and sorting.

- **Documentation:** [https://scrappa.co/docs/realestate-com-au-api/realestate_com_au_search](https://scrappa.co/docs/realestate-com-au-api/realestate_com_au_search)
- **API group:** Realestate.com.au API
- **Endpoint:** `GET https://scrappa.co/api/realestate-com-au/search`

## 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 |
| --- | --- | --- | --- |
| `location` | string | Yes | Location search text such as Sydney, NSW. |
| `channel` | string | No | Listing channel: buy, rent, or sold. |
| `page` | integer | No | Page number. |
| `sort` | string | No | realestate.com.au sort type, such as new-desc or sold-date-desc. |
| `min_price` | integer | No | Minimum price filter. |
| `max_price` | integer | No | Maximum price filter. |
| `min_bedrooms` | integer | No | Minimum bedroom count. |
| `max_bedrooms` | integer | No | Maximum bedroom count. |
| `min_bathrooms` | integer | No | Minimum bathroom count. |
| `min_carspaces` | integer | No | Minimum parking spaces. |
| `property_types` | string | No | Comma-separated realestate.com.au property type filters. |
| `keywords` | string | No | Comma-separated keyword filters. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/realestate-com-au/search?location=Sydney%2C+NSW&channel=buy&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "channel": "buy",
        "location": "Sydney, NSW",
        "total_results": 1,
        "listings": [
            {
                "id": "143160680",
                "url": "https://www.realestate.com.au/property-house-vic-tarneit-143160680",
                "property_type": "House",
                "price": "$650,000"
            }
        ]
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Request validation failed. |  |
| 503 | Realestate.com.au returned a challenge without parseable page data. |  |
| 503 | The upstream service is temporarily unavailable. Please retry shortly. |  |
| 503 | The upstream service is temporarily unavailable. Please retry shortly. |  |
| 503 | The upstream service is temporarily unavailable. Please retry shortly. |  |

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