QuintoAndar Scraper: Brazil Real Estate Listings & Property Data API

Scrape property listings from QuintoAndar (quintoandar.com.br), Brazil's largest rental and sale platform. Pull imoveis para alugar e vender (properties for rent and for sale) with price, rent, condominio, IPTU, area, bedrooms, amenities, the full photo gallery, geo coordinates and more, exported as JSON, CSV or Excel. This is a fast, HTTP-only Brazil real estate data API with no login and no browser required.

Use it for real estate market research, price and rental-yield analysis, lead generation, competitor monitoring, property portals, and data enrichment across 13 Brazilian metro markets.

{
  "title": "Apartamento 2 quartos em Pinheiros, São Paulo",
  "imageUrl": "https://www.quintoandar.com.br/img/med/original895538161-236.5IMG8654.jpeg",
  "photos": ["https://www.quintoandar.com.br/img/med/895538161-236.5IMG8654.jpeg", "..."],
  "photosCount": 12,
  "amenities": ["AR_CONDICIONADO", "VARANDA", "PODE_TER_ANIMAIS_DE_ESTIMACAO"],
  "installations": ["PISCINA", "ACADEMIA", "PERTO_DE_METRO_OU_TREM"],
  "specialConditions": ["Exclusivity"],
  "listingTags": ["NEW_AD"],
  "id": "895538161",
  "url": "https://www.quintoandar.com.br/imovel/895538161",
  "operation": "rent",
  "propertyType": "Apartamento",
  "salePrice": null,
  "rentPrice": 5548,
  "totalMonthlyCost": 7062,
  "currency": "BRL",
  "condominiumFee": 1050,
  "iptu": 250,
  "rentalYield": null,
  "area": 45,
  "bedrooms": 2,
  "bathrooms": 2,
  "suites": 1,
  "parkingSpaces": 0,
  "isFurnished": false,
  "petsAllowed": true,
  "nearSubway": true,
  "isPrimaryMarket": false,
  "isSecondaryHouse": false,
  "isAcceptingVisits": true,
  "visitStatus": "ACCEPT_NEW",
  "address": "Avenida Pedroso de Morais",
  "neighborhood": "Pinheiros",
  "region": "Pinheiros",
  "city": "São Paulo",
  "state": "SP",
  "country": "Brasil",
  "latitude": -23.5629358,
  "longitude": -46.6917497,
  "observedAt": "2026-09-04T18:11:55.213Z",
  "error": null
}

The photos array is trimmed here for readability; every run returns the full gallery. All values shown are real.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Why this scraper
• Quickstart
• Input reference
• Output reference
• Amenity codes
• Run via API and CLI
• Fetch results
• Use cases
• Billing and limits
• FAQ and troubleshooting

What it does

The actor queries the QuintoAndar listing search for the city and operation (sale or rent) you choose, applies your filters (property type, bedrooms, bathrooms, parking, suites, price, area, furnished, pets, neighborhood, amenities), paginates through every matching property, and writes one clean record per listing. Prices and fees that QuintoAndar reports with 0 or -1 sentinels are returned as null, the full photo gallery is expanded to CDN URLs, and unit amenities, building amenities and special conditions are captured as arrays so you can filter without extra parsing.

Coverage is concentrated in the 13 Brazilian metros where QuintoAndar operates: Sao Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre, Brasilia, Campinas, Recife, Guarulhos, Santo Andre, Sao Bernardo do Campo, Osasco and Niteroi. You can also paste QuintoAndar search URLs directly as Start URLs.

Why this scraper

The most complete QuintoAndar scraper on Apify. It returns every field the QuintoAndar search exposes, plus derived fields other scrapers drop, and accepts a full set of filters.

Capability	This actor	Typical alternatives
Rent, sale, condominio, IPTU and total monthly cost	Yes, all separated	Often only one price
Pure rentPrice split from totalMonthlyCost	Yes	Usually merged
Rental yield (rentalYield) for sale listings	Yes	Rarely
Full photo gallery (not just cover)	Yes	Often cover only
Unit and building amenities as arrays	Yes	Partial
Geo coordinates, city, state, country	Yes	Partial
Filters: type, beds, baths, parking, suites	Yes	Partial
Filters: price, area, furnished, pets, near subway	Yes	Partial
Neighborhood text filter	Yes	Rarely
Accept QuintoAndar search URLs as input	Yes	Some
Derived human-readable title	Yes	Some
Pay per result, spend cap, no charge on failure	Yes	Varies

Every input other popular QuintoAndar scrapers accept (deal type, city, neighborhood, property type, min bedrooms, bathrooms, parking, price range, area range, amenities, building amenities, furnished, pets, near transit, search URLs) is supported here, and every output field they return (id, title, operation, property type, rent, total monthly cost, sale price, condo fee, IPTU, area, rooms, bathrooms, parking, neighborhood, city, state, coordinates, furnished, pets, url) is returned here, plus extra fields.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the 10 most recent apartments for sale in Sao Paulo.

{
  "maxListings": 10,
  "city": "sao-paulo-sp-brasil",
  "operation": "sale"
}

Set operation to rent for rentals. Add minBedrooms, minPrice, maxPrice, minArea, propertyTypes, furnished, petsAllowedOnly or neighborhood to narrow the search. Only operation is required.

Input reference

Field	Type	Required	Default	Description
city	enum	no	sao-paulo-sp-brasil	Brazilian city to search. One of the 13 covered markets, for example sao-paulo-sp-brasil, rio-de-janeiro-rj-brasil, belo-horizonte-mg-brasil. Ignored when Start URLs are provided.
operation	enum	yes	sale	Listing type: sale (comprar) or rent (alugar).
startUrls	array	no	(none)	One or more QuintoAndar search URLs. The city slug and operation are read from each URL and override city and operation.
propertyTypes	array	no	(all)	Restrict to types: Apartamento, Casa, CasaCondominio, StudioOuKitchenette.
neighborhood	string	no	(any)	Keep only listings whose neighborhood or region contains this text (accent and case insensitive).
maxListings	integer	no	10	Maximum listings to collect. The source caps deep pagination near 1000 per query.
minBedrooms	integer	no	(any)	Minimum bedrooms.
minBathrooms	integer	no	(any)	Minimum bathrooms.
minParkingSpaces	integer	no	(any)	Minimum parking spaces.
minSuites	integer	no	(any)	Minimum en-suite bedrooms.
minPrice	integer	no	(any)	Minimum price in BRL. Compared against sale price for sale, total monthly cost for rent.
maxPrice	integer	no	(any)	Maximum price in BRL.
minArea	integer	no	(any)	Minimum usable area in m2.
maxArea	integer	no	(any)	Maximum usable area in m2.
furnished	enum	no	any	any, furnished or unfurnished.
petsAllowedOnly	boolean	no	false	Only listings that allow pets.
nearSubwayOnly	boolean	no	false	Only listings near a subway or train station.
amenities	array	no	(none)	Require these unit amenity codes (see Amenity codes).
condoAmenities	array	no	(none)	Require these building amenity codes (see Amenity codes).
proxyConfiguration	object	no	(auto)	Optional proxy. A Brazilian residential proxy is used automatically as a fallback if the direct connection is blocked.

Filters combine with logical AND. Price and neighborhood filters drop any listing whose reference value is not reported by the source.

Output reference

One dataset item per listing. Types: string, integer, number, boolean, string[], or null when the source value is absent.

Field	Type	Description
title	string	Human-readable title derived from type, bedrooms, neighborhood and city.
imageUrl	string	Cover image URL.
photos	string[]	Full photo gallery as CDN image URLs.
photosCount	integer	Number of photos in the gallery.
amenities	string[]	Unit amenity codes, for example AR_CONDICIONADO.
installations	string[]	Building amenity codes, for example PISCINA.
specialConditions	string[]	Active special conditions, for example Exclusivity.
listingTags	string[]	Marketing tags, for example NEW_AD.
id	string	QuintoAndar listing ID.
url	string	Canonical listing URL on quintoandar.com.br.
operation	string	sale, rent, or both.
propertyType	string	Property type, for example Apartamento, Casa.
salePrice	number	Sale price in BRL, or null if not for sale.
rentPrice	number	Base monthly rent in BRL, or null.
totalMonthlyCost	number	Total monthly cost in BRL (rent plus fees), or null.
currency	string	Currency of all monetary fields. Always BRL.
condominiumFee	number	Monthly condominium fee in BRL, or null.
iptu	number	IPTU property tax in BRL, or null.
rentalYield	number	Rental yield estimate reported by the source for sale listings, or null.
area	number	Usable area in square meters, or null.
bedrooms	integer	Number of bedrooms, or null.
bathrooms	integer	Number of bathrooms, or null.
suites	integer	Number of en-suite bedrooms, or null.
parkingSpaces	integer	Number of parking spaces, or null.
isFurnished	boolean	Whether the unit is furnished, or null.
petsAllowed	boolean	true when the listing marks pets as allowed, else null.
nearSubway	boolean	true when the listing is near a subway or train, else null.
isPrimaryMarket	boolean	Whether the listing is a primary-market (new development) unit, or null.
isSecondaryHouse	boolean	Whether the listing is a secondary-market unit, or null.
isAcceptingVisits	boolean	Whether the listing is accepting new visits, or null.
visitStatus	string	Raw visit availability status, for example ACCEPT_NEW.
address	string	Street address (or postal code when the street is withheld).
neighborhood	string	Neighborhood name.
region	string	Region name reported by the source.
city	string	City name as reported by the source.
state	string	State abbreviation, for example SP.
country	string	Country, Brasil.
latitude	number	Latitude, or null.
longitude	number	Longitude, or null.
observedAt	string	ISO 8601 timestamp of collection.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Amenity codes

Pass these codes to amenities (unit) or condoAmenities (building). Common values:

• Unit (amenities): AR_CONDICIONADO, VARANDA, MOBILIADO, PODE_TER_ANIMAIS_DE_ESTIMACAO, ARMARIOS_NA_COZINHA, ARMARIOS_EMBUTIDOS_NO_QUARTO, COOKTOP, COZINHA_AMERICANA, AREA_DE_SERVICO, BOX, QUINTAL, LUMINOSIDADE_NATURAL, VISTA_LIVRE.
• Building (condoAmenities): PISCINA, ACADEMIA, SALAO_DE_FESTAS, PERTO_DE_METRO_OU_TREM, CHURRASQUEIRA, AREA_VERDE, LAVANDERIA_NO_PREDIO, SAUNA, RAMPAS_DE_ACESSO, VAGA_DE_GARAGEM_ACESSIVEL.

The shortcuts petsAllowedOnly and nearSubwayOnly add PODE_TER_ANIMAIS_DE_ESTIMACAO and PERTO_DE_METRO_OU_TREM for you.

Run via API and CLI

Start a run and read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~quintoandar-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"city":"sao-paulo-sp-brasil","operation":"sale","maxListings":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~quintoandar-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"city":"rio-de-janeiro-rj-brasil","operation":"rent","minBedrooms":2,"maxPrice":5000,"petsAllowedOnly":true}'

Apify CLI:

apify call scrapers_lat/quintoandar-scraper \
  --input '{"city":"belo-horizonte-mg-brasil","operation":"sale","maxListings":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=500&limit=500"

<DATASET_ID> is returned as defaultDatasetId in the run object.

Use cases

• Real estate market research: track asking prices, rent, condominio and IPTU per neighborhood and city.
• Rental-yield analysis: compare sale price and rent to find investment opportunities.
• Lead generation: build lists of listings matching a buyer or renter profile.
• Competitor and portal monitoring: watch inventory and price changes over time.
• Data enrichment: attach geo coordinates, amenities and photos to your own property database.

Billing and limits

• Pay per result. You are charged per record returned (result event). See the pricing tab for the current price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further results.
• Free Apify plans are capped at 10 listings per run. Upgrade for higher maxListings.
• Source pagination ceiling. The QuintoAndar search rejects offsets at or above 1000, so a single query returns up to roughly 1000 listings. For larger pulls, split the work with narrower filters or multiple Start URLs.

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing, or the city has no active listings for that operation. Loosen the filters or widen the price range. Zero-result runs are not charged.

Which cities are supported? The 13 markets where QuintoAndar operates: Sao Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre, Brasilia, Campinas, Recife, Guarulhos, Santo Andre, Sao Bernardo do Campo, Osasco and Niteroi.

Why are some prices or fees null? QuintoAndar reports unknown prices and fees with 0 or -1 sentinels. The actor normalizes those to null rather than reporting a false zero.

What is the difference between rentPrice and totalMonthlyCost? rentPrice is the base monthly rent. totalMonthlyCost adds the condominium fee, IPTU and service fee. For sale listings rentPrice is null.

Can I get more than 1000 listings from one city? Not in a single query; the source caps deep pagination near 1000. Split the work with bedroom, price or type filters to reach different slices of the inventory.

Is this an official QuintoAndar tool? No. This actor is independent and has no affiliation with QuintoAndar. It reads only data that is publicly available on quintoandar.com.br.

Related scrapers

• VivaReal Brazil Real Estate Scraper: VivaReal Brazil property listings for sale and rent.
• Zap Imoveis Brazil Scraper: Zap Imoveis Brazil property listings.
• OLX Brazil Scraper: OLX Brazil classifieds including real estate.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

Independent tool, not affiliated with QuintoAndar. Accesses only publicly available listing data.

---

QuintoAndar Scraper: Dados de Imoveis do Brasil e API de Anuncios

Extraia anuncios de imoveis do QuintoAndar (quintoandar.com.br), a maior plataforma de aluguel e venda do Brasil. Colete imoveis para alugar e vender com preco, aluguel, condominio, IPTU, area, quartos, comodidades, a galeria completa de fotos, coordenadas geograficas e muito mais, exportados em JSON, CSV ou Excel. Esta e uma API de dados imobiliarios do Brasil rapida, somente HTTP, sem login e sem navegador.

Use para pesquisa de mercado imobiliario, analise de precos e rentabilidade de aluguel, geracao de leads, monitoramento de concorrentes, portais de imoveis e enriquecimento de dados em 13 regioes metropolitanas brasileiras.

{
  "title": "Apartamento 2 quartos em Pinheiros, São Paulo",
  "imageUrl": "https://www.quintoandar.com.br/img/med/original895538161-236.5IMG8654.jpeg",
  "photos": ["https://www.quintoandar.com.br/img/med/895538161-236.5IMG8654.jpeg", "..."],
  "photosCount": 12,
  "amenities": ["AR_CONDICIONADO", "VARANDA", "PODE_TER_ANIMAIS_DE_ESTIMACAO"],
  "installations": ["PISCINA", "ACADEMIA", "PERTO_DE_METRO_OU_TREM"],
  "specialConditions": ["Exclusivity"],
  "listingTags": ["NEW_AD"],
  "id": "895538161",
  "url": "https://www.quintoandar.com.br/imovel/895538161",
  "operation": "rent",
  "propertyType": "Apartamento",
  "salePrice": null,
  "rentPrice": 5548,
  "totalMonthlyCost": 7062,
  "currency": "BRL",
  "condominiumFee": 1050,
  "iptu": 250,
  "rentalYield": null,
  "area": 45,
  "bedrooms": 2,
  "bathrooms": 2,
  "suites": 1,
  "parkingSpaces": 0,
  "isFurnished": false,
  "petsAllowed": true,
  "nearSubway": true,
  "isPrimaryMarket": false,
  "isSecondaryHouse": false,
  "isAcceptingVisits": true,
  "visitStatus": "ACCEPT_NEW",
  "address": "Avenida Pedroso de Morais",
  "neighborhood": "Pinheiros",
  "region": "Pinheiros",
  "city": "São Paulo",
  "state": "SP",
  "country": "Brasil",
  "latitude": -23.5629358,
  "longitude": -46.6917497,
  "observedAt": "2026-09-04T18:11:55.213Z",
  "error": null
}

A lista photos foi reduzida aqui para facilitar a leitura; cada execucao retorna a galeria completa. Todos os valores exibidos sao reais.

📥 Entrada · 📤 Saida · 💰 Precos · ▶️ Exemplos

Indice

• O que faz
• Por que este scraper
• Inicio rapido
• Referencia de entrada
• Referencia de saida
• Codigos de comodidades
• Executar via API e CLI
• Obter resultados
• Casos de uso
• Cobranca e limites
• Perguntas frequentes

O que faz

O actor consulta a busca de anuncios do QuintoAndar para a cidade e a operacao (venda ou aluguel) que voce escolher, aplica seus filtros (tipo de imovel, quartos, banheiros, vagas, suites, preco, area, mobiliado, pets, bairro, comodidades), pagina por todos os imoveis correspondentes e grava um registro limpo por anuncio. Precos e taxas que o QuintoAndar informa com sentinelas 0 ou -1 sao retornados como null, a galeria completa de fotos e expandida para URLs de CDN, e comodidades da unidade, comodidades do predio e condicoes especiais sao capturadas como listas para voce filtrar sem processamento extra.

A cobertura se concentra nas 13 regioes metropolitanas onde o QuintoAndar atua: Sao Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre, Brasilia, Campinas, Recife, Guarulhos, Santo Andre, Sao Bernardo do Campo, Osasco e Niteroi. Voce tambem pode colar URLs de busca do QuintoAndar diretamente como URLs iniciais.

Por que este scraper

O scraper mais completo do QuintoAndar no Apify. Retorna todos os campos que a busca do QuintoAndar expoe, alem de campos derivados que outros scrapers descartam, e aceita um conjunto completo de filtros.

Recurso	Este actor	Alternativas comuns
Aluguel, venda, condominio, IPTU e custo mensal total	Sim, tudo separado	Muitas vezes so um preco
rentPrice puro separado de totalMonthlyCost	Sim	Normalmente juntos
Rentabilidade do aluguel (rentalYield) na venda	Sim	Raramente
Galeria completa de fotos (nao so a capa)	Sim	Muitas vezes so a capa
Comodidades da unidade e do predio como listas	Sim	Parcial
Coordenadas geograficas, cidade, estado, pais	Sim	Parcial
Filtros: tipo, quartos, banheiros, vagas, suites	Sim	Parcial
Filtros: preco, area, mobiliado, pets, perto do metro	Sim	Parcial
Filtro de texto por bairro	Sim	Raramente
Aceita URLs de busca do QuintoAndar como entrada	Sim	Alguns
title legivel derivado	Sim	Alguns
Pagamento por resultado, teto de gasto, sem cobranca em falha	Sim	Varia

Toda entrada que outros scrapers populares do QuintoAndar aceitam (tipo de negocio, cidade, bairro, tipo de imovel, minimo de quartos, banheiros, vagas, faixa de preco, faixa de area, comodidades, comodidades do predio, mobiliado, pets, perto do transporte, URLs de busca) e suportada aqui, e todo campo de saida que eles retornam (id, titulo, operacao, tipo de imovel, aluguel, custo mensal total, preco de venda, taxa de condominio, IPTU, area, comodos, banheiros, vagas, bairro, cidade, estado, coordenadas, mobiliado, pets, url) e retornado aqui, alem de campos extras.

Inicio rapido

Abra o actor, cole isto na entrada e clique em Run. Retorna os 10 apartamentos a venda mais recentes em Sao Paulo.

{
  "maxListings": 10,
  "city": "sao-paulo-sp-brasil",
  "operation": "sale"
}

Defina operation como rent para alugueis. Adicione minBedrooms, minPrice, maxPrice, minArea, propertyTypes, furnished, petsAllowedOnly ou neighborhood para refinar a busca. Apenas operation e obrigatorio.

Referencia de entrada

Campo	Tipo	Obrigatorio	Padrao	Descricao
city	enum	nao	sao-paulo-sp-brasil	Cidade brasileira a pesquisar. Um dos 13 mercados cobertos, por exemplo sao-paulo-sp-brasil, rio-de-janeiro-rj-brasil. Ignorado quando URLs iniciais sao fornecidas.
operation	enum	sim	sale	Tipo de anuncio: sale (comprar) ou rent (alugar).
startUrls	array	nao	(nenhum)	Uma ou mais URLs de busca do QuintoAndar. O slug da cidade e a operacao sao lidos de cada URL e substituem city e operation.
propertyTypes	array	nao	(todos)	Restringe aos tipos: Apartamento, Casa, CasaCondominio, StudioOuKitchenette.
neighborhood	string	nao	(qualquer)	Mantem apenas anuncios cujo bairro ou regiao contem este texto (ignora acentos e maiusculas).
maxListings	integer	nao	10	Maximo de anuncios a coletar. A fonte limita a paginacao profunda perto de 1000 por consulta.
minBedrooms	integer	nao	(qualquer)	Minimo de quartos.
minBathrooms	integer	nao	(qualquer)	Minimo de banheiros.
minParkingSpaces	integer	nao	(qualquer)	Minimo de vagas de garagem.
minSuites	integer	nao	(qualquer)	Minimo de suites.
minPrice	integer	nao	(qualquer)	Preco minimo em BRL. Comparado ao preco de venda na venda, ao custo mensal total no aluguel.
maxPrice	integer	nao	(qualquer)	Preco maximo em BRL.
minArea	integer	nao	(qualquer)	Area util minima em m2.
maxArea	integer	nao	(qualquer)	Area util maxima em m2.
furnished	enum	nao	any	any, furnished ou unfurnished.
petsAllowedOnly	boolean	nao	false	Apenas anuncios que aceitam pets.
nearSubwayOnly	boolean	nao	false	Apenas anuncios perto de metro ou trem.
amenities	array	nao	(nenhum)	Exige estes codigos de comodidade da unidade (ver Codigos de comodidades).
condoAmenities	array	nao	(nenhum)	Exige estes codigos de comodidade do predio (ver Codigos de comodidades).
proxyConfiguration	object	nao	(auto)	Proxy opcional. Um proxy residencial brasileiro e usado automaticamente como reserva se a conexao direta for bloqueada.

Os filtros se combinam com E logico. Filtros de preco e bairro descartam qualquer anuncio cujo valor de referencia nao seja informado pela fonte.

Referencia de saida

Um item de dataset por anuncio. Tipos: string, integer, number, boolean, string[], ou null quando o valor da fonte esta ausente.

Campo	Tipo	Descricao
title	string	Titulo legivel derivado do tipo, quartos, bairro e cidade.
imageUrl	string	URL da imagem de capa.
photos	string[]	Galeria completa de fotos como URLs de CDN.
photosCount	integer	Numero de fotos na galeria.
amenities	string[]	Codigos de comodidade da unidade, por exemplo AR_CONDICIONADO.
installations	string[]	Codigos de comodidade do predio, por exemplo PISCINA.
specialConditions	string[]	Condicoes especiais ativas, por exemplo Exclusivity.
listingTags	string[]	Etiquetas de marketing, por exemplo NEW_AD.
id	string	ID do anuncio no QuintoAndar.
url	string	URL canonica do anuncio em quintoandar.com.br.
operation	string	sale, rent ou both.
propertyType	string	Tipo de imovel, por exemplo Apartamento, Casa.
salePrice	number	Preco de venda em BRL, ou null se nao estiver a venda.
rentPrice	number	Aluguel mensal base em BRL, ou null.
totalMonthlyCost	number	Custo mensal total em BRL (aluguel mais taxas), ou null.
currency	string	Moeda de todos os campos monetarios. Sempre BRL.
condominiumFee	number	Taxa de condominio mensal em BRL, ou null.
iptu	number	IPTU em BRL, ou null.
rentalYield	number	Estimativa de rentabilidade do aluguel informada pela fonte para anuncios de venda, ou null.
area	number	Area util em metros quadrados, ou null.
bedrooms	integer	Numero de quartos, ou null.
bathrooms	integer	Numero de banheiros, ou null.
suites	integer	Numero de suites, ou null.
parkingSpaces	integer	Numero de vagas de garagem, ou null.
isFurnished	boolean	Se a unidade e mobiliada, ou null.
petsAllowed	boolean	true quando o anuncio marca que aceita pets, senao null.
nearSubway	boolean	true quando o anuncio fica perto de metro ou trem, senao null.
isPrimaryMarket	boolean	Se o anuncio e de mercado primario (novo lancamento), ou null.
isSecondaryHouse	boolean	Se o anuncio e de mercado secundario, ou null.
isAcceptingVisits	boolean	Se o anuncio esta aceitando novas visitas, ou null.
visitStatus	string	Status bruto de disponibilidade de visita, por exemplo ACCEPT_NEW.
address	string	Endereco (ou CEP quando a rua e omitida).
neighborhood	string	Nome do bairro.
region	string	Nome da regiao informado pela fonte.
city	string	Nome da cidade informado pela fonte.
state	string	Sigla do estado, por exemplo SP.
country	string	Pais, Brasil.
latitude	number	Latitude, ou null.
longitude	number	Longitude, ou null.
observedAt	string	Data e hora ISO 8601 da coleta.
error	string	null em caso de sucesso. Em uma execucao com falha, um unico item com o campo error preenchido e gravado.

Codigos de comodidades

Passe estes codigos para amenities (unidade) ou condoAmenities (predio). Valores comuns:

• Unidade (amenities): AR_CONDICIONADO, VARANDA, MOBILIADO, PODE_TER_ANIMAIS_DE_ESTIMACAO, ARMARIOS_NA_COZINHA, ARMARIOS_EMBUTIDOS_NO_QUARTO, COOKTOP, COZINHA_AMERICANA, AREA_DE_SERVICO, BOX, QUINTAL, LUMINOSIDADE_NATURAL, VISTA_LIVRE.
• Predio (condoAmenities): PISCINA, ACADEMIA, SALAO_DE_FESTAS, PERTO_DE_METRO_OU_TREM, CHURRASQUEIRA, AREA_VERDE, LAVANDERIA_NO_PREDIO, SAUNA, RAMPAS_DE_ACESSO, VAGA_DE_GARAGEM_ACESSIVEL.

Os atalhos petsAllowedOnly e nearSubwayOnly adicionam PODE_TER_ANIMAIS_DE_ESTIMACAO e PERTO_DE_METRO_OU_TREM para voce.

Executar via API e CLI

Inicie uma execucao e leia o dataset. Substitua <TOKEN> pelo seu token de API do Apify.

Execucao sincrona, obtendo os itens do dataset em uma chamada:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~quintoandar-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"city":"sao-paulo-sp-brasil","operation":"sale","maxListings":25}'

Iniciar execucao assincrona:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~quintoandar-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"city":"rio-de-janeiro-rj-brasil","operation":"rent","minBedrooms":2,"maxPrice":5000,"petsAllowedOnly":true}'

Apify CLI:

apify call scrapers_lat/quintoandar-scraper \
  --input '{"city":"belo-horizonte-mg-brasil","operation":"sale","maxListings":50}'

Obter resultados

Cada execucao grava em um dataset. Obtenha os itens em JSON, CSV ou Excel mudando format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginar datasets grandes
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=500&limit=500"

<DATASET_ID> e retornado como defaultDatasetId no objeto da execucao.

Casos de uso

• Pesquisa de mercado imobiliario: acompanhe precos pedidos, aluguel, condominio e IPTU por bairro e cidade.
• Analise de rentabilidade: compare preco de venda e aluguel para encontrar oportunidades de investimento.
• Geracao de leads: monte listas de anuncios que combinam com um perfil de comprador ou locatario.
• Monitoramento de concorrentes e portais: acompanhe estoque e mudancas de preco ao longo do tempo.
• Enriquecimento de dados: adicione coordenadas, comodidades e fotos ao seu proprio banco de imoveis.

Cobranca e limites

• Pagamento por resultado. Voce e cobrado por registro retornado (evento result). Veja a aba de precos para o valor atual.
• Sem cobranca em falha. Se uma execucao falhar, o actor grava um unico item com o campo error preenchido e nao cobra por ele. Execucoes vazias nao custam nada.
• Teto de gasto respeitado. Defina maxTotalChargeUsd na execucao; ao ser atingido, o actor para de emitir e cobrar resultados.
• Planos gratuitos do Apify sao limitados a 10 anuncios por execucao. Faca upgrade para um maxListings maior.
• Limite de paginacao da fonte. A busca do QuintoAndar rejeita offsets a partir de 1000, entao uma consulta retorna ate cerca de 1000 anuncios. Para volumes maiores, divida o trabalho com filtros mais restritos ou varias URLs iniciais.

Perguntas frequentes

Uma execucao retornou 0 registros. Por que? A combinacao de filtros nao encontrou nada, ou a cidade nao tem anuncios ativos para aquela operacao. Afrouxe os filtros ou amplie a faixa de preco. Execucoes com zero resultados nao sao cobradas.

Quais cidades sao suportadas? As 13 regioes onde o QuintoAndar atua: Sao Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre, Brasilia, Campinas, Recife, Guarulhos, Santo Andre, Sao Bernardo do Campo, Osasco e Niteroi.

Por que alguns precos ou taxas sao null? O QuintoAndar informa precos e taxas desconhecidos com sentinelas 0 ou -1. O actor normaliza isso para null em vez de reportar um zero falso.

Qual a diferenca entre rentPrice e totalMonthlyCost? rentPrice e o aluguel mensal base. totalMonthlyCost soma a taxa de condominio, o IPTU e a taxa de servico. Em anuncios de venda, rentPrice e null.

Posso obter mais de 1000 anuncios de uma cidade? Nao em uma unica consulta; a fonte limita a paginacao profunda perto de 1000. Divida o trabalho com filtros de quartos, preco ou tipo para alcancar diferentes fatias do estoque.

Esta e uma ferramenta oficial do QuintoAndar? Nao. Este actor e independente e nao tem afiliacao com o QuintoAndar. Ele le apenas dados publicamente disponiveis em quintoandar.com.br.

Mais scrapers em scrapers.lat

Desenvolvido e mantido por scrapers.lat, onde publicamos scrapers para plataformas publicas dos EUA e da America Latina: registros de empresas, dados de governo, financas, e-commerce e mais. Explore o catalogo ou solicite um scraper sob medida em scrapers.lat.

Ferramenta independente, sem afiliacao com o QuintoAndar. Acessa apenas dados de anuncios publicamente disponiveis.