# Realestate.com.au Scraper - Real Estate Data for Australia (`igolaizola/realestate-au-scraper`)

Effortlessly scrape realestate.com.au for Australian property listings. Filter by location, buy/rent/sold, price, size, beds, baths, and property type. Track market trends, monitor new listings, generate leads, and export comprehensive JSON or CSV data for data-driven real estate insights.

- **URL**: https://beta-securitybyobscurity.apify.com/igolaizola/realestate-au-scraper.md
- **Developed by:** [Iñigo Garcia Olaizola](https://beta-securitybyobscurity.apify.com/igolaizola) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 14 total users, 13 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$19.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

## Realestate.com.au Scraper - Real Estate Data for Australia

### 🤖 What does Realestate.com.au Scraper do?

Realestate.com.au Scraper lets you seamlessly extract property listings from [realestate.com.au](https://www.realestate.com.au) for personal analysis, market research, or lead generation.

Depending on your needs, the scraper can collect:

- 🏠 Properties for sale (`buy`)
- 🏡 Properties for rent (`rent`)
- 📉 Recently sold properties (`sold`)

### 💡 Why scrape realestate.com.au?

[Realestate.com.au](https://www.realestate.com.au) is Australia's largest property portal, featuring hundreds of thousands of listings nationwide. By scraping its data, you can:

- 📈 Track price movements and market trends in specific suburbs or regions
- 🔍 Monitor new listings, auctions, and sales for real-time insights
- 🎯 Generate high-quality leads for agents, investors, and developers
- 🗺️ Analyze geographic distribution and amenities around listings

### 🚀 How to use Realestate.com.au Scraper

1. **Add the actor** – Sign in to Apify and add **Realestate.com.au Scraper** to your actors.
2. **Configure inputs** – Fill in the JSON input: set `maxItems`, `location`, `operation`, sorting, filters, etc.
3. **Run the actor** – Click **Run** to begin scraping.
4. **Retrieve results** – View or download your data from the **Dataset** tab when the run completes.

### 💳 Pricing

On the **Free plan**, Apify provides $5 of free usage credits per month. Small-scale tests (up to a few hundred items) often fit within this limit.

For heavier usage, consider upgrading:

- **Personal Plan ($49/month)**: Higher request quotas and parallel runs.
- **Business Plans**: Custom limits and enterprise-level support.

### 📝 Input Parameters

Supply these inputs in JSON format to control your scrape:

| Parameter              | Type    | Default     | Description                                                                                                                                                  |
| ---------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `maxItems`             | integer | `10`        | Maximum number of properties to scrape (minimum `1`).                                                                                                        |
| `location`             | string  |             | **Required.** Location to search (suburb, city, postcode, or region name).                                                                                   |
| `operation`            | string  | `buy`       | Operation type: `buy`, `rent`, or `sold`.                                                                                                                    |
| `sortBy`               | string  | `newest`    | Sort order: `featured`, `highPrice`, `lowPrice`, `newest`, `oldest`, `soldDate` (only for `sold`).                                                           |
| `surroundingSuburbs`   | boolean | `false`     | Include listings from surrounding suburbs.                                                                                                                   |
| `propertyTypes`        | array   |             | Filter by property types (leave empty for any). Options: `house`, `unit-apartment`, `townhouse`, `villa`, `land`, `acreage`, `rural`, `unitblock`, `retire`. |
| `minPrice`             | integer | `0`         | Minimum price (for rent: per week; 0 for any).                                                                                                               |
| `maxPrice`             | integer | `0`         | Maximum price (for rent: per week; 0 for any).                                                                                                               |
| `minSize`              | integer | `0`         | Minimum land or building size in m² (0 for any).                                                                                                             |
| `maxSize`              | integer | `0`         | Maximum size in m² (0 for any).                                                                                                                              |
| `minBeds`              | integer | `0`         | Minimum bedrooms (`-1` for studio, `0` for any).                                                                                                             |
| `maxBeds`              | integer | `0`         | Maximum bedrooms (`-1` for studio, `0` for any).                                                                                                             |
| `minBaths`             | integer | `0`         | Minimum bathrooms.                                                                                                                                           |
| `maxBaths`             | integer | `0`         | Maximum bathrooms.                                                                                                                                           |
| `minCars`              | integer | `0`         | Minimum car spaces.                                                                                                                                          |
| `keywords`             | array   |             | Keywords to match in description or title (e.g., `"pool"`, `"garden"`).                                                                                      |
| `excludeNoPrice`       | boolean | `false`     | **Buy/Sold only:** Exclude listings without a listed price.                                                                                                  |
| `constructionStatus`   | string  | `""`        | **Buy only:** Filter by status: `""` (Any), `established`, `new`.                                                                                            |
| `saleMethod`           | string  | `""`        | **Buy only:** Sale method: `""` (Any), `privateSale`, `auction`.                                                                                             |
| `excludeUnderContract` | boolean | `false`     | Exclude properties under contract or offer.                                                                                                                  |
| `furnished`            | boolean | `false`     | **Rent only:** Only include furnished properties.                                                                                                            |
| `petsAllowed`          | boolean | `false`     | **Rent only:** Only include pet-friendly listings.                                                                                                           |
| `excludeDeposit`       | boolean | `false`     | **Rent only:** Exclude properties secured by a deposit.                                                                                                      |
| `moveInDate`           | string  |             | **Rent only:** Desired move-in date (`YYYY-MM-DD`).                                                                                                          |
| `maxSoldAge`           | string  | `""`        | **Sold only:** Maximum age of sale: `""` (Any), `1m`, `3m`, `6m`, `12m`.                                                                                     |
| `proxyConfiguration`   | object  | Apify Proxy | Proxy settings: `useApifyProxy` (`true`/`false`), `apifyProxyGroups` (e.g., `["RESIDENTIAL"]`).                                                              |

#### Example input

````json
Here's an example JSON input configured for a **buy** operation:

```json
{
  "maxItems": 60,
  "location": "Melbourne, VIC",
  "operation": "buy",
  "sortBy": "highPrice",
  "surroundingSuburbs": true,
  "propertyTypes": [
    "house",
    "unit-apartment"
  ],
  "minPrice": 500000,
  "maxPrice": 1500000,
  "minSize": 100,
  "maxSize": 400,
  "minBeds": 3,
  "maxBeds": 5,
  "minBaths": 2,
  "maxBaths": 3,
  "minCars": 1,
  "keywords": [
    "pool",
    "garage"
  ],
  "excludeNoPrice": true,
  "constructionStatus": "established",
  "saleMethod": "auction",
  "excludeUnderContract": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
````

### 📊 Output

The actor returns an array of property objects in JSON. Each object typically includes:

- **\_links**: URLs for the listing page, map, agent contact, etc.
- **address**: `streetAddress`, `suburb`, `state`, `postcode`, `latitude`, `longitude`.
- **price**: Display and numeric values (or `"Contact Agent"`).
- **propertyType**, **channel** (`buy`/`rent`/`sold`), **status**.
- **features**: `bedrooms`, `bathrooms`, `parkingSpaces`, `landSize`.
- **agency** and **lister** details: name, phone, website, logo URLs.
- **images**: Array of photos and floorplans with server URIs and preview links.
- **description** and **title** of the listing.

Sample output fragment:

```json
[
  {
    "_links": {
      "prettyUrl": {
        "href": "https://www.realestate.com.au/property-residential%20land-nsw-austral-204270880"
      },
      "googleMap": {
        "templated": true,
        "href": "https://services.realestate.com.au/services/listings/204270880/map/static?width={width}\u0026height={height}\u0026scale={scale}"
      },
      "calculator": {
        "href": "https://api.realestate.com.au/calculator/buy"
      },
      "nearbySchools": {
        "templated": true,
        "href": "https://school-service.realestate.com.au/closest_by_type/?lat=-33.92607359\u0026lon=150.8192949{\u0026count}"
      },
      "adCall": {
        "templated": true,
        "href": "https://sasinator.realestate.com.au/rea/hserver/site=rea/area=buy.details/proptype=residentialland/constructionStatus=established/sub=austral/state=nsw/pcode=2179/platform={platform}/version={version}/pos={position}/size={size}/viewid={viewId}/random={random}"
      },
      "calculator-ipad": {
        "href": "https://api.realestate.com.au/calculator/buy_ipad"
      },
      "propertyValue": {
        "href": "https://www.propertyvalue.com.au/?reaid=204270880\u0026address=Lot%20110,%20122/50-60%20Thirteenth%20Avenue%20Austral%20NSW%202179"
      },
      "propertyFinanceUrl": {
        "templated": true,
        "href": "https://finance.realestate.com.au/products/cheapest_link{?search}"
      },
      "genericAdCall": {
        "templated": true,
        "href": "https://sasinator.realestate.com.au/rea/hserver/site=rea/area={area}/proptype=residentialland/constructionStatus=established/sub=austral/state=nsw/pcode=2179/platform={platform}/version={version}/pos={position}/size={size}/viewid={viewId}/random={random}"
      },
      "marketInfo": {
        "href": "https://investor-api.realestate.com.au/states/NSW/suburbs/Austral.json"
      },
      "short": {
        "href": "https://www.realestate.com.au/204270880"
      },
      "self": {
        "href": "https://services.realestate.com.au/services/listings/204270880"
      },
      "contactAgent": {
        "href": "https://agent-contact.realestate.com.au/contact-agent/listing/204270880"
      }
    },
    "address": {
      "streetAddress": "Lot 110, 122/50-60 Thirteenth Avenue",
      "locality": "Austral",
      "postcode": "2179",
      "suburb": "Austral",
      "postCode": "2179",
      "location": {
        "latitude": -33.92607359,
        "longitude": 150.8192949
      },
      "subdivisionCode": "NSW",
      "state": "NSW",
      "showAddress": true
    },
    "advertising": {
      "region": "south_western_sydney",
      "priceRange": "600k_750k"
    },
    "agency": {
      "website": "http://www.sapphire.com.au",
      "address": {
        "streetAddress": "210 Founders Avenue",
        "postcode": "2179",
        "suburb": "Leppington",
        "state": "NSW"
      },
      "phoneNumber": "1800 MY SAPPHIRE",
      "branded": false,
      "_links": {
        "agencyProfile": {
          "href": "https://www.realestate.com.au/agency/sapphire-estate-agents-south-west-group-KBZCEZ"
        },
        "agencyProfileWebview": {
          "href": "https://www.realestate.com.au/agency/sapphire-estate-agents-south-west-group-KBZCEZ?template=webview"
        }
      },
      "brandingColors": {
        "text": "#000000",
        "primary": "#f5e300"
      },
      "name": "Sapphire Estate Agents - South West Group",
      "logo": {
        "images": [
          {
            "server": "https://i3.au.reastatic.net",
            "name": "large",
            "uri": "/170x32/0e23d855f566cfa95a26605b7022a222b984277ab5af0b58dfdb1c2cc75bd823/logo.jpg"
          },
          {
            "server": "https://i3.au.reastatic.net",
            "name": "default",
            "uri": "/160x30/0e23d855f566cfa95a26605b7022a222b984277ab5af0b58dfdb1c2cc75bd823/logo.jpg"
          },
          {
            "server": "https://i3.au.reastatic.net",
            "name": "small",
            "uri": "/114x21/0e23d855f566cfa95a26605b7022a222b984277ab5af0b58dfdb1c2cc75bd823/logo.jpg"
          },
          {
            "server": "https://i3.au.reastatic.net",
            "name": "hero image",
            "uri": "/1536x800/8917c2df99e44cbbfa8727ddaaaa985ee19cc28b02a16669fa3876cd93e0dcbb/main.jpg"
          }
        ],
        "links": {
          "small": "/114x21/0e23d855f566cfa95a26605b7022a222b984277ab5af0b58dfdb1c2cc75bd823/logo.jpg",
          "hero image": "/1536x800/8917c2df99e44cbbfa8727ddaaaa985ee19cc28b02a16669fa3876cd93e0dcbb/main.jpg",
          "default": "/160x30/0e23d855f566cfa95a26605b7022a222b984277ab5af0b58dfdb1c2cc75bd823/logo.jpg",
          "large": "/170x32/0e23d855f566cfa95a26605b7022a222b984277ab5af0b58dfdb1c2cc75bd823/logo.jpg"
        }
      },
      "agencyId": "KBZCEZ",
      "email": "leppington@sapphire.com.au"
    },
    "agencyListingId": "1P6958",
    "calculator": {
      "_links": {
        "logoPng": {
          "href": "https://visualidentity.cachefly.net/realestate.com.au.calculators.vi.com.au/nab-branded/global/images/logo.png"
        },
        "logo": {
          "href": "https://visualidentity.cachefly.net/realestate.com.au.calculators.vi.com.au/nab-branded/global/images/logo.pdf"
        },
        "callToAction": {
          "href": "https://visualidentity.cachefly.net/realestate.com.au.calculators.vi.com.au/all-brands/au/com/vi/app/html/index.html?calculator=mortgage%20repayments\u0026sponsor=nab\u0026premiumProperty=false\u0026postcode=2179\u0026suburb=Austral\u0026state=NSW\u0026channel=buy\u0026displayPrice=Contact%20Agent"
        }
      },
      "brandingColors": {
        "text": "#000000",
        "primary": "#ffffff"
      },
      "subtitle": "Calculate repayments for this property",
      "title": "Mortgage Calculator"
    },
    "channel": "buy",
    "classicProject": false,
    "constructionStatus": "established",
    "description": "Abhi Chauhan from Sapphire Estate Agents proudly presents an unbeatable opportunity to secure a registered and ready-to-build block on Twelfth Avenue, Austral – one of South West Sydney's fastest-growing and most in-demand suburbs.\u003cbr/\u003e\u003cbr/\u003e🏡 Whether you're a first home buyer, investor, or builder – this 300m² block with 12.92 m frontage offers flexibility, affordability, and incredible future potential (STCA).\u003cbr/\u003e\u003cbr/\u003e🏷️ Property Highlights:\u003cbr/\u003e✅ Registered \u0026 Ready to Build\u003cbr/\u003e✅ Land Size: 300m² | Frontage: 12.92m | East-Facing\u003cbr/\u003e✅ Zoned R2 – Low Density Residential\u003cbr/\u003e✅ Flat, Clear Block – Ideal for Single or Double Storey Home\u003cbr/\u003e✅ Fantastic Value –$$$\u003cbr/\u003e\u003cbr/\u003e📍 Unbeatable Location:\u003cbr/\u003e📌 On Twelfth Avenue, Austral\u003cbr/\u003e📌 Short walk to public school \u0026 shops on Tenth Avenue\u003cbr/\u003e📌 Close to St. Anthony of Padua Catholic College\u003cbr/\u003e📌 Surrounded by parks, schools, and future infrastructure\u003cbr/\u003e📌 Future Woolworths Shopping Village nearby\u003cbr/\u003e📌 Easy access to M7 Motorway \u0026 Western Sydney Airport\u003cbr/\u003e📌 Minutes to Austral \u0026 Leppington Town Centres\u003cbr/\u003e\u003cbr/\u003eThis block is perfect for building your dream home or a strategic investment in a suburb experiencing rapid transformation and government-backed growth.",
    "featured": false,
    "features": {
      "general": {
        "bedrooms": 0,
        "bathrooms": 0,
        "parkingSpaces": 0
      }
    },
    "images": [
      {
        "server": "https://i3.au.reastatic.net",
        "name": "photo",
        "uri": "/ef56c3d9672efd078fb37b3c6d2a5625d1877a62b5a739d3397475247398c340/image.jpg",
        "preview": "https://i3.au.reastatic.net/800x600-resize,extend,r=33,g=40,b=46/ef56c3d9672efd078fb37b3c6d2a5625d1877a62b5a739d3397475247398c340/image.jpg"
      },
      {
        "server": "https://i3.au.reastatic.net",
        "name": "photo",
        "uri": "/f0cf7e3673d50b1146619bbb68e12e9e74da03184f53cc126a37f422192abcb5/image.jpg",
        "preview": "https://i3.au.reastatic.net/800x600-resize,extend,r=33,g=40,b=46/f0cf7e3673d50b1146619bbb68e12e9e74da03184f53cc126a37f422192abcb5/image.jpg"
      }
    ],
    "inspectionsAndAuctions": [],
    "isBuyChannel": true,
    "isExternalChildListing": false,
    "isInternalChildListing": false,
    "isLinkedExternalChildListing": false,
    "isRentChannel": false,
    "isSoldChannel": false,
    "landSize": {
      "displayAppAbbreviated": "322 m²",
      "displayApp": "322 m²",
      "unit": "m2",
      "value": 322,
      "display": "322 m\u0026sup2;"
    },
    "lister": {
      "mobilePhoneNumber": "0433933756",
      "website": "http://www.sapphire.com.au",
      "phoneNumber": "0433933756",
      "_links": {
        "agentProfile": {
          "href": "https://www.realestate.com.au/agent/3417444"
        },
        "agentProfileWebview": {
          "href": "https://www.realestate.com.au/agent/webview/3417444"
        }
      },
      "powerProfile": false,
      "jobTitle": "Licensed Real Estate Agent",
      "name": "Abhi Chauhan",
      "mainPhoto": {
        "server": "https://i3.au.reastatic.net",
        "name": "main photo",
        "uri": "/b8cad34112bb7a7cc7666caaebb9cc61ecec5c484fe99f1d67025c313777912b/main.jpg"
      },
      "id": "3417444",
      "email": "abhi.chauhan@sapphire.com.au,capture@sapphire.agentboxmail.com.au"
    },
    "listers": [
      {
        "mobilePhoneNumber": "0433933756",
        "website": "http://www.sapphire.com.au",
        "phoneNumber": "0433933756",
        "_links": {
          "agentProfile": {
            "href": "https://www.realestate.com.au/agent/3417444"
          },
          "agentProfileWebview": {
            "href": "https://www.realestate.com.au/agent/webview/3417444"
          }
        },
        "powerProfile": false,
        "jobTitle": "Licensed Real Estate Agent",
        "name": "Abhi Chauhan",
        "mainPhoto": {
          "server": "https://i3.au.reastatic.net",
          "name": "main photo",
          "uri": "/b8cad34112bb7a7cc7666caaebb9cc61ecec5c484fe99f1d67025c313777912b/main.jpg"
        },
        "id": "3417444",
        "email": "abhi.chauhan@sapphire.com.au,capture@sapphire.agentboxmail.com.au"
      }
    ],
    "listingId": "204270880",
    "mainImage": {
      "server": "https://i3.au.reastatic.net",
      "name": "main photo",
      "uri": "/e743eef5f3cc6fd8a8d45d80539849f048b216e90128ace76571945815585b1f/image.jpg",
      "preview": "https://i3.au.reastatic.net/800x600-resize,extend,r=33,g=40,b=46/e743eef5f3cc6fd8a8d45d80539849f048b216e90128ace76571945815585b1f/image.jpg"
    },
    "midtier": false,
    "modifiedDate": {
      "value": ""
    },
    "prettyUrl": "property-residential land-nsw-austral-204270880",
    "price": {
      "display": "Contact Agent"
    },
    "productDepth": "standard",
    "propertyType": "residential land",
    "showAgencyLogo": false,
    "signature": false,
    "signatureProject": false,
    "standard": true,
    "status": {
      "label": "New",
      "type": "new_listing"
    },
    "title": "Land Opportunity in Austral – Perfect for Your Dream Home!"
  }
  // ...more listings
]
```

### 🌍 Proxy Configuration

To avoid IP blocks and geographic restrictions, Apify Proxy is supported:

- **useApifyProxy**: Set to `true` to enable.
- **apifyProxyGroups**: Choose one or more groups, e.g., `["RESIDENTIAL"]`.

### ⚖️ Legal & Ethics

Web scraping may be subject to terms of service, intellectual property rights, and data privacy laws (such as the Australian Privacy Act). Ensure you have a legitimate purpose, respect robots.txt directives, and comply with realestate.com.au's policies. When in doubt, seek legal advice.

### 📜 Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by realestate.com.au Pty Limited (REA Group) or any of its subsidiaries.
All trademarks mentioned are the property of their respective owners.

# Actor input Schema

## `maxItems` (type: `integer`):

Maximum number of properties to scrape

## `location` (type: `string`):

Location to search for properties

## `operation` (type: `string`):

Operation type (buy, rent, sold)

## `sortBy` (type: `string`):

Sorting method for results

## `surroundingSuburbs` (type: `boolean`):

Include listings from surrounding suburbs

## `propertyTypes` (type: `array`):

Property types to search (house, unit apartment, townhouse, villa, land, acreage, rural, unitblock, retire)

## `minPrice` (type: `integer`):

Minimum price of the property (0 for any)

## `maxPrice` (type: `integer`):

Maximum price of the property (0 for any)

## `minSize` (type: `integer`):

Minimum size in square meters (0 for any)

## `maxSize` (type: `integer`):

Maximum size in square meters (0 for any)

## `minBeds` (type: `integer`):

Minimum number of bedrooms (-1 for studio, 0 for any)

## `maxBeds` (type: `integer`):

Maximum number of bedrooms (-1 for studio, 0 for any)

## `minBaths` (type: `integer`):

Minimum number of bathrooms

## `maxBaths` (type: `integer`):

Maximum number of bathrooms

## `minCars` (type: `integer`):

Minimum number of car spaces

## `keywords` (type: `array`):

Keywords to include in the search

## `excludeNoPrice` (type: `boolean`):

Exclude listings with no price

## `constructionStatus` (type: `string`):

Construction status

## `saleMethod` (type: `string`):

Sale method

## `excludeUnderContract` (type: `boolean`):

Exclude properties that are under contract

## `furnished` (type: `boolean`):

Only include furnished properties (rent operation only)

## `petsAllowed` (type: `boolean`):

Only include properties that allow pets

## `excludeDeposit` (type: `boolean`):

Exclude properties that are secured by a deposit

## `moveInDate` (type: `string`):

Desired move-in date (YYYY-MM-DD)

## `maxSoldAge` (type: `string`):

Maximum age of sold listings (sold operation only)

## `proxyConfiguration` (type: `object`):

Select proxies to be used.

## Actor input object example

```json
{
  "maxItems": 10,
  "location": "Sydney",
  "operation": "buy",
  "sortBy": "newest",
  "surroundingSuburbs": false,
  "minPrice": 0,
  "maxPrice": 0,
  "minSize": 0,
  "maxSize": 0,
  "minBeds": 0,
  "maxBeds": 0,
  "minBaths": 0,
  "maxBaths": 0,
  "minCars": 0,
  "excludeNoPrice": false,
  "constructionStatus": "",
  "saleMethod": "",
  "excludeUnderContract": false,
  "furnished": false,
  "petsAllowed": false,
  "excludeDeposit": false,
  "maxSoldAge": "",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "location": "Sydney",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("igolaizola/realestate-au-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "location": "Sydney",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("igolaizola/realestate-au-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "location": "Sydney",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call igolaizola/realestate-au-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=igolaizola/realestate-au-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Realestate.com.au Scraper - Real Estate Data for Australia",
        "description": "Effortlessly scrape realestate.com.au for Australian property listings. Filter by location, buy/rent/sold, price, size, beds, baths, and property type. Track market trends, monitor new listings, generate leads, and export comprehensive JSON or CSV data for data-driven real estate insights.",
        "version": "0.0",
        "x-build-id": "lFRLKDzsGSStcdTxh"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/igolaizola~realestate-au-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-igolaizola-realestate-au-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/igolaizola~realestate-au-scraper/runs": {
            "post": {
                "operationId": "runs-sync-igolaizola-realestate-au-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/igolaizola~realestate-au-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-igolaizola-realestate-au-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "maxItems",
                    "location"
                ],
                "properties": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of properties to scrape",
                        "default": 10
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Location to search for properties"
                    },
                    "operation": {
                        "title": "Operation",
                        "enum": [
                            "buy",
                            "rent",
                            "sold"
                        ],
                        "type": "string",
                        "description": "Operation type (buy, rent, sold)",
                        "default": "buy"
                    },
                    "sortBy": {
                        "title": "Sort by",
                        "enum": [
                            "featured",
                            "highPrice",
                            "lowPrice",
                            "newest",
                            "oldest",
                            "soldDate"
                        ],
                        "type": "string",
                        "description": "Sorting method for results",
                        "default": "newest"
                    },
                    "surroundingSuburbs": {
                        "title": "Include Surrounding Suburbs",
                        "type": "boolean",
                        "description": "Include listings from surrounding suburbs",
                        "default": false
                    },
                    "propertyTypes": {
                        "title": "Property Types (leave empty for any)",
                        "type": "array",
                        "description": "Property types to search (house, unit apartment, townhouse, villa, land, acreage, rural, unitblock, retire)",
                        "items": {
                            "type": "string",
                            "enum": [
                                "house",
                                "unit-apartment",
                                "townhouse",
                                "villa",
                                "land",
                                "acreage",
                                "rural",
                                "unitblock",
                                "retire"
                            ],
                            "enumTitles": [
                                "House",
                                "Apartment & Unit",
                                "Townhouse",
                                "Villa",
                                "Land",
                                "Acreage",
                                "Rural",
                                "Block of units",
                                "Retirement living"
                            ]
                        }
                    },
                    "minPrice": {
                        "title": "Min Price (price per week for rent)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum price of the property (0 for any)",
                        "default": 0
                    },
                    "maxPrice": {
                        "title": "Max Price (price per week for rent)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum price of the property (0 for any)",
                        "default": 0
                    },
                    "minSize": {
                        "title": "Min Size (m²)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum size in square meters (0 for any)",
                        "default": 0
                    },
                    "maxSize": {
                        "title": "Max Size (m²)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum size in square meters (0 for any)",
                        "default": 0
                    },
                    "minBeds": {
                        "title": "Min bedrooms",
                        "type": "integer",
                        "description": "Minimum number of bedrooms (-1 for studio, 0 for any)",
                        "default": 0
                    },
                    "maxBeds": {
                        "title": "Max bedrooms",
                        "type": "integer",
                        "description": "Maximum number of bedrooms (-1 for studio, 0 for any)",
                        "default": 0
                    },
                    "minBaths": {
                        "title": "Min bathrooms",
                        "type": "integer",
                        "description": "Minimum number of bathrooms",
                        "default": 0
                    },
                    "maxBaths": {
                        "title": "Max bathrooms",
                        "type": "integer",
                        "description": "Maximum number of bathrooms",
                        "default": 0
                    },
                    "minCars": {
                        "title": "Min car spaces",
                        "type": "integer",
                        "description": "Minimum number of car spaces",
                        "default": 0
                    },
                    "keywords": {
                        "title": "Keywords",
                        "type": "array",
                        "description": "Keywords to include in the search",
                        "items": {
                            "type": "string"
                        }
                    },
                    "excludeNoPrice": {
                        "title": "Only show properties with a price (only for buy and sold operations)",
                        "type": "boolean",
                        "description": "Exclude listings with no price",
                        "default": false
                    },
                    "constructionStatus": {
                        "title": "Construction status (only for buy operation)",
                        "enum": [
                            "",
                            "established",
                            "new"
                        ],
                        "type": "string",
                        "description": "Construction status",
                        "default": ""
                    },
                    "saleMethod": {
                        "title": "Sale method (only for buy operation)",
                        "enum": [
                            "",
                            "privateSale",
                            "auction"
                        ],
                        "type": "string",
                        "description": "Sale method",
                        "default": ""
                    },
                    "excludeUnderContract": {
                        "title": "Exclude properties under contract/offer",
                        "type": "boolean",
                        "description": "Exclude properties that are under contract",
                        "default": false
                    },
                    "furnished": {
                        "title": "Furnished (rent operation only)",
                        "type": "boolean",
                        "description": "Only include furnished properties (rent operation only)",
                        "default": false
                    },
                    "petsAllowed": {
                        "title": "Pets allowed (rent operation only)",
                        "type": "boolean",
                        "description": "Only include properties that allow pets",
                        "default": false
                    },
                    "excludeDeposit": {
                        "title": "Exclude properties secured by a deposit (rent operation only)",
                        "type": "boolean",
                        "description": "Exclude properties that are secured by a deposit",
                        "default": false
                    },
                    "moveInDate": {
                        "title": "Move in date (rent operation only)",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
                        "type": "string",
                        "description": "Desired move-in date (YYYY-MM-DD)"
                    },
                    "maxSoldAge": {
                        "title": "Max sold date (sold operation only)",
                        "enum": [
                            "",
                            "1m",
                            "3m",
                            "6m",
                            "12m"
                        ],
                        "type": "string",
                        "description": "Maximum age of sold listings (sold operation only)",
                        "default": ""
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
