QuintoAndar Scraper

QuintoAndar Scraper: Brazilian rentals and sales with the full monthly cost

Name a Brazilian city or paste a QuintoAndar URL, and get the listings back as rows. Rent, sale price, condo fee and IPTU, the total monthly cost, floor area, bedrooms, bathrooms, parking, neighbourhood, the amenity list, the building's facilities and every photo.

The thing to know first: QuintoAndar hands out about 26 listings per search page. Asking for more than that means the run works through the city neighbourhood by neighbourhood, roughly one extra request per 24 listings, so a 500-row run is a lot more work than a 26-row one.

🏢 What QuintoAndar Scraper does

Type "São Paulo" and it finds the search; paste pinheiros-sao-paulo-sp-brasil and it goes straight at that neighbourhood, which gives you a much tighter set. You can also paste a search page or a single listing URL, and a single listing always comes back with the full field set.

Rent and sale are separate sides of the site. Several cities QuintoAndar covers are rent-only, and asking for sale listings there gets you a row that says so rather than an empty dataset.

There is a guard worth knowing about. Hand QuintoAndar a location slug it does not recognise and it does not refuse, it answers with listings from somewhere else entirely. The run compares what came back against what you asked for and throws those away instead of charging you for another city's flats.

includeDetails is off on purpose. Leave it off and you get everything the search results carry. Turn it on and the run opens each listing to fill in coordinates, the condo fee and IPTU split apart, postcode, suites, pets, construction year, availability and the owner's own description. That is one extra request per listing and it makes the run about forty times heavier.

Minimums narrow the search on QuintoAndar itself. Price, bedrooms, bathrooms and floor area are checked again on each listing's own numbers, and one that falls short is skipped, never charged. A rent minimum is the monthly rent before condo fee and IPTU. Bedrooms and bathrooms stop at 4, meaning four or more. Minimums work on places you type, not pasted URLs: adding a second bedroom choice to a URL widens it, so the run stops with a BAD_INPUT row.

📥 What you give it

{
  "location": "pinheiros-sao-paulo-sp-brasil",
  "businessContext": "rent",
  "maxItems": 50,
  "includeDetails": false
}

📤 What you get back

A real row from a recent run, with the photo list cut short:

{
  "listingId": "893445318",
  "url": "https://www.quintoandar.com.br/imovel/893445318/alugar",
  "businessContext": "rent",
  "forRent": true,
  "forSale": false,
  "rentPrice": 9610,
  "salePrice": 1950000,
  "totalCost": 12136,
  "condoAndIptu": 2156,
  "condoPrice": null,
  "iptu": null,
  "currency": "BRL",
  "propertyType": "Apartamento",
  "area": 110,
  "bedrooms": 3,
  "bathrooms": 2,
  "suites": null,
  "parkingSpots": 2,
  "isFurnished": true,
  "acceptsPets": null,
  "constructionYear": null,
  "street": "Rua Doutor Virgílio de Carvalho Pinto",
  "neighbourhood": "Pinheiros",
  "city": "São Paulo",
  "postcode": null,
  "latitude": null,
  "longitude": null,
  "availability": null,
  "visitsUnavailable": false,
  "description": null,
  "amenities": ["BANHEIRA_DE_HIDROMASSAGEM", "ESPELHO_NO_BANHEIRO", "VARAL_DE_ROUPAS", "..."],
  "buildingFacilities": ["SALAO_DE_FESTAS", "AREA_VERDE", "GAS_ENCANADO", "..."],
  "specialConditions": ["Exclusivity"],
  "rentalYield": 0.0049,
  "coverImage": "https://www.quintoandar.com.br/img/med/893445318-787...jpg",
  "imageCount": 12,
  "searchLocation": "sao-paulo-sp-brasil",
  "position": 3,
  "scrapedAt": "2026-09-26T06:14:03.287Z"
}

🧾 Reading the output

Three kinds of row can land in your dataset.

Filter on _sample and _diagnostic being absent. Starting a run with nothing filled in writes the sample row and stops, so you can look at the shape before spending anything.

A diagnostic row never fails the run, and one bad location never stops the others.

▶️ How to run it

1. Open QuintoAndar Scraper and click Try for free. 2. Type a city into Where to look, or paste a neighbourhood slug from a QuintoAndar URL. 3. Pick Rent or buy. 4. Set How many listings. Start at 26 or below to stay inside one search page. 5. Click Start, then download the dataset as JSON, CSV or Excel, or read it from the Apify API.

💰 How much does it cost?

$1.40 per 1,000 properties. Flat on every Apify plan, no volume tiers.

You pay per property row delivered. Duplicates removed before delivery, listings discarded because QuintoAndar answered with the wrong city, the sample row and diagnostic rows are all free. Turning on includeDetails does not change the price, only how long the run takes.

💡 What people use it for

• Working out the real monthly cost of renting in a neighbourhood, using totalCost rather than the

headline rent.

• Comparing rent against asking price on the same buildings, since both come back on one row.
• Watching new listings appear in one neighbourhood, scheduled, deduped on listingId.
• Filtering by what the building actually has: buildingFacilities carries the gym, the pool and the

laundry as stable keys.

🚧 What it does not do

• No owner or agent contact details. QuintoAndar handles the visit itself and publishes none.
• About 26 listings per search page. More than that means many more requests, which is why the

ceiling is 2,000 and not higher.

• Cities stay inside their borders, neighbourhoods not always. A search page links nearby cities

and neighbourhoods, and the run does not follow them, so a São Paulo search never hands you Osasco. A neighbourhood search covers QuintoAndar's own map of the area, though, and a narrow one, four bedrooms in Pinheiros say, can bring listings from just across the border. Each row's neighbourhood says where it is.

• Seven fields stay null without includeDetails, coordinates and the condo fee split among

them.

• Several cities are rent-only. Asking for sale listings there returns a row saying so.
• No upper limits. Price, bedrooms, bathrooms and area take a minimum only.
• Brazil only, and only the cities QuintoAndar operates in.
• Amenity keys stay in Portuguese. Translating them would break anyone filtering on them.
• Rows are a snapshot. QuintoAndar pulls a listing the moment it is rented, and scrapedAt

records when it was read.

• No floor plans and no virtual tours, only the photo URLs.

🧭 Which property scraper do you need?

❓ Questions people ask

Do I need a QuintoAndar account? No, and there is no API key to apply for.

What is a neighbourhood slug? The bit in their URL that names the area, like pinheiros-sao-paulo-sp-brasil. Copy it out of the address bar. It gets you a tighter, faster search than a whole city.

Should I turn on details? Only if you need coordinates, the condo fee split from IPTU, or the owner's description. It costs an extra request per listing.

Why is salePrice null on a rental? QuintoAndar writes a zero on the side that is not offered, and a zero is not a price, so it comes back empty rather than as a misleading number.

Can I run several cities at once? Yes. Put the extras into locations, one per line.

Is scraping property listings legal? These are public adverts on a public site. Apify's write-up on scraping and the law is a sensible starting point, and we are not lawyers.

🆘 If something breaks

Open the Issues tab on the actor page. Send the run ID and the location or URL you used. The errorCode on the diagnostic row usually names the problem on its own.