| name | reiwa |
| description | Search and fetch WA property listings from REIWA (Real Estate Institute of Western Australia). Use when the user needs for-sale or sold listings by location/price/type, or full property details (images, features, description, stats). |
| compatibility | Requires Python 3, curl. |
REIWA skill
This skill provides CLI tools to search and fetch property listings from REIWA (Real Estate Institute of Western Australia). Use it to discover locations, list for-sale or sold properties by area/price/type, and fetch full details for specific listings.
Available scripts
scripts/location_search.py - Search locations (suburbs/regions) by term and listing category. Use the returned value as -l / --location in for_sale / sold.scripts/for_sale.py - Fetch for-sale listings for one or more locations with optional filters (property type, price range, sort).scripts/sold.py - Same as for_sale but for sold listings. Accepts multiple --location values.scripts/property_details.py - Fetch full details for one or more listings by slug.
Each script supports --help (or -h). Use it to list all options and defaults.
Output is always JSON-formatted, use jq accordingly.
Location value search
python3 scripts/location_search.py North --category for-sale
Returns: One JSON object per line (JSONL). Each line:
{"group": "Suburb", "name": "North Baandee", "value": "North Baandee"}
{"group": "Suburb", "name": "North Bannister", "value": "North Bannister"}
{"group": "Region", "name": "Perth - North East", "value": "Perth - North East-sub-region"}
The group is typically one of Region, Suburb, Street, Address.
Use the value as --location / -l in for_sale / sold.Address.
Other examples:
python3 scripts/location_search.py Perth | jq -c 'select(.group == "Region") | .value'
python3 scripts/location_search.py Northbridge --category sold | jq -c 'select(.group == "Suburb") | .value'
Properties for sale
python3 scripts/for_sale.py --location "northbridge" --limit 10
Returns: A single JSON object:
{
"total": 42,
"next_page": 2,
"items": [
{
"slug": "12-smith-street-northbridge-1234567",
"listing_id": 1234567,
"listing_no": 6789012,
"listing_status": "Available",
"property_type": "House",
"address": "12 Smith Street, Northbridge",
"suburb": "Northbridge",
"latitude": -31.95,
"longitude": 115.86,
"display_price": "From $950,000",
"bedrooms": 3,
"bathrooms": 2,
"land_area": 450,
"land_area_unit": "m²",
"carspaces": 1,
"property_details_url": "https://reiwa.com.au/12-smith-street-northbridge-1234567/",
"listing_price_type": "Fixed",
"main_image_url": "https://imagecdn.reiwa.com.au/listing/...",
"list_price": 950000
}
]
}
Other examples:
python3 scripts/for_sale.py --location "northbridge" --p House --p Appartment --sort-by listprice
python3 scripts/for_sale.py -l "northbridge" -l "perth" --property-type Unit --max-price 450000
python3 scripts/for_sale.py -l "mount lawley" --property-type Unit --min-beds 2
Any of the item fields may be null. next_page is null when there is no next page, or when --limit was used.
Properties sold
python3 scripts/sold.py --location "perth" --max-price 1000000 --page 1
Returns: A single JSON object:
{
"total": 42,
"next_page": 2,
"items": [
{
"slug": "12-smith-street-northbridge-1234567",
"listing_id": 1234567,
"listing_no": 6789012,
"listing_status": "Available",
"property_type": "House",
"address": "12 Smith Street, Northbridge",
"suburb": "Northbridge",
"latitude": -31.95,
"longitude": 115.86,
"display_price": "From $950,000",
"display_sold_date": "13 Mar 2026",
"bedrooms": 3,
"bathrooms": 2,
"land_area": 450,
"land_area_unit": "m²",
"carspaces": 1,
"property_details_url": "https://reiwa.com.au/12-smith-street-northbridge-1234567/",
"listing_price_type": "Fixed",
"main_image_url": "https://imagecdn.reiwa.com.au/listing/...",
"list_price": 950000
}
]
}
Any of the item fields may be null. next_page is null when there is no next page, or when --limit was used.
Other examples:
python3 scripts/sold.py -l "perth" -l "fremantle" --min-price 500000 --max-price 1000000 --limit 10
python3 scripts/sold.py -l "perth" -p House -p "Townhouse" --limit 5 --max-beds 3
python3 scripts/sold.py -l "perth" -p House --limit 3 --sort-by listprice --sort-asc | jq '.items[] | .display_price'
Property (or properties) details
python3 scripts/property_details.py 12-smith-street-northbridge-1234567
python3 scripts/property_details.py 12-smith-street-northbridge-1234567 88-jones-ave-subiaco-7654321
Returns: One JSON object per line (JSONL). Each line:
{
"listing_id": 1234567,
"listing_no": 6789012,
"listing_category": "ForSale",
"is_sold": true,
"property_category": "Residential",
"property_type": "House",
"address": "1 Dulwich Street, Beckenham",
"suburb": "Beckenham",
"postcode": "6107",
"latitude": -31.95,
"longitude": 115.86,
"full_address": "1 Dulwich Street, Beckenham WA 6107",
"street_address_text": "1 Dulwich Street",
"display_price": "Listed price: From $950,000",
"list_price": 950000,
"listing_price_type": "Fixed",
"bedrooms": 3,
"bathrooms": 2,
"carspaces": 1,
"land_size": "910m²",
"property_details_url": "https://reiwa.com.au/1-dulwich-street-beckenham-1234567/",
"main_image_url": "https://imagecdn.reiwa.com.au/listing/...",
"images": ["https://imagecdn.reiwa.com.au/listing/...", "..."],
"features": "- Air conditioned\n- **Carports**: 1\n- **Floor area**: 119m²",
"headline": "1 Dulwich Street Beckenham",
"headline_address": "1 Dulwich Street, Beckenham WA 6107",
"description": "Step into this stunning...",
"list_date": "2026-01-14T00:00:00+08:00",
"sold_date": "2026-03-13T00:00:00+08:00",
"sold_date_string": "1 Mar 2026",
"stats_total_views": 13442,
"stats_search_result_views": 12976,
"stats_property_page_views": 466
}
Most fields can be null. features is a markdown list. description is markdown-converted from HTML.
