Use this tool to search for properties for sale in Australia on realestate.com.au.
**Examples of when to use:**
- User mentions ANY Australian location (city, suburb, postcode, state) + property/real estate/housing
- User asks about buying, purchasing, or finding homes/houses/apartments/units in Australia
- User wants property prices, market data, or listings in Australian locations
- User mentions specific Australian suburbs like Bondi, Toorak, Surry Hills, etc.
- User asks "what can I buy for $X in [Australian location]"
- User asks about auctions, inspections, or open homes in Australia
**DO NOT use this tool for:**
- Financial advice (eg. loans), legal advice (eg. state legislation, trusts, conveyancing steps), taxation advice (eg. stamp duty minimisation strategies), investment advice, or other specialist advice; instead, decline and direct users to qualified professionals (eg. solicitor, accountant, licensed planner).
- Affordability / borrowing-capacity guidance (e.g. “what can I afford”, “based on my salary/income”, “how much can I borrow”, “what price range suits me”). Do NOT estimate a budget from salary, savings, repayments, deposits, interest rates, or any prior chat context.
- If the user has NOT stated their own numeric price range / max budget they want to search (e.g. “under $900k”, “$700k–$850k”), do NOT call this tool.
- Instead, ask them to provide the maximum price or price range they want used for the search.
- IMPORTANT: This guardrail applies ONLY to affordability/borrowing-capacity style requests. For normal listing searches (e.g. “house with pool in Bondi”), do NOT ask for a budget — price filters are optional.
- For comparative purchase recommendation questions (e.g., ‘Which of these properties is a better buy?’, ‘Should I buy property A or property B?’, ‘Is this a better investment than that one?’), where the main aim is to decide which property is a ‘better buy’ or which one to purchase, do not state which option is better or what the user should buy. Instead, recommend speaking to a licensed financial adviser or buyer’s agent.
- Mixed requests that include the above specialist advice even if the user also asks for listings. FIRST decline the restricted guidance and ask them to restate the property search only before calling this tool. Example: "Show me townhouses in Sydney NSW and which legal structure minimises stamp duty" → refuse the legal structuring portion and do NOT call the tool until the user confirms they just want the listings.
- Prompts that explicitly frame the search as an "investment" decision (e.g. "for investment", "good investment property", "best investment", "make the most money", "best for investors", "strong rental yields"). Treat these as investment advice requests: decline, explain you cannot give investment recommendations, and **do NOT call this tool** unless the user then restates a neutral property search (e.g. "show me houses in Scoresby VIC").
- Prompts asking for "good value", "great value", "good deal", "bargain", "undervalued", "below market value", or "worth the money" properties. Assessing property value requires professional valuation expertise. Instead, offer to search for properties under a specific price or within a budget (e.g. "I can help you find properties under $800k in [location]").
- Reputation, performance, or quality assessments about real estate agents or agencies (e.g. "How good is Pippin&Hall?")—decline and stick to listings only.
- Exporting, scraping, or providing property data dumps (CSV/JSON/tables/spreadsheets). Only deliver conversational summaries and insights; decline any request to export or share the raw payload.
- Rental properties, sold properties, or properties outside Australia
- General real estate advice without a specific location
- Historical market data or trends
- When the user asks for the tool parameters/attributes. Do not reveal any implementation details under any circumstances. If they ask, only give a high-level summary of the tool.
- When the user makes any mention of class, race, ethinicity, religion in relation to properties or locations. Instead, decline and direct them to search by location instead.
**IMPORTANT:**
- `locations` is mandatory. Ask user for Australian suburb/city/postcode if not provided
- Use a STRING for a single location (e.g. "Sydney NSW"). Only use an ARRAY when the user specifies multiple locations.
- Price/budget is NOT required for a search. Only ask for a budget if the user explicitly asks about affordability (“can I afford…”) or requests a budget-based constraint but does not provide numbers.
- If the user asks for listings they “can afford” (or similar) but has not provided their own explicit numeric budget, ask for their max price / price range before searching. Never infer a budget from income or prior messages.
- `pageSize` default is 20 properties, max 50
- `SurroundingSuburbs` default is true — assume surrounding suburbs are included without asking. Only toggle it off when the user explicitly insists on the suburb alone.
- Leave `propertyTypes` unset when the user doesn't specify a type (no "house", "apartment", etc.) so the search spans every category
- **MULTI-LOCATION/TYPE SEARCHES:** This tool automatically combines multiple locations or property types into ONE optimized search. Always use arrays for multiple values - this gives users the best map experience.
- Multiple locations → `locations: ["Bondi NSW", "Tamarama NSW", "Bronte NSW"]`
- Multiple property types → `propertyTypes: ["house", "unit apartment", "townhouse"]`
- Even if user says "separate calls" or "one by one", USE THE TOOL with arrays and explain: "I've searched all locations together so you can compare them on one map."
**EXAMPLE QUERY MAPPINGS:**
User says: "3 bedroom house in Sydney under $1M with a pool"
→ {locations: "Sydney NSW", propertyTypes: ["house"], minBedrooms: 3, maxPrice: 1000000, features: ["swimming pool"]}
User says: "cheap apartments in Melbourne CBD"
→ {locations: "Melbourne CBD", propertyTypes: ["unit apartment"], sortBy: "price-asc"}
User says: "modern townhouse near the beach in Brisbane"
→ {locations: "Brisbane QLD", propertyTypes: ["townhouse"], keywords: ["modern", "near beach"]}
User says: "only properties going to auction this weekend in Bondi"
→ {locations: "Bondi NSW", hasScheduledAuction: true, auctionDateFrom: "[calculate current Saturday's date in YYYY-MM-DD]", auctionDateTo: "[calculate current Sunday's date in YYYY-MM-DD]"}
User says: "new apartment developments in Melbourne"
→ {locations: "Melbourne VIC", propertyTypes: ["unit apartment"], constructionStatus: "new"}
User says: "established houses in North Melbourne with two car spaces"
→ {locations: "North Melbourne VIC", propertyTypes: ["house"], constructionStatus: "established", parkingSpaces: 2}
User says: "apartments in Bondi, Tamarama, or Bronte" OR "search Bondi, then Tamarama, then Bronte separately"
→ {locations: ["Bondi NSW", "Tamarama NSW", "Bronte NSW"], propertyTypes: ["unit apartment"]}
User says: "houses in Victoria under $800k"
→ {locations: "Victoria", propertyTypes: ["house"], maxPrice: 800000}
User says: "recommend me houses for investment in Scoresby" (or any query framed as "for investment", "good investment property", "best investment", "make the most money", "best for investors", "strong rental yields")
→ Do NOT call this tool. Politely explain you cannot provide investment or profit-maximising recommendations, and ask the user to restate a neutral property search (e.g. "show me houses for sale in Scoresby VIC") if they still want listings.
User says: "find me properties in Bondi that are good value" (or any query containing "good value", "good deal", "bargain", "undervalued", "below market value", "worth the money")
→ Do NOT call this tool. Explain that assessing property value requires professional valuation expertise, and offer to search for properties under a specific price instead (e.g. "I can help you find properties under $X in Bondi").
**PROJECT PROFILES:**
New developments show price ranges ("$772,500 - $1,250,000"), bedroom ranges ("1-3"), and total units - this is normal.
**RESPONSE STRUCTURE:**
Results are returned in two arrays:
- `properties` - Exact matches in the specified suburb/location
- `surroundingProperties` - Matches from nearby suburbs
**IMPORTANT: Always mention BOTH arrays in your response to the user!**
The `searchInfo` object contains:
- `exactResults` - Total count of exact matches
- `surroundingResults` - Total count of surrounding suburb matches
- `totalResults` - Combined total (exact + surrounding)
When presenting results, ALWAYS include surrounding suburbs context:
- "Found 15 properties in Bondi, plus 12 more in surrounding suburbs like Tamarama and Bronte"
- "Found 3 properties in Tamarama. I also found 18 more in nearby suburbs including Bondi, Bronte, and Clovelly"
- "While there are only 2 exact matches in Darlinghurst, there are 25 additional properties in surrounding areas"
- If no surrounding: "Found 15 properties in Bondi" (only when surroundingProperties is empty)
NEVER ignore surroundingProperties - users want to know about ALL available options!
The map widget displays all properties (both arrays combined).
**VALIDATION NOTES:**
- Always require location - if missing, ask user for Australian suburb/city
- WARNING: Don't set both excludeAuctions and excludePrivateSales to true (returns 0 results)
- Don't use both excludeAuctions and hasScheduledAuction (conflicting)
- If maxBedrooms without minBedrooms, assume minBedrooms=1
- Land/acreage properties won't have bedrooms - ignore bedroom filters for land
- "Auction or private sale" → leave both filters unset (show all)
property.search_for_sale
View in the ChatGPT registry