# REIWA AU – WA Property, Agents, Commercial & Insights (`abotapi/reiwa-com-au-scraper`) Actor Collect Western Australia real estate data from REIWA.com.au across sale, rental, sold, agent, commercial, business, rural, and insights sections. Search by filters or scrape URLs, including result pages, listings, agents, agencies, and insight articles. Returns clean, structured records. - **URL**: https://apify.com/abotapi/reiwa-com-au-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 4 total users, 2 monthly users, 93.5% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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 ## REIWA WA Property Scraper Collect structured REIWA.com.au results across sale, rental, sold, agent, commercial, business, rural, and insights sections. The actor supports two clear modes: - Search by filters: choose a REIWA section, locations, price and bedroom filters, property types, sorting, and caps. - Scrape from URLs: paste REIWA result pages, listing pages, agent or agency pages, and insight article URLs. ### What You Get Each property row can include: - Listing URL and REIWA id - Section type - Title and address - Suburb - Price text and parsed price value when available - Bedrooms, bathrooms, and parking spaces - Property type - Agency name and agency URL - Agent names and profile URLs - Phone numbers when visible on the page - Listing date text, inspection text, or sold text where available - Image URLs - Full description and page title when detail fetching is enabled Agent rows can include: - Agent name - Profile URL - Agency name - Phone numbers when visible - Profile performance snippets such as listings sold, median days on market, and median sale price Insight rows can include: - Article title - Article URL - Date text - Summary ### Input Guide Use `mode` to choose how the run starts. Use `channel` in search mode: - `for-sale` - `for-rent` - `sold` - `agents` - `commercial-sale` - `commercial-lease` - `business` - `rural` - `insights` Use `locations` with REIWA slugs such as: - `perth~region` - `perth` - `baldivis` - `south-west~region` Use `propertyTypes` for supported property sections: - `houses` - `apartments` - `units` - `villas` - `townhouses` - `land` - `rural` Filters in the Output and filters group apply to both search mode and URL mode. For URL mode, the pasted URL is used first and the actor applies local keyword, price, bedroom, and property-type filters to returned rows where those fields are present. ### Example Inputs Sale listings in Perth: ```json { "mode": "search", "channel": "for-sale", "locations": ["perth~region"], "maxItems": 20, "fetchDetails": true } ```` Rental listings with price filter: ```json { "mode": "search", "channel": "for-rent", "locations": ["perth~region"], "minPrice": 500, "maxPrice": 800, "maxItems": 20 } ``` URL mode: ```json { "mode": "url", "urls": ["https://reiwa.com.au/commercial/for-sale/perth~region/"], "maxItems": 10 } ``` ### Limits `maxItems` is the main cap and defaults to 20. `maxPages` defaults to 0, which means no page cap. The actor still stops as soon as `maxItems` is reached. ### MCP Connector Export Select `mcpConnectors` to send a capped set of results into apps you already use. The dataset remains the source of truth, and connector export does not change saved rows. Supported connector server URLs: - `https://mcp.notion.com/mcp` - `https://mcp.linear.app/sse` - `https://mcp.airtable.com/mcp` - `https://mcp.apify.com` For Notion, set `notionParentPageUrl` so the actor knows where pages should be created. Use `maxNotifyListings` to limit how many rows each connector receives. ### Notes Keep Apify Proxy enabled for stable runs. Standard Apify Proxy was verified against sale, commercial, business, and agent result pages during creation. Large detail runs take longer because each saved row may load an additional REIWA page to add descriptions, photos, and visible contact fields. # Actor input Schema ## `mode` (type: `string`): search builds REIWA result pages from the fields below. url uses the REIWA URLs you paste. ## `channel` (type: `string`): Choose the result type for search mode. URL mode detects the section from each URL. ## `locations` (type: `array`): Search locations such as perth, perth~region, baldivis, or south-west~region. One search runs per location. Leave empty for all available results where the selected section supports it. ## `keywords` (type: `string`): Optional text matched against returned titles, addresses, agencies, descriptions, or article summaries. Applies to search and URL modes. ## `propertyTypes` (type: `array`): Optional listing type filters for listing sections. Applies to search and URL modes when supported by the source URL. ## `minPrice` (type: `integer`): Optional minimum price. For rentals this is weekly rent. ## `maxPrice` (type: `integer`): Optional maximum price. For rentals this is weekly rent. ## `minBedrooms` (type: `integer`): Optional minimum bedrooms. ## `sortBy` (type: `string`): Ordering for result pages that support sorting. ## `urls` (type: `array`): Only used when mode = url. Paste search/list pages, individual listings, agent profiles, agency profiles, or insight articles. Multiple URLs are supported. ## `fetchDetails` (type: `boolean`): Adds full descriptions, extra photos, page metadata, and richer contact/profile fields when available. ## `maxItems` (type: `integer`): Hard cap across the whole run. The actor stops once this many rows are saved. ## `maxPages` (type: `integer`): 0 means no page limit. Use Max items as the primary cap. ## `proxy` (type: `object`): Residential proxy is recommended for the highest reliability. On the Apify Free plan (no Residential access) the Actor automatically falls back to a backup proxy pool. Add a country only if you need a specific geography. ## `mcpConnectors` (type: `array`): Send the scraped results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify Settings, then select it here. The complete record stays in the dataset. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL or id of the Notion page under which item pages are created. Required for Notion export and ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each selected connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "channel": "for-sale", "locations": [ "perth~region" ], "keywords": "", "propertyTypes": [], "sortBy": "default", "urls": [ "https://reiwa.com.au/for-sale/perth~region/" ], "fetchDetails": false, "maxItems": 20, "maxPages": 0, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (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 = { "mode": "search", "channel": "for-sale", "locations": [ "perth~region" ], "urls": [ "https://reiwa.com.au/for-sale/perth~region/" ], "maxItems": 20, "maxPages": 0, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/reiwa-com-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "channel": "for-sale", "locations": ["perth~region"], "urls": ["https://reiwa.com.au/for-sale/perth~region/"], "maxItems": 20, "maxPages": 0, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/reiwa-com-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 '{ "mode": "search", "channel": "for-sale", "locations": [ "perth~region" ], "urls": [ "https://reiwa.com.au/for-sale/perth~region/" ], "maxItems": 20, "maxPages": 0, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call abotapi/reiwa-com-au-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/reiwa-com-au-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "REIWA AU – WA Property, Agents, Commercial & Insights", "description": "Collect Western Australia real estate data from REIWA.com.au across sale, rental, sold, agent, commercial, business, rural, and insights sections. Search by filters or scrape URLs, including result pages, listings, agents, agencies, and insight articles. Returns clean, structured records.", "version": "0.1", "x-build-id": "PI4H5WyWf5UfLJuDo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~reiwa-com-au-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-reiwa-com-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/abotapi~reiwa-com-au-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-reiwa-com-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/abotapi~reiwa-com-au-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-reiwa-com-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "search builds REIWA result pages from the fields below. url uses the REIWA URLs you paste.", "default": "search" }, "channel": { "title": "REIWA section", "enum": [ "for-sale", "for-rent", "sold", "agents", "commercial-sale", "commercial-lease", "business", "rural", "insights" ], "type": "string", "description": "Choose the result type for search mode. URL mode detects the section from each URL.", "default": "for-sale" }, "locations": { "title": "Suburbs or regions", "type": "array", "description": "Search locations such as perth, perth~region, baldivis, or south-west~region. One search runs per location. Leave empty for all available results where the selected section supports it.", "default": [ "perth~region" ], "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "string", "description": "Optional text matched against returned titles, addresses, agencies, descriptions, or article summaries. Applies to search and URL modes.", "default": "" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Optional listing type filters for listing sections. Applies to search and URL modes when supported by the source URL.", "items": { "type": "string", "enum": [ "houses", "apartments", "units", "villas", "townhouses", "land", "rural" ], "enumTitles": [ "Houses", "Apartments", "Units", "Villas", "Townhouses", "Land", "Rural" ] }, "default": [] }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Optional minimum price. For rentals this is weekly rent." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Optional maximum price. For rentals this is weekly rent." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "type": "integer", "description": "Optional minimum bedrooms." }, "sortBy": { "title": "Sort order", "enum": [ "default", "date-desc", "date-asc", "price-asc", "price-desc" ], "type": "string", "description": "Ordering for result pages that support sorting.", "default": "default" }, "urls": { "title": "REIWA URLs", "type": "array", "description": "Only used when mode = url. Paste search/list pages, individual listings, agent profiles, agency profiles, or insight articles. Multiple URLs are supported.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch details", "type": "boolean", "description": "Adds full descriptions, extra photos, page metadata, and richer contact/profile fields when available.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap across the whole run. The actor stops once this many rows are saved.", "default": 20 }, "maxPages": { "title": "Max pages per search", "minimum": 0, "maximum": 5000, "type": "integer", "description": "0 means no page limit. Use Max items as the primary cap.", "default": 0 }, "proxy": { "title": "Proxy", "type": "object", "description": "Residential proxy is recommended for the highest reliability. On the Apify Free plan (no Residential access) the Actor automatically falls back to a backup proxy pool. Add a country only if you need a specific geography.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "mcpConnectors": { "title": "Pipe results into your apps", "type": "array", "description": "Send the scraped results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify Settings, then select it here. The complete record stays in the dataset. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required for Notion export and ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each selected connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } } ```