Quinto Andar Scraper

Extract property listings from Quinto Andar, one of Brazil's largest real estate platforms for buying and renting properties.

This actor uses a real browser to access Quinto Andar's internal API, returning clean, structured property data with full filter support and proper pagination.

🔑 Key Features

• Full filter support — area, price, bedrooms, bathrooms, parking, furnished, pets, subway proximity
• Rent & Sale — works for both alugar and comprar searches
• Proper pagination — fetches all results up to your limit, not just the first page
• Cloudflare bypass — uses a real browser fingerprint; no proxy required
• Pay Per Property — only pay for what you get ($0.001 per property = $1 per 1,000)

💰 Pricing

Event	Price
Property scraped	$0.001
Actor start	$0.00005

Example: 500 properties = ~$0.50

📋 Input

Required

Field	Type	Description
location	string	City name or Quinto Andar search URL
searchType	"rent" / "buy"	Type of search (default: "rent")

Location examples:

• City name: São Paulo / Rio de Janeiro / Belo Horizonte
• URL: https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil

Optional Filters

Field	Default	Description
maxItems	100	Max properties to return
apartments	true	Include apartments
houses	true	Include houses
condominiumHouses	true	Include condominium houses
studioApartments	true	Include studios
minArea	20	Min area (m²)
maxArea	10000	Max area (m²)
minPrice	0	Min price (R$)
maxPrice	20000000	Max price (R$)
rentValueType	"total"	"total" (rent+condo+IPTU) or "rentOnly"
minCondoPrice	—	Min condo fee R$ (buy only)
maxCondoPrice	—	Max condo fee R$ (buy only)
minBedrooms	—	Min bedrooms (1 = 1+, 2 = 2+, etc.)
minBathrooms	—	Min bathrooms (1–4)
minGarages	—	Min parking spaces
minSuits	—	Min suites
furnished	both	"yes" / "no" / null
closeToSubway	both	"yes" / "no" / null
acceptPets	both	"yes" / "no" / null
availability	both	"available" / "unavailable" / null
neighborhoods	—	Array of neighborhood names to filter by (e.g. ["Pinheiros", "Vila Madalena"])
maxDaysOld	—	Only return properties listed within the last N days

Example Input (JSON)

{
    "location": "São Paulo",
    "searchType": "rent",
    "maxItems": 200,
    "minBedrooms": 2,
    "maxPrice": 4000,
    "furnished": "yes",
    "acceptPets": "yes",
    "closeToSubway": "yes",
    "neighborhoods": ["Pinheiros", "Vila Madalena", "Moema"]
}

📦 Output

Each property is returned as a JSON object:

{
    "id": "abc123",
    "title": "Apartamento 2 quartos - Pinheiros",
    "address": "Rua Aspicuelta, 123 - Pinheiros, São Paulo",
    "neighborhood": "Pinheiros",
    "city": "São Paulo",
    "state": "SP",
    "propertyType": "APARTMENT",
    "area": 65,
    "bedrooms": 2,
    "bathrooms": 1,
    "parkingSpaces": 1,
    "suites": 1,
    "floor": 3,
    "rent": 2800,
    "condoFee": 450,
    "iptu": 120,
    "totalCost": 3370,
    "salePrice": null,
    "furnished": true,
    "acceptPets": true,
    "closeToSubway": true,
    "availability": "available",
    "listedAt": "2026-02-15T10:30:00Z",
    "coverImage": "https://media.quintoandar.com.br/mobi/media/abc123/extra_large/",
    "url": "https://www.quintoandar.com.br/imovel/abc123"
}

🏙️ Supported Cities

São Paulo, Rio de Janeiro, Belo Horizonte, Porto Alegre, Brasília, Curitiba, Goiânia, Campinas, Florianópolis, Salvador, Fortaleza, Recife, Manaus, Belém, Guarulhos, Niterói, Osasco, Santo André, São Bernardo do Campo, São José dos Campos, Santos, Ribeirão Preto, Sorocaba, Uberlândia, Contagem, Betim, and 50+ more.

⚙️ Technical Details

• Stack: Node.js + puppeteer-real-browser
• Anti-bot bypass: Real Chrome fingerprint (no proxy needed)
• Pagination: Intercepts Quinto Andar's internal search API and replays paginated requests
• Runtime: ~60–120 seconds per run depending on the number of properties requested

📝 Notes

• Quinto Andar requires JavaScript — this actor uses a real browser, not a simple HTTP client
• Run times may vary based on Quinto Andar's server load and anti-bot measures
• If the actor is marked as "under maintenance", it means Quinto Andar changed their frontend. Please open an issue and we'll fix it promptly.