QuintoAndar Scraper & New-Listing Monitor - Brazil Rent & Sale

Pull Brazilian property listings from QuintoAndar (quintoandar.com.br) as clean JSON, newest first: monthly rent, condomínio, IPTU and the total monthly cost as separate numbers in BRL, the sale price, area in m², bedrooms, suites, bathrooms, parking spaces, furnished or not, street, neighbourhood, city and approximate map coordinates (rounded to about 100 m). Search for rent (alugar) or for sale (comprar) by city or by neighbourhood (bairro) - São Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre, Brasília and every other city QuintoAndar serves.

Turn on monitoring and every later run returns only new listings and price drops since the last run, with the previous price.

Unofficial. This Actor is not affiliated with, endorsed by, or sponsored by QuintoAndar. All product names are trademarks of their respective owners.

No API key, no login. It asks QuintoAndar's public search the same question its own website asks when a visitor scrolls a city, at a gentle pace, and checks robots.txt on every run.

---

Who uses this

• Renters and buyers who want the newest flats in a neighbourhood the moment they appear, with the real monthly cost (rent + condomínio + IPTU) side by side.
• Real estate agents and investors tracking asking rents and sale prices per neighbourhood, and price drops.
• Analysts and proptech teams who need a daily feed of Brazilian listings in a spreadsheet, database or n8n / Make / Zapier flow.

Monitoring: run it daily, get only what changed

1. Set your city (and neighbourhood if you like), switch Monitoring mode on, and schedule the Actor (daily is typical).
2. The first run remembers every listing and its price. It returns one free monitoring-started row and charges nothing.
3. Every later run returns only:
   • changeType: "new" - a listing that was not there last time;
   • changeType: "price-drop" - a listing whose rent (rent searches) or sale price (buy searches) went down, with previousPriceBrl.
4. If nothing changed you get one free no-new-listings row. Each page of 50 listings that was compared without returning a change is charged as one small search-checked event (see Pricing).

The memory is kept per search (rent/buy + place), so you can watch several cities or neighbourhoods from one account. resetMonitoringState starts a search over from a free baseline.

Coverage: QuintoAndar serves at most 1,000 listings per search, newest first. New listings always land at the top, so they are always seen. Price drops are watched on those 1,000 newest listings; in a very large city (São Paulo has 40,000+ rentals) split the watch by neighbourhood to cover more. The run log and the first-run row say how many listings were compared.

What makes the data usable

• Costs as separate numbers. rentBrl, condominiumBrl, iptuBrl, condominiumPlusIptuBrl and totalMonthlyCostBrl (QuintoAndar's total, which also includes its fees and fire insurance) - no parsing of "R$ 3.400" strings.
• Nothing invented. A value QuintoAndar gives as 0 or does not give is null, not 0. The rent of a listing that is only for sale, and the sale price of a listing that is only for rent, are null (QuintoAndar sometimes carries an estimate there that is not an asking price).
• Only the place you asked for. QuintoAndar mixes listings from nearby places into a search. By default only listings QuintoAndar itself tags as being in your city or neighbourhood are returned (areaMatch: same-city / same-neighbourhood). In a neighbourhood search QuintoAndar's own count includes the nearby ones too - e.g. 670 for Jardim Botânico (Rio) of which 180 are tagged to the neighbourhood or its box. Turn on includeNearby to also get the others (areaMatch: inside-area-bounds = inside the neighbourhood's rectangle, often the next bairro; nearby = elsewhere).
• Unknown places are said out loud. A misspelt city returns a free no-such-location row instead of somebody else's listings.
• QuintoAndar's own tags as booleans: isNewAd, rentPriceDecreasedTag, salePriceDecreasedTag.

Measured on 2026-10-09 (200 rentals in São Paulo and 200 sales in Rio de Janeiro): rent, area, bedrooms, bathrooms, parking, street, neighbourhood and coordinates filled on 99-100% of listings; condomínio on 82% (rent) / 90% (sale); IPTU on 66% / 76% (houses outside a condomínio often have neither).

Input

Field	What it does
transaction	rent (alugar) or buy (comprar). Empty = rent.
city	City name (São Paulo, Rio de Janeiro, accents optional) or QuintoAndar's code (sao-paulo-sp-brasil).
state	Two-letter state code (SP, RJ, MG ...). Needed with a city name.
neighbourhood	Optional bairro, e.g. Vila Mariana, Copacabana.
searchUrl	Optional: paste a QuintoAndar list address instead of the fields above.
maxListings	How many listings to return (1-1,000). Empty = 20.
maxPages	Cap on pages of 50 (max 20).
minPrice / maxPrice	BRL. Rent searches compare the monthly rent; buy searches the sale price.
minAreaSqm / maxAreaSqm / minBedrooms	Size filters.
propertyTypes	Apartment, House, Casa de Condomínio, Studio (English or Portuguese).
furnishedOnly	Drop listings marked not furnished.
includeNearby	Also return the nearby listings QuintoAndar suggests.
monitoringMode / resetMonitoringState	See above.

Example - the newest 20 rentals in São Paulo:

{ "transaction": "rent", "city": "São Paulo", "state": "SP", "maxListings": 20 }

Example - watch flats for sale in Copacabana under R$ 1,200,000:

{ "transaction": "buy", "city": "Rio de Janeiro", "state": "RJ", "neighbourhood": "Copacabana", "maxPrice": 1200000, "propertyTypes": ["Apartment"], "monitoringMode": true }

Output

One row per listing:

{
  "status": "ok",
  "listingId": "895469980",
  "url": "https://www.quintoandar.com.br/imovel/895469980/alugar",
  "transaction": "rent",
  "propertyType": "House",
  "propertyTypeCode": "Casa",
  "rentBrl": 2400,
  "condominiumBrl": null,
  "iptuBrl": null,
  "condominiumPlusIptuBrl": null,
  "totalMonthlyCostBrl": 2502,
  "salePriceBrl": null,
  "areaSqm": 50,
  "bedrooms": 1,
  "suites": 0,
  "bathrooms": 1,
  "parkingSpaces": 1,
  "isFurnished": true,
  "street": "Rua Orlando Pellicci",
  "neighbourhood": "Cidade Líder",
  "city": "São Paulo",
  "latitude": -23.56,
  "longitude": -46.479,
  "isNewAd": true,
  "areaMatch": "same-city",
  "resolvedLocation": "São Paulo, SP",
  "siteTotalForSearch": 43512,
  "currency": "BRL"
}

Monitoring rows add changeType (new or price-drop) and, for drops, previousPriceBrl.

Rows that are never charged

status	Meaning
monitoring-started	First monitoring run: the starting point was remembered.
no-new-listings	Monitoring: nothing new and nothing cheaper since the last run.
no-filter-match	Listings were read, but none passed your filters.
no-results	QuintoAndar answered with 0 listings for this search.
no-such-location	QuintoAndar does not know this place (check spelling and state).
blocked / unreadable	QuintoAndar did not answer normally. Nothing is guessed; try again later.
disallowed-by-robots	robots.txt disallows the address, so it was not requested.

Pricing

Pay per event: listing-returned for each listing row you receive, and in monitoring mode search-checked for each page of 50 listings compared without a change. Rows above are free. Set a maximum cost per run in Apify and the Actor stops cleanly at that limit; listings it could not hand over in monitoring mode come back on the next run.

Notes

• Personal data: owner or agent names and phone numbers are not requested or returned. The street is given without a house number, as QuintoAndar shows it, and latitude / longitude are rounded to 3 decimals (about 100 m) so that a private home cannot be pinpointed.
• Classified ads that QuintoAndar shows from partner agencies are not included; the rows are the listings QuintoAndar manages itself (most of each city).
• Sorting is newest first. QuintoAndar's 1,000-per-search limit applies to every search.
• siteTotalForSearch is QuintoAndar's own count for the search, which includes the nearby listings it mixes in.

Thanks for using this Actor

We build these tools for people who run them every day, and we improve them from what users tell us.

• Missing a field, or need another filter? Tell us in the Issues tab. If the data is there, we add it.
• Found a bug or a wrong value? Post the run ID in the Issues tab. Wrong data is the thing we fix first.

If this Actor saved you time, a short review helps other people find it.