# Realestateau Property (`websift/realestateau-property`) Actor Scrape Realestate.com.au property listings across Australia for sale, rent, and sold data. Filter by location, price, bedrooms, property type, features, inspections, auctions, and sale dates, then export clean property, agency, agent, media, and market data to Apify datasets. - **URL**: https://apify.com/websift/realestateau-property.md - **Developed by:** [Jacob](https://apify.com/websift) (community) - **Categories:** Automation, Developer tools, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.80 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Real Estate Australia Property Scraper Search Australian property listings and export clean, ready to use property data from Realestate.com.au. Use it to monitor listings, compare properties, build market reports, find rental opportunities, or analyze recently sold homes. ### Features - Search properties for sale, rent, or recently sold properties. - Filter by suburb, postcode, or another location name. - Set a maximum number of results and include surrounding suburbs when needed. - Filter by price, bedrooms, bathrooms, parking spaces, and land size. - Select property types such as houses, townhouses, apartments, land, villas, and rural properties. - Sort results by relevance, date, price, next inspection, or next auction. - Search for keywords and common indoor, outdoor, accessibility, climate-control, and energy features. - Apply search-type-specific filters: - Buy: sale method, new or established properties, properties with a displayed price, and properties under offer. - Rent: furnished properties, properties where pets are considered, availability date, affordable housing, and properties secured by a deposit. - Sold: maximum age of sold listings and listings with a displayed sale price. - Export normalized listing information, including property details, media, agency information, agents, inspections, auctions, rental availability, and sold dates where available. ### Input If no `searchType` is supplied, the actor searches properties for sale. If no `maxResults` is supplied, it returns up to 300 listings. ### Input Parameters | Parameter | Description | | --- | --- | | `location` | Suburb, postcode, or location name, such as `Panania NSW` or `2213`. | | `searchType` | `buy`, `rent`, or `sold`. | | `maxResults` | Maximum number of listings to return. Defaults to 300; values below 10 are raised to 10. | | `includeSurrounding` | Include listings from surrounding suburbs. | | `propertyTypes` | Intended property-type filter. Supported values include `house`, `townhouse`, `apartment & unit`, `villa`, `land`, `acreage`, `rural`, `retirement living`, and `block of units`; see the limitations before using this filter. | | `sortBy` | `featured`, `date (newest-oldest)`, `date (oldest-newest)`, `price (lowest-highest)`, `price (highest-lowest)`, `next inspection`, or `next auction`. | | `minPrice`, `maxPrice` | Minimum and maximum price filters. | | `minBeds`, `maxBeds` | Minimum and maximum bedroom filters. | | `numBaths` | Minimum number of bathrooms. | | `numParkingSpaces` | Minimum number of parking spaces. | | `keywords` | Array of words or phrases to search for. | | `minLandSize`, `maxLandSize` | Land-size range for buy and sold searches. | | `newOrEstablished` | Buy filter for new or established properties. | | `saleMethod` | Buy filter: `auction` or `private treaty sale`. | | `propertiesWithPrice` | Buy filter that keeps only listings with a displayed price. | | `excludeUnderOffer` | Buy filter that excludes properties under contract or offer. | | `propertyRequirements` | Rent filter: `furnished` or `pets considered`. The runtime currently accepts one value as a string. | | `availableBefore` | Rent filter for properties available before a date in `YYYY-MM-DD` format, such as `2026-08-02`. | | `excludeDepositTaken` | Rent filter that excludes properties secured by a deposit. | | `affordableHousing` | Rent filter for rental affordability schemes. | | `maxSoldAge` | Sold filter specifying the maximum listing age in months, up to 999 months. | | `excludeNoSalePrice` | Sold filter that keeps only listings with a sold price. | | `indoorFeatures` | Array containing values such as `ensuite`, `dishwasher`, `study`, `built in robes`, `alarm system`, `broadband`, `floorboards`, `gym`, `rumpus room`, or `workshop`. | | `outdoorFeatures` | Array containing values such as `swimming pool`, `garage`, `balcony`, `outdoor area`, `undercover parking`, `shed`, `fully fenced`, `outdoor spa`, or `tennis court`. | | `accessibilityFeatures` | Array containing values such as `single storey`, `step free entry`, `wide doorways`, `elevator`, `roll-in shower`, `bathroom grab rails`, or `accessible parking`. | | `climateControlAndEnergyFeatures` | Array containing values such as `air conditioning`, `solar panels`, `heating`, `fireplace`, `high energy efficiency`, `water tank`, or `solar hot water`. | Feature names and mapped filter values should be supplied in lowercase when using the API or raw JSON input. ### Output The actor stores one record per property in the default Apify dataset. Records include: - Property ID, URL, title, badge, type, description, and product depth. - Address broken into street, full address, suburb, state, and postcode. - Display price, property features, land size, and building size. - Main image, additional images, floorplans, virtual tours, and videos. - Listing agency details, rating, reviews, profile URL, logo, and associated agents. - Buy-specific inspection, auction, introduction, parent-property, and price information. - Rent-specific inspection times, availability date, bond, and build-to-rent information. - Sold-specific sale date and price disclaimer information. Fields that do not apply to a listing type may be empty or omitted. Property descriptions are returned as readable text rather than HTML. ### Example Usage #### Find homes to buy ```json { "location": "Panania NSW", "searchType": "buy", "maxResults": 50, "includeSurrounding": true, "minPrice": 700000, "maxPrice": 1200000, "minBeds": 3, "numParkingSpaces": 2, "sortBy": "price (lowest-highest)", "propertiesWithPrice": true } ```` #### Find rental properties ```json { "location": "Melbourne VIC", "searchType": "rent", "maxResults": 100, "maxPrice": 750, "minBeds": 2, "propertyRequirements": "pets considered", "outdoorFeatures": ["balcony"], "sortBy": "date (newest-oldest)" } ``` #### Review recently sold properties ```json { "location": "Brisbane QLD", "searchType": "sold", "maxResults": 100, "maxSoldAge": 12, "minLandSize": 400, "excludeNoSalePrice": true, "sortBy": "date (newest-oldest)" } ``` ### Limitations - Results depend on the availability and accuracy of listings on Realestate.com.au. - The actor processes at most 80 result pages (rea limit) and may return fewer records than requested when the search has fewer matching listings. - This actor does not perform full individual-listing scraping. ### Error Handling The actor validates common input types and keeps valid filters while ignoring invalid values. Price, bedroom, and land-size values are clamped to zero when appropriate, and sold-listing age is limited to 999 months. Search and parsing errors are logged with details. Because errors are handled inside the search operation, a failed request may result in an empty or partial dataset rather than a detailed error record. Check the actor run log when no results are returned. ### Support For issues, feature requests, or questions about this actor, please create an issue in the repository. # Actor input Schema ## `location` (type: `string`): Suburb, postcode, or location name to search (e.g. Panania NSW or 2213). ## `includeSurrounding` (type: `boolean`): Include surrounding suburbs in search results. ## `maxResults` (type: `integer`): The maximum number of property listings to return. ## `searchType` (type: `string`): Search type used for properties. ## `propertyType` (type: `array`): Property type used for filtering statistics. ## `sortBy` (type: `string`): Sorting method for property results. ## `minPrice` (type: `integer`): Minimum property price filter. ## `maxPrice` (type: `integer`): Maximum property price filter. ## `minBeds` (type: `integer`): Minimum number of bedrooms. ## `maxBeds` (type: `integer`): Maximum number of bedrooms. ## `numBaths` (type: `integer`): Minimum number of bathrooms. ## `numParkingSpaces` (type: `integer`): Minimum number of parking spaces. ## `keywords` (type: `array`): Keywords to add in search ## `minLandSize` (type: `integer`): Minimum land size filter. ## `maxLandSize` (type: `integer`): Maximum land size filter. ## `newOrEstablished` (type: `string`): Filter by new or established properties. ## `saleMethod` (type: `string`): Sale Method ## `propertiesWithPrice` (type: `boolean`): Only show properties with a price ## `excludeUnderOffer` (type: `boolean`): Exclude properties under contract/offer ## `propertyRequirements` (type: `array`): Property requirements ## `availableBefore` (type: `string`): Only include rental properties available before this date. ## `excludeDespositTaken` (type: `boolean`): Exclude properties secured by a deposit ## `affordableHousing` (type: `boolean`): This filter finds properties that are offered under rental affordability schemes. ## `maxSoldAge` (type: `integer`): Maximum age of sold listings in months. ## `excludeNoSalePrice` (type: `boolean`): Only show properties with a sold price ## `climateControlAndEnergyFeatures` (type: `array`): Select climate control and energy features. ## `indoorFeatures` (type: `array`): Select indoor features. ## `outdoorFeatures` (type: `array`): Select outdoor features. ## `accessibilityFeatures` (type: `array`): Select accessibility features. ## Actor input object example ```json { "maxResults": 300 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("websift/realestateau-property").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 = {} # Run the Actor and wait for it to finish run = client.actor("websift/realestateau-property").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 '{}' | apify call websift/realestateau-property --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=websift/realestateau-property", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Realestateau Property", "description": "Scrape Realestate.com.au property listings across Australia for sale, rent, and sold data. Filter by location, price, bedrooms, property type, features, inspections, auctions, and sale dates, then export clean property, agency, agent, media, and market data to Apify datasets.", "version": "0.0", "x-build-id": "Ol6XmPsDgfe65Pv2Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/websift~realestateau-property/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-websift-realestateau-property", "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/websift~realestateau-property/runs": { "post": { "operationId": "runs-sync-websift-realestateau-property", "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/websift~realestateau-property/run-sync": { "post": { "operationId": "run-sync-websift-realestateau-property", "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": "Suburb, postcode, or location name to search (e.g. Panania NSW or 2213)." }, "includeSurrounding": { "title": "Include Surrounding", "type": "boolean", "description": "Include surrounding suburbs in search results." }, "maxResults": { "title": "Maximum results", "type": "integer", "description": "The maximum number of property listings to return.", "default": 300 }, "searchType": { "title": "Search Type", "enum": [ "Buy", "Rent", "Sold" ], "type": "string", "description": "Search type used for properties." }, "propertyType": { "title": "Property Type", "type": "array", "description": "Property type used for filtering statistics.", "items": { "type": "string", "enum": [ "All Types", "Retirement Living", "House", "Land", "Townhouse", "Acreage", "Apartment & Unit", "Rural", "Villa", "Block Of Units" ] } }, "sortBy": { "title": "Sort By", "enum": [ "Featured", "Date (Newest-Oldest)", "Date (Oldest-Newest)", "Price (Lowest-Highest)", "Price (Highest-Lowest)", "Next Inspection", "Next Auction" ], "type": "string", "description": "Sorting method for property results." }, "minPrice": { "title": "Minimum Price", "type": "integer", "description": "Minimum property price filter." }, "maxPrice": { "title": "Maximum Price", "type": "integer", "description": "Maximum property price filter." }, "minBeds": { "title": "Minimum Beds", "type": "integer", "description": "Minimum number of bedrooms." }, "maxBeds": { "title": "Maximum Beds", "type": "integer", "description": "Maximum number of bedrooms." }, "numBaths": { "title": "Number of Baths", "type": "integer", "description": "Minimum number of bathrooms." }, "numParkingSpaces": { "title": "Number of Parking Spaces", "type": "integer", "description": "Minimum number of parking spaces." }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to add in search", "items": { "type": "string" } }, "minLandSize": { "title": "Minimum Land Size", "type": "integer", "description": "Minimum land size filter." }, "maxLandSize": { "title": "Maximum Land Size", "type": "integer", "description": "Maximum land size filter." }, "newOrEstablished": { "title": "New Or Established", "enum": [ "All Types", "New", "Established" ], "type": "string", "description": "Filter by new or established properties." }, "saleMethod": { "title": "Sale Method", "enum": [ "All Types", "Private treaty sale", "Auction" ], "type": "string", "description": "Sale Method" }, "propertiesWithPrice": { "title": "Only show properties with a price", "type": "boolean", "description": "Only show properties with a price" }, "excludeUnderOffer": { "title": "Exclude properties under contract/offer", "type": "boolean", "description": "Exclude properties under contract/offer" }, "propertyRequirements": { "title": "Property requirements", "type": "array", "description": "Property requirements", "items": { "type": "string", "enum": [ "Furnished", "Pets considered" ] } }, "availableBefore": { "title": "Available Before", "type": "string", "description": "Only include rental properties available before this date." }, "excludeDespositTaken": { "title": "Exclude properties secured by a deposit", "type": "boolean", "description": "Exclude properties secured by a deposit" }, "affordableHousing": { "title": "Affordable housing", "type": "boolean", "description": "This filter finds properties that are offered under rental affordability schemes." }, "maxSoldAge": { "title": "Maximum Sold Age (Months)", "type": "integer", "description": "Maximum age of sold listings in months." }, "excludeNoSalePrice": { "title": "Only show properties with a sold price", "type": "boolean", "description": "Only show properties with a sold price" }, "climateControlAndEnergyFeatures": { "title": "Climate Control And Energy Features", "type": "array", "description": "Select climate control and energy features.", "items": { "type": "string", "enum": [ "Air Conditioning", "Solar Panels", "Heating", "Fireplace", "High Energy Efficiency", "Water Tank", "Solar Hot Water" ] } }, "indoorFeatures": { "title": "Indoor Features", "type": "array", "description": "Select indoor features.", "items": { "type": "string", "enum": [ "Ensuite", "Dishwasher", "Study", "Built In Robes", "Alarm System", "Broadband", "Floorboards", "Gym", "Rumpus Room", "Workshop" ] } }, "outdoorFeatures": { "title": "Outdoor Features", "type": "array", "description": "Select outdoor features.", "items": { "type": "string", "enum": [ "Swimming Pool", "Garage", "Balcony", "Outdoor Area", "Undercover Parking", "Shed", "Fully Fenced", "Outdoor Spa", "Tennis Court" ] } }, "accessibilityFeatures": { "title": "Accessibility Features", "type": "array", "description": "Select accessibility features.", "items": { "type": "string", "enum": [ "Single Storey", "Step Free Entry", "Wide Doorways", "Elevator", "Roll-In Shower", "Bathroom Grab Rails", "Accessible Parking" ] } } } }, "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 } } } } } } } } } } ```