
FINN.no Scraper
scrape.ly/store/shelfbright/finn-scraperE-commerceReal estate
1 monthly user

Scrape QuintoAndar (quintoandar.com.br), Brazil's big rental and home-buying platform: apartments, houses and studios for rent or sale with rent, sale price, condo fee, IPTU, total monthly cost, area, rooms, address, CEP, coordinates, photos, amenities and descriptions. Search by URL or by city and neighbourhood with filters.
Scrape rentals and homes for sale from QuintoAndar (quintoandar.com.br), one of Brazil's biggest property platforms. Paste a QuintoAndar search URL or type a city or neighbourhood, and get clean rows with rent or price, condo fee, IPTU, total monthly cost, area, rooms, full address, CEP, coordinates, photos, amenities and descriptions. No login, no browser, a flat price per listing.
| Field | Description |
|---|---|
startUrls | QuintoAndar search URLs (/alugar/imovel/..., /comprar/imovel/...) or listing URLs (/imovel/<id>). |
locations | Cities or neighbourhoods, e.g. São Paulo, Pinheiros, São Paulo, Copacabana, Rio de Janeiro. |
maxItems | Max listings across all inputs (default 20, 0 = no limit). |
dealType | rent or sale (for locations). |
propertyTypes | apartment, house, studio, condo_house. |
minPrice / maxPrice | Rent or sale price range in reais. |
minArea / maxArea | Area range in m². |
minBedrooms, minBathrooms, minParkingSpaces, minSuites | Room minimums. |
furnished, petsAllowed, nearSubway | Furnished / unfurnished, pets allowed, near metro or train. |
sort | relevance, most_recent, lowest_price, highest_price. |
includeDetails | Open each listing page for the full details (default on, same price). |
{
"locations": ["Pinheiros, São Paulo", "Copacabana, Rio de Janeiro"],
"dealType": "rent",
"propertyTypes": ["apartment"],
"maxPrice": 6000,
"minBedrooms": 2,
"petsAllowed": true,
"sort": "most_recent",
"maxItems": 200
}
| Field | Description |
|---|---|
id, displayId, url, title | Listing ids, link and short title. |
dealType, propertyType, propertyTypeLabel | Rent or sale, and the property type. |
price, rentPrice, salePrice, currency | Prices in reais. |
condoFee, condoFeeType, iptu, iptuType, condoPlusIptu, totalCost, fireInsurance, serviceFee | Monthly costs. |
area, bedrooms, bathrooms, suites, parkingSpaces, floor | Size and rooms. |
isFurnished, acceptsPets, nearSubway, hasElevator | Key flags. |
street, neighborhood, region, city, state, zipCode, latitude, longitude | Location. |
photos, photoCaptions, thumbnail, imageCount, video | Media. |
amenities, installations, amenityCodes, installationCodes, placesNearby | Home amenities, building facilities, nearby places. |
description, generatedDescription | Owner's description and QuintoAndar's long description. |
availability, visitStatus, status, firstPublishedAt, lastPublishedAt, forRent, forSale, isPrimaryMarket, listingTags, specialConditions, rentalYield | Listing status. |
searchSource, scrapedAt, hasDetails | Where the row came from. |
{
"id": "894764394",
"url": "https://www.quintoandar.com.br/imovel/894764394/alugar",
"dealType": "rent",
"title": "Apartamento para aluguel com varanda, 2 suítes e academia no condomínio.",
"propertyType": "apartment",
"propertyTypeLabel": "Apartamento",
"price": 9922,
"rentPrice": 9922,
"salePrice": null,
"condoFee": 1754,
"iptu": 495,
"condoPlusIptu": 2249,
"totalCost": 12553,
"currency": "BRL",
"area": 82,
"bedrooms": 2,
"bathrooms": 3,
"suites": 2,
"parkingSpaces": 2,
"isFurnished": false,
"acceptsPets": false,
"nearSubway": true,
"hasElevator": true,
"street": "Rua Mourato Coelho",
"neighborhood": "Pinheiros",
"region": "Pinheiros",
"city": "São Paulo",
"state": "SP",
"zipCode": "05417-010",
"latitude": -23.5659091,
"longitude": -46.6860336,
"photos": [
"https://www.quintoandar.com.br/img/xxl/894764394-538.461987993081DSC02416.JPG",
"https://www.quintoandar.com.br/img/xxl/894764394-516.6741263622489DSC02417.JPG"
],
"photoCaptions": [
"Sala",
"Sala"
],
"thumbnail": "https://www.quintoandar.com.br/img/xxl/894764394-538.461987993081DSC02416.JPG",
"imageCount": 60,
"amenities": [
"Box",
"Varanda",
"Armários no quarto",
"Armários no banheiro",
"Armários na cozinha"
],
"installations": [
"Piscina",
"Academia",
"Salão de festas",
"Corrimão",
"Piso tátil",
"Rampas de acesso",
"Salão de jogos",
"Vaga de garagem acessível",
"Elevador",
"Portaria 24h"
],
"amenityCodes": [
"BOX",
"VARANDA",
"ARMARIOS_EMBUTIDOS_NO_QUARTO",
"ARMARIOS_NOS_BANHEIROS",
"ARMARIOS_NA_COZINHA"
],
"installationCodes": [
"PISCINA",
"ACADEMIA",
"SALAO_DE_FESTAS",
"CORRIMAO",
"PISO_TATIL",
"RAMPAS_DE_ACESSO",
"SALAO_DE_JOGOS",
"VAGA_DE_GARAGEM_ACESSIVEL",
"ELEVADOR",
"PORTARIA_24H"
],
"forRent": true,
"forSale": false,
"isPrimaryMarket": false,
"visitStatus": "ACCEPT_NEW",
"listingTags": [],
"specialConditions": [
"Exclusivity"
],
"rentalYield": null,
"hasDetails": true,
"displayId": "2064394",
"condoFeeType": "Normal",
"iptuType": "Normal",
"fireInsurance": 126,
"serviceFee": 256,
"floor": null,
"description": "Unidade 11C - vagas de garagem determinadas26P - 1º Subsolo27P-1ºSubsolo",
"generatedDescription": "Este apartamento de 82 metros quadrados é uma excelente opção para quem busca conforto e praticidades. Composto por dois quartos, ambos suítes, e três banheiros, este imóvel oferece espaço e privacida...",
"placesNearby": [
"Fradique Coutinho",
"E.E Fernão Dias Paes",
"WIzard"
],
"availability": "IMMEDIATE",
"rentOnTermination": false,
"constructionYear": null,
"video": null,
"status": "publicado",
"firstPublishedAt": "2025-02-04T22:41:39.000+0000",
"lastPublishedAt": "2026-06-12T17:19:48.000Z",
"searchSource": "location: Pinheiros, São Paulo",
"scrapedAt": "2026-10-15T23:17:53+00:00"
}
result-item), full details included: 1,000 listings ≈ $1.30 plus about five cents of platform usage (compute and proxy traffic).Is it legal to scrape QuintoAndar? The scraper only reads public listing pages that anyone can open without an account. You are responsible for how you use the data.
Do I need an account or a proxy? No login is needed. The run uses Scrapely's proxies by default and switches to Brazilian residential exits by itself if the site starts blocking.
How many listings can I get? QuintoAndar pages through at most 1,000 listings per search. Above that, the scraper splits the search into price ranges and keeps going, so a whole city can be collected.
Which cities are covered? Every city QuintoAndar serves (São Paulo, Rio de Janeiro, Belo Horizonte, Porto Alegre, Brasília, Curitiba, Campinas and about 90 more). Use "Neighbourhood, City" for neighbourhoods.
Why is a field empty? Some fields depend on what the owner filled in (description, floor, construction year). CEP, state and descriptions need Full listing details.
Can I schedule it or use the API? Yes. Schedule runs in the console, call the API, or connect webhooks and integrations.
Every field below can be set in the run form, passed through the API, or saved as a task. Unset fields fall back to the defaults shown.
startUrlsarrayOptionalQuintoAndar URLs
Paste links from quintoandar.com.br: search pages (/alugar/imovel/... or /comprar/imovel/... with any city, neighbourhood and filters) or single listing pages (/imovel/). Open QuintoAndar, set your filters and copy the address bar.
locationsarrayOptionalLocations to search
Cities or neighbourhoods QuintoAndar covers, e.g. 'São Paulo', 'Pinheiros, São Paulo', 'Copacabana, Rio de Janeiro', 'Savassi, Belo Horizonte'. Uses the filters below.
maxItemsintegerOptionaldefault 20Max listings
Maximum number of listings to save across all URLs and locations. 0 means no limit. QuintoAndar pages through at most 1,000 listings per search, so bigger searches are split into price ranges automatically.
Used for Locations searches. Pasted search URLs keep their own filters.
dealTypeenumOptionaldefault "rent"Rent or buy
Rentals or homes for sale.
propertyTypesarrayOptionalProperty types
Leave empty for all types.
minPriceintegerOptionalMin price (R$)
Minimum monthly rent (rent) or asking price (buy), in reais.
maxPriceintegerOptionalMax price (R$)
Maximum monthly rent (rent) or asking price (buy), in reais.
minAreaintegerOptionalMin area (m²)
Minimum area in square metres.
maxAreaintegerOptionalMax area (m²)
Maximum area in square metres.
minBedroomsintegerOptionalMin bedrooms
At least this many bedrooms.
minBathroomsintegerOptionalMin bathrooms
At least this many bathrooms.
minParkingSpacesintegerOptionalMin parking spaces
At least this many parking spaces.
minSuitesintegerOptionalMin suites
At least this many suites.
furnishedenumOptionaldefault "any"Furnished
Furnished or unfurnished homes.
petsAllowedbooleanOptionaldefault falsePets allowed only
Keep only homes that accept pets.
nearSubwaybooleanOptionaldefault falseNear metro or train only
Keep only homes close to a metro or train station.
sortenumOptionaldefault "relevance"Sort order
Order of the results.
includeDetailsbooleanOptionaldefault trueFull listing details
Open each listing page to add the owner's description, the full generated description, CEP, state, condo fee and IPTU types, fire insurance and service fee, all photos with captions, every amenity, nearby places, availability and publication dates. Turn off for faster runs with search data only (price, condo fee, IPTU, area, rooms, address, coordinates, photos, amenities).
proxyConfigurationobjectOptionaldefault {"useScrapelyProxy":true,"scrapelyProxyGroups":["DATACENTER…Proxy configuration
Datacenter proxies work for this site. If it starts blocking them, the run switches to residential proxies in Brazil automatically.
Every run writes its results to a dataset. Preview it in the dashboard, then export it or read it through the API.
| Field | Type | Description |
|---|---|---|
| thumbnail | any | Photo |
| url | any | Listing |
| title | any | Title |
| dealType | any | Rent/sale |
| propertyType | any | Type |
| price | any | Price (R$) |
| condoFee | any | Condo fee |
| iptu | any | IPTU |
| totalCost | any | Total/month |
| area | any | Area (m²) |
| bedrooms | any | Bedrooms |
| bathrooms | any | Bathrooms |
| parkingSpaces | any | Parking |
| neighborhood | any | Neighbourhood |
| city | any | City |
| id | any | Id |
You pay for the events the actor reports, such as each result or page it produces. Platform usage is included in the event prices.
| Event | Charged when | Price |
|---|---|---|
| Listing | One saved QuintoAndar listing (full listing details included). | $0.0013 |
Run this actor from your own code. Swap in your API token and the examples work as-is.
import { ScrapelyClient } from 'scrapely-client'
const client = new ScrapelyClient({ token: process.env.SCRAPELY_TOKEN })
// Start the actor and wait for the run to finish.
const run = await client.actor('roamandroof/quintoandar-scraper').call({
"startUrls": [
{
"url": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil"
}
],
"maxItems": 20,
"proxyConfiguration": {
"useScrapelyProxy": true,
"scrapelyProxyGroups": [
"DATACENTER"
]
}
})
// Read the dataset the run produced.
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)Tokens live in your account settings. Keep them server-side: a token carries the full permissions of your account.
Connect the Scrape.ly MCP server once and your agent can run this actor as a tool. Pick your tool:
Fetch scrape.ly/agents.md and run roamandroof/quintoandar-scraperPaste into Claude Code, Codex, Cursor or any AI agent. It signs you in once in the browser.
{
"mcpServers": {
"scrapely": {
"url": "https://api.scrape.ly/mcp?tools=actors,runs,storage,docs&actors=roamandroof/quintoandar-scraper"
}
}
}No key in the file: your client opens the browser to sign you in the first time it connects.
Inputs the developer prepared for common jobs. Open one to see its input, then copy it to your account to run it as-is or adjust it.
Neighbourhood rental search with full details.
Apartments from 500,000 to 2M BRL, cheapest first.
Newest furnished rentals in Sao Paulo that allow pets.
Rental listings in one neighbourhood.
Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes. The advantage lasts forever.