# realestate.com.au API Scraper (`rl1987/realestateau-api-scraper`) Actor Scrape realestate.com.au property listings (buy/rent/sold) by location via the official mobile API: search, filters, pagination, full listing detail incl. all media, features, agent & agency contact, geo and the full raw response. - **URL**: https://apify.com/rl1987/realestateau-api-scraper.md - **Developed by:** [R.L.](https://apify.com/rl1987) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 listings This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README **Scrape realestate.com.au property listings** — for sale, for rent, or sold — straight from the site's own private mobile API. Get full addresses, prices, geo-coordinates, all photos, floorplans, agent and agency contact details, and inspection times for any suburb or region in Australia, without HTML parsing or CAPTCHA fights. Just enter a location (e.g. "Richmond, VIC 3121" or "Bondi Beach") and run. Because this Actor talks to the same GraphQL API that powers the [realestate.com.au](https://www.realestate.com.au/) app instead of scraping rendered HTML, it returns clean, complete, structured data on every run — no broken CSS selectors, no missing fields when the site's frontend changes. Run it on demand, on a [schedule](https://docs.apify.com/platform/schedules), or wire it into your stack via the [Apify API](https://docs.apify.com/api/v2) and integrations for [Make, Zapier, Google Sheets, Slack and more](https://apify.com/integrations). ### Why use this realestate.com.au scraper? Whether you're building a property portal, feeding a CRM, or tracking a market, this Actor turns realestate.com.au into structured data you can act on: - **Real estate agents & agencies** — pull competitor listings, prices, and agent contact details to prospect for new business. - **Buyers' agents & investors** — monitor new listings and price movements across suburbs, filtered by beds/baths/price/parking. - **Proptech & data teams** — feed listing data into valuation models, market dashboards, or lead-gen pipelines. - **Researchers & journalists** — track sold prices and market trends over time. - **Developers** — get accurate geo-coordinates and full media galleries for mapping and visualization projects. ### How to scrape realestate.com.au listings 1. Click **Try for free**. 2. Enter a **Location** — a suburb, postcode, or region (e.g. `Bondi Beach`, `Perth`, `Richmond, VIC 3121`). 3. Pick a **Channel**: Buy, Rent, or Sold. 4. Optionally set filters — price range, minimum beds/baths/car spaces, and whether to include surrounding suburbs. 5. Click **Start** and download your results as JSON, CSV, Excel, or HTML once the run finishes. No coding required, but everything above is also available as JSON input via the [Apify API](https://docs.apify.com/api/v2) if you want to trigger runs programmatically. ### Input Configure the run from the **Input** tab in Apify Console, or pass the equivalent JSON via the API: | Field | Description | |---|---| | `location` | Suburb, postcode, or region to search, e.g. `"Richmond, VIC 3121"`. | | `channel` | `buy`, `rent`, or `sold`. | | `maxItems` | Cap on listings returned (`0` = no limit, fetch every result). | | `priceMin` / `priceMax` | Price range filter. | | `bedroomsMin` / `bathroomsMin` / `carsMin` | Minimum beds / baths / car spaces. | | `surroundingSuburbs` | Also include listings in neighboring suburbs. | | `includeDetails` | Fetch full listing detail (all photos, description, features, agent & agency contact). Turn off for a faster, cheaper, address-and-price-only run. | | `proxyConfiguration` | Proxy settings. Defaults to Apify's **Residential (AU)** proxy group, which is required — realestate.com.au blocks datacenter IPs. | Example input: ```json { "location": "Richmond, VIC 3121", "channel": "buy", "maxItems": 100, "bedroomsMin": 2, "includeDetails": true } ```` ### Output Each result is one property listing, pushed to a dataset item. Example (trimmed): ```json { "id": "149601712", "channel": "buy", "listingStatus": "For sale", "propertyType": "House", "priceDisplay": "Expressions of Interest $1,650,000 - $1,750,000", "bedrooms": "3", "bathrooms": "2", "parkingSpaces": "2", "fullAddress": "49 Fraser Street, Richmond, VIC 3121", "suburb": "Richmond", "state": "VIC", "postcode": "3121", "latitude": -37.821309, "longitude": 145.006256, "title": "Timeless family residence with beautiful light and impressive space", "description": "Expressions of Interest\n\nBehind a timeless façade, this freestanding three-bedroom, two-bathroom home offers exceptional comfort...", "propertyFeatures": ["Open car spaces: 2"], "images": [ "https://i2.au.reastatic.net/1144x888/5cc8.../image.jpg", "https://i2.au.reastatic.net/1144x888/e6d1.../image.jpg" ], "agencyId": "XFGDKV", "agencyName": "Jellis Craig - Richmond", "agencyAddress": "57-59 Bridge Rd, Richmond, VIC, 3121", "agents": [ { "name": "Jenny Dwyer", "phone": "0400123456", "photo": "https://...", "profileUrl": "https://..." } ], "inspections": [], "url": "https://www.realestate.com.au/property-house-vic-richmond-149601712" } ``` You can download the dataset in various formats such as JSON, HTML, CSV, or Excel from the **Output** tab, or pull it via the [Dataset API](https://docs.apify.com/api/v2#/reference/datasets). #### Data table | Field | Description | |---|---| | `id` | realestate.com.au listing ID. | | `channel` | `buy`, `rent`, or `sold`. | | `listingStatus` | e.g. "For sale", "Under offer", "New development". | | `propertyType` | House, Apartment, Townhouse, etc. | | `priceDisplay` | Price as displayed on the listing (asking price, rent, or auction guide). | | `bedrooms` / `bathrooms` / `parkingSpaces` / `studies` | General features. | | `landSize` | Land area, when listed. | | `fullAddress` / `suburb` / `state` / `postcode` | Address components. | | `latitude` / `longitude` | Geo-coordinates. | | `title` / `description` | Listing headline and full description. | | `propertyFeatures` | List of feature tags (pool, air conditioning, etc.). | | `images` | Full-resolution photo URLs. | | `agencyName` / `agencyAddress` | Listing agency. | | `agents` | Agent name, phone, photo, and profile URL. | | `inspections` | Scheduled inspection times, when available. | | `url` | Canonical realestate.com.au listing URL. | Listings that are missing the fields needed to build a valid `url` (rare, mostly incomplete new-development placeholders) are skipped rather than pushed with a broken link. ### Pricing This Actor uses [pay-per-event pricing](https://docs.apify.com/platform/actors/publishing/monetize#pay-per-event-pricing-model): - **$1 per 1,000 listings** — charged for every listing returned (address, price, images, agent — the shallow data). - **+$0.50 per 1,000 listings** with full detail — charged only when `includeDetails` is on, for the extra description, feature list, and agency data. Turn `includeDetails` off for address/price/geo-only runs at half the cost. Apify's [free tier](https://apify.com/pricing) gives you monthly platform credit to try the Actor before committing to a paid plan. ### Tips for optimizing your runs - Set `maxItems` to the number of listings you actually need — the Actor stops as soon as it hits the cap, saving compute and event charges. - Turn off `includeDetails` if you only need address, price, and coordinates — this roughly halves the per-listing cost and speeds up the run. - Narrow the search with `priceMin`/`priceMax` and `bedroomsMin`/`bathroomsMin`/`carsMin` instead of filtering client-side — fewer irrelevant listings fetched means a faster, cheaper run. - Use `sold` as the channel to track historical sale prices for market analysis instead of scraping current listings repeatedly. - Schedule recurring runs (daily/weekly) via [Apify Schedules](https://docs.apify.com/platform/schedules) to track new listings or price changes in a suburb over time. ### FAQ **Is it legal to scrape realestate.com.au?** This Actor only collects publicly available listing data. You are responsible for using the data in compliance with realestate.com.au's terms of service and applicable law (e.g. not republishing agent contact details for unsolicited marketing). This Actor is not affiliated with, endorsed by, or connected to REA Group or realestate.com.au. **Why does it need a residential proxy?** realestate.com.au's edge (Akamai) blocks datacenter IP ranges by reputation. The Actor defaults to Apify's Residential (AU) proxy group, which is required for reliable results. **Some listings are missing beds/baths/price.** New-development and off-market listings often don't expose every field through the app's API the way standard resale listings do — the Actor returns `null` for fields that genuinely aren't present rather than guessing. **Found a bug or have a feature request?** Open an issue on the Actor's **Issues** tab in Apify Console. For custom scraping solutions or private modifications, reach out via the **Actor detail page**. # Actor input Schema ## `location` (type: `string`): Human location to search, e.g. 'Richmond, VIC 3121', 'Bondi Beach', 'Perth'. Resolved to the exact locality via realestate.com.au's own mobile suggest API. ## `maxItems` (type: `integer`): Maximum listings to return (0 = all pages). ## `priceMin` (type: `integer`): Minimum price filter. ## `priceMax` (type: `integer`): Maximum price filter. ## `bedroomsMin` (type: `integer`): Minimum bedrooms. ## `bathroomsMin` (type: `integer`): Minimum bathrooms. ## `carsMin` (type: `integer`): Minimum car spaces. ## `surroundingSuburbs` (type: `boolean`): Include listings in surrounding suburbs. ## `includeDetails` (type: `boolean`): Fetch the full property detail (media, features, description, agent & agency contact) for each listing. Costs an extra per-listing charge — turn off for a faster, lighter, cheaper run. ## `channel` (type: `string`): Buy, rent or sold listings. ## `proxyConfiguration` (type: `object`): Route requests through a proxy. realestate.com.au's Akamai edge blocks datacenter IPs by reputation, so a residential/ISP proxy (Australia) is required. ## `proxyUrl` (type: `string`): Optional. A residential/ISP proxy URL (http://user:pass@host:port) used verbatim; overrides the proxy configuration above. Must allow POST. ## Actor input object example ```json { "location": "Richmond, VIC 3121", "maxItems": 20, "surroundingSuburbs": false, "includeDetails": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": "Richmond, VIC 3121", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }; // Run the Actor and wait for it to finish const run = await client.actor("rl1987/realestateau-api-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": "Richmond, VIC 3121", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AU", }, } # Run the Actor and wait for it to finish run = client.actor("rl1987/realestateau-api-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": "Richmond, VIC 3121", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }' | apify call rl1987/realestateau-api-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rl1987/realestateau-api-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "realestate.com.au API Scraper", "description": "Scrape realestate.com.au property listings (buy/rent/sold) by location via the official mobile API: search, filters, pagination, full listing detail incl. all media, features, agent & agency contact, geo and the full raw response.", "version": "0.0", "x-build-id": "y498WGuQ5N8UzGe3K" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rl1987~realestateau-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rl1987-realestateau-api-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/rl1987~realestateau-api-scraper/runs": { "post": { "operationId": "runs-sync-rl1987-realestateau-api-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/rl1987~realestateau-api-scraper/run-sync": { "post": { "operationId": "run-sync-rl1987-realestateau-api-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", "properties": { "location": { "title": "Location", "type": "string", "description": "Human location to search, e.g. 'Richmond, VIC 3121', 'Bondi Beach', 'Perth'. Resolved to the exact locality via realestate.com.au's own mobile suggest API." }, "maxItems": { "title": "Max listings", "type": "integer", "description": "Maximum listings to return (0 = all pages).", "default": 20 }, "priceMin": { "title": "Min price", "type": "integer", "description": "Minimum price filter." }, "priceMax": { "title": "Max price", "type": "integer", "description": "Maximum price filter." }, "bedroomsMin": { "title": "Min bedrooms", "type": "integer", "description": "Minimum bedrooms." }, "bathroomsMin": { "title": "Min bathrooms", "type": "integer", "description": "Minimum bathrooms." }, "carsMin": { "title": "Min car spaces", "type": "integer", "description": "Minimum car spaces." }, "surroundingSuburbs": { "title": "Include surrounding suburbs", "type": "boolean", "description": "Include listings in surrounding suburbs.", "default": false }, "includeDetails": { "title": "Fetch full detail", "type": "boolean", "description": "Fetch the full property detail (media, features, description, agent & agency contact) for each listing. Costs an extra per-listing charge — turn off for a faster, lighter, cheaper run.", "default": true }, "channel": { "title": "Channel", "enum": [ "buy", "rent", "sold" ], "type": "string", "description": "Buy, rent or sold listings." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Route requests through a proxy. realestate.com.au's Akamai edge blocks datacenter IPs by reputation, so a residential/ISP proxy (Australia) is required.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "AU" } }, "proxyUrl": { "title": "Direct proxy URL (advanced)", "type": "string", "description": "Optional. A residential/ISP proxy URL (http://user:pass@host:port) used verbatim; overrides the proxy configuration above. Must allow POST." } } }, "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 } } } } } } } } } } ```