QuintoAndar Property Scraper

Collect rental and for-sale property listings from quintoandar.com.br across Brazil and turn them into clean, structured rows. Search by location name with filters, or paste results-page URLs. Every record carries the full price breakdown (rent, total monthly cost, condo fee, IPTU, sale price), the area and room counts, the exact GPS coordinate, the full description, every photo, the in-unit and building amenities, and the furnished / pets / near-subway flags.

Why This Scraper?

• 80+ fields per listing, with both English and Portuguese keys on every record so the output drops straight into any pipeline.
• Full price breakdown: rent, total monthly cost, condominium fee, IPTU, and sale price.
• Exact GPS coordinate (latitude and longitude), zip code, neighborhood, city and state.
• Full property description plus the complete photo gallery, not just a thumbnail.
• In-unit amenities and building amenities listed separately, with furnished, pets and near-subway flags.
• Two ways to run: search by location name with filters, or paste results-page URLs.
• Sort and price / area / bedroom filters, forward pagination, and a single clear Max listings cap.

Data You Get

Sample shape. Values are illustrative placeholders, not from a live listing.

Field	Example
id	100000000
title	Apartamento - 2 quartos - Pinheiros
tipoOperacao	aluguel
tipoImovel	Apartamento
precoAluguel	2500
precoTotalMensal	3200
precoVenda	0
precoCondominio	500
precoIPTU	200
area	65
quartos	2
banheiros	1
vagas	1
suites	0
bairro	Pinheiros
cidade	São Paulo
estado	São Paulo
latitude	-23.550520
longitude	-46.633309
mobiliado	false
aceitaPets	true
pertoMetro	true
comodidades	["Varanda", "Ar condicionado"]
comodidadesPredio	["Piscina", "Academia"]
imagens	["https://www.quintoandar.com.br/img/xlg/photo-1.jpeg"]
url	https://www.quintoandar.com.br/imovel/100000000/alugar

How to Use

Search by location with filters:

{
  "mode": "search",
  "locations": ["São Paulo", "Pinheiros São Paulo"],
  "operationType": "rent",
  "propertyType": "apartment",
  "minPrice": 1500,
  "maxPrice": 4000,
  "minBedrooms": 2,
  "sortBy": "price-asc",
  "fetchDetails": true,
  "maxListings": 50
}

Buy instead of rent:

{
  "mode": "search",
  "locations": ["Rio de Janeiro"],
  "operationType": "sale",
  "propertyType": "house",
  "maxListings": 30
}

Paste results-page URLs:

{
  "mode": "url",
  "urls": [
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil",
    "https://www.quintoandar.com.br/comprar/imovel/belo-horizonte-mg-brasil"
  ],
  "maxPages": 3,
  "maxListings": 100
}

Input Parameters

Parameter	Type	Description
mode	string	search builds searches from location names + filters; url reads pasted results-page URLs.
locations	array	Location names to search (search mode), e.g. São Paulo, Pinheiros São Paulo.
operationType	string	rent or sale (search mode).
propertyType	string	One of all, apartment, house, studio, condo_house (search mode).
minPrice	integer	Minimum total monthly cost (rent) or sale price, in BRL (search mode).
maxPrice	integer	Maximum total monthly cost (rent) or sale price, in BRL (search mode).
minArea	integer	Minimum area in square metres (search mode).
maxArea	integer	Maximum area in square metres (search mode).
minBedrooms	integer	Minimum number of bedrooms (search mode).
sortBy	string	relevance, price-asc or price-desc (search mode).
urls	array	Results-page URLs to read (url mode). Filter fields are ignored in this mode.
fetchDetails	boolean	Fetch each property page to add GPS, full description, amenities, condo/IPTU and floor. Default true.
maxPages	integer	Optional per-search page ceiling. Empty or 0 means unlimited; it does not cap the run.
maxListings	integer	The single hard cap on total listings. Default 20; 0 means unlimited.
proxy	object	Proxy configuration. The default works on any Apify plan.
mcpConnectors	array	Optional MCP connectors to pipe results into your apps (Notion, Linear, Airtable, Apify).
notionParentPageUrl	string	Notion page under which item pages are created (Notion connector only).
maxNotifyListings	integer	Cap on items written to each connector per run. Does not affect the dataset.

Output Example

Sample shape. Values are illustrative placeholders, not from a live listing.

{
  "id": 100000000,
  "idImovel": 100000000,
  "url": "https://www.quintoandar.com.br/imovel/100000000/alugar",
  "fonte": "quintoandar.com.br",
  "title": "Apartamento · 2 quartos · Pinheiros",
  "titulo": "Apartamento · 2 quartos · Pinheiros",
  "tipoOperacao": "aluguel",
  "tipoImovel": "Apartamento",
  "propertyType": "Apartamento",
  "modo": "rent",
  "precoAluguel": 2500,
  "precoTotalMensal": 3200,
  "precoAtual": 3200,
  "precoVenda": 0,
  "precoCondominio": 500,
  "precoIPTU": 200,
  "totalCost": 3200,
  "area": 65,
  "areaM2": 65,
  "quartos": 2,
  "banheiros": 1,
  "suites": 0,
  "vagas": 1,
  "floor": 7,
  "bairro": "Pinheiros",
  "cidade": "São Paulo",
  "estado": "São Paulo",
  "endereco": "Rua Example",
  "latitude": -23.550520,
  "longitude": -46.633309,
  "mobiliado": false,
  "aceitaPets": true,
  "pertoMetro": true,
  "descricao": "Apartamento amplo e bem localizado, com dois quartos.",
  "comodidades": ["Varanda", "Ar condicionado"],
  "comodidadesPredio": ["Piscina", "Academia"],
  "coverImage": "https://www.quintoandar.com.br/img/xlg/photo-1.jpeg",
  "imagens": [
    "https://www.quintoandar.com.br/img/xlg/photo-1.jpeg",
    "https://www.quintoandar.com.br/img/xlg/photo-2.jpeg"
  ],
  "listedAt": "2026-01-01T00:00:00.000Z",
  "coletadoEm": "2026-01-01T00:00:00Z"
}

Send results into your apps (MCP connectors)

Optionally pipe each result into the apps you already use through Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it in the mcpConnectors field. Each connector receives a condensed, human-readable summary per item (title plus key fields); the complete record always stays in the dataset. Supported connectors include Notion, Linear, Airtable and Apify. For Notion, set notionParentPageUrl to the page under which item pages should be created, and use maxNotifyListings to cap how many items are written per run.

Plan Requirement

This actor runs on any Apify plan, including the free tier.

On the free tier (or when Apify Proxy is turned off), the run automatically uses a shared backup connection so it still works without a paid proxy. That connection rotates on its own but can be rate-limited, so results may come back more slowly or thin out. If you select a datacenter proxy pool it is cheaper but more likely to be blocked by the site, which can also reduce the number of results. For the most reliable, complete results, run on a plan with a residential proxy pool. The run logs a short note when it is using a backup or datacenter connection.