Search and browse houses and apartments for rent or sale on QuintoAndar.
search-houses-carouselFull Description
Use this tool when the user wants to search, browse, discover or compare residential properties available for rent or purchase on QuintoAndar, such as apartments, houses, studios, and similar property types.
The user can search for properties using a wide range of filters, including price, location, number of bedrooms, property type, area, and other relevant attributes. The tool returns a list of matching properties displayed in an interactive carousel, where each property card includes key information such as price, images, size, and address.
This tool is intended for discovery and comparison only. It does not replace services provided directly by QuintoAndar, such as talking to a real estate agent, alerts of recommendations, etc.
Parameters (4 required, 1 optional)
businessContextstringBusiness context for the search. Accepts RENT or SALE. If the user does not specify, default to RENT.
RENTSALEcitystringCity for the property search. Use the full city name (e.g., Fortaleza, Niterói). Only provide the city, without state or neighborhood info.
querystringFree-form natural language description of desired property traits. Include any relevant details, such as:- Floor plan attributes: number of bedrooms, bathrooms, area, suites- Features: parking spots, balcony, furnished, etc.- Amenities: pool, gym, near subway, pet friendly- Infrastructure: barbecue area, sauna, green area, elevator- Other specifics: ocean view, proximity to landmarks, flooring colorOnly use affirmative constraints (e.g., 'with balcony', 'more than 2 bedrooms'); negative filters are not supported.Example prompts: '3 bedrooms with balcony and open view'; 'furnished apartment that allows pets'; '2-bedroom apartment between Pinheiros and Vila Madalena with wooden floor and balcony'.
statestringState where properties will be searched. Use the 2-letter state code (e.g., RJ for Rio de Janeiro, SP for São Paulo). Only provide the state code, without city or neighborhood info.
neighborhoodstringOptional neighborhood or subregion to narrow the search (e.g., Moema, Copacabana, Jardins). Provide any geographic unit smaller than the city when available.
null