QuintoAndar Scraper

Pull rent and for-sale property listings from QuintoAndar — Brazil's largest digital real-estate marketplace — with all-in monthly costs, exact GPS coordinates, room counts, amenities, and photos for every apartment, house, condo-house, and studio. A single São Paulo search alone covers 40,000+ live listings. Built for Brazilian real-estate investors, proptech teams, and relocation services who need fresh listing data without copy-pasting from quintoandar.com.br one card at a time.

Why This Scraper?

• All-in monthly cost on every rental — totalCost already bundles base rent + condominium fee + IPTU property tax + service fee into one number, so you compare what tenants actually pay, not a misleading headline rent.
• 40,000+ listings reachable per city search — drains a full São Paulo or Rio de Janeiro result set across as many pages as you need, up to 50,000 listings in a single run.
• Exact GPS coordinates on every listing — lat and lng for each property, ready to drop straight onto a map or run radius and proximity analysis.
• Rent and for-sale in one actor — flip operation between "For Rent (Alugar)" and "For Sale (Comprar)"; sale runs return salePrice, rent runs return totalCost, both return iptu.
• Four property types mirrored from QuintoAndar — Apartment (Apartamento), House (Casa), House in condominium (Casa de condomínio), and Studio / Kitnet, or "Any type" to pull everything.
• Eight live filters that match QuintoAndar's own search — price range (BRL), bedroom counts, area range (m²), pet-friendly, furnished, and near-subway, all applied at the source so you never collect — or pay for — listings you filter out.
• Amenities translated to clean English — Portuguese codes like SALAO_DE_FESTAS and PERTO_DE_METRO_OU_TREM arrive as "Party room" and "Near subway or train", deduplicated and sorted.
• No-code guided search or paste a URL — describe a city and filters and the actor builds the QuintoAndar search for you, or paste one or more search URLs you already filtered on the site and get exactly those results.

Use Cases

Market Research

• Track median and average all-in rent across São Paulo, Rio de Janeiro, and Belo Horizonte neighbourhoods
• Compare apartment vs. house vs. studio inventory across Brazilian cities
• Monitor how many furnished, pet-friendly, or near-metro listings exist in a given zone
• Build neighbourhood-level supply dashboards from region and address data

Investment Analysis

• Calculate price per square metre from salePrice and area across districts
• Compare rental totalCost against salePrice in the same area to estimate gross yield
• Map listings by GPS coordinates to spot under-supplied micro-markets
• Track IPTU property-tax burden by neighbourhood with the iptu field

Lead Generation & Aggregation

• Power a property comparison or aggregation site with normalized QuintoAndar inventory
• Feed a relocation or corporate-housing platform with furnished, near-subway rentals
• Surface new-development (primary market) units for buyer outreach
• Build alerting on listings matching a saved set of filters

Relocation & Tenant Services

• Shortlist pet-friendly, furnished apartments near a subway line for relocating employees
• Compare true monthly cost (not just rent) across candidate neighbourhoods
• Export listing photos, amenities, and addresses into a client-ready spreadsheet
• Filter by bedroom count and area to match family-size requirements

Getting Started

Search a City (simplest)

Just say what you want and the actor builds the QuintoAndar search:

{
    "operation": "rent",
    "location": "São Paulo, SP",
    "maxResults": 100
}

Filtered Search

Furnished, pet-friendly two-bedroom apartments near a subway, within a budget:

{
    "operation": "rent",
    "location": "Rio de Janeiro, RJ",
    "propertyType": "apartment",
    "bedrooms": ["2", "3"],
    "priceMax": 5000,
    "areaMin": 60,
    "acceptsPets": true,
    "furnished": true,
    "nearSubway": true,
    "maxResults": 500
}

Paste Search URLs (advanced)

Filter directly on quintoandar.com.br, then paste the URLs — including full photo galleries:

{
    "startUrls": [
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/apartamento/2-quartos/aceita-pets",
        "https://www.quintoandar.com.br/comprar/imovel/belo-horizonte-mg-brasil/casa"
    ],
    "includePhotos": true,
    "maxResults": 1000
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
startUrls	array	[]	One or more QuintoAndar search-results URLs. The fastest path — when provided, the guided "Build a Search" fields are ignored.

Build a Search

Parameter	Type	Default	Description
operation	string	"rent"	"For Rent (Alugar)" or "For Sale (Comprar)". Used only when no Search URLs are provided.
location	string	"São Paulo, SP"	City, optionally with its state — e.g. "São Paulo, SP", "Rio de Janeiro, RJ", "Belo Horizonte, MG". Accents recommended.
propertyType	string	"apartment"	"Any type", "Apartment (Apartamento)", "House (Casa)", "House in condominium (Casa de condomínio)", or "Studio / Kitnet".

Filters

Parameter	Type	Default	Description
priceMin	integer	null	Minimum price in BRL — monthly cost when renting, total price when buying.
priceMax	integer	null	Maximum price in BRL.
bedrooms	array	[]	Bedroom counts to include: "1 bedroom", "2 bedrooms", "3 bedrooms", "4 or more bedrooms". Combine several.
areaMin	integer	null	Minimum total area in square metres.
areaMax	integer	null	Maximum total area in square metres.
acceptsPets	boolean	false	Only pet-friendly listings.
furnished	boolean	false	Only furnished listings.
nearSubway	boolean	false	Only listings near a metro/subway station.

Photos & Limits

Parameter	Type	Default	Description
includePhotos	boolean	false	Every listing already includes its cover photo. Turn this on to also collect the full gallery (up to 40 photos per listing).
maxResults	integer	100	Maximum listings to collect across all searches and URLs. Set to 0 for no cap (a safety limit of 50,000 then applies).

Output

Each listing is one flat row. Example (rent):

{
    "id": "894231007",
    "url": "https://www.quintoandar.com.br/imovel/894231007",
    "type": "Apartamento",
    "operation": "rent",
    "forRent": true,
    "forSale": false,
    "status": "ACTIVE",
    "totalCost": 4180,
    "salePrice": null,
    "iptu": 95,
    "area": 72,
    "bedrooms": 2,
    "bathrooms": 2,
    "suites": 1,
    "furnished": true,
    "isPrimaryMarket": false,
    "address": {
        "street": "Rua Augusta",
        "neighborhood": "Consolação",
        "city": "São Paulo",
        "state": "SP",
        "countryCode": "BR",
        "lat": -23.5523,
        "lng": -46.6621
    },
    "region": "Centro",
    "amenities": ["Air conditioning", "Gym", "Near subway or train", "Pool"],
    "specialConditions": ["FIRST_MONTH_DISCOUNT"],
    "categories": ["FURNISHED"],
    "parkingSpaces": 1,
    "coverPhoto": "https://www.quintoandar.com.br/img/abc123.jpg",
    "photos": ["https://www.quintoandar.com.br/img/abc123.jpg"],
    "yield": null,
    "sourceSearchUrl": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/apartamento",
    "scrapedAt": "2026-05-30T14:02:11.482000+00:00"
}

Core Fields

Field	Type	Description
id	string	QuintoAndar internal listing id
url	string	Canonical listing URL on quintoandar.com.br
type	string	Property type in Portuguese (Apartamento, Casa, etc.)
operation	string	"rent" or "buy"
forRent	boolean	Available for rent
forSale	boolean	Available for sale
status	string	Listing/visit status
isPrimaryMarket	boolean	New development (primary market) unit

Pricing (BRL)

Field	Type	Description
totalCost	number	All-in monthly cost — base rent + condominium fee + IPTU + service fee
salePrice	number	Total sale price (for-sale listings); null for rentals
iptu	number	Monthly IPTU property tax; null when unknown
yield	number	Estimated gross yield when QuintoAndar provides it

Property Details

Field	Type	Description
area	number	Total usable area in square metres
bedrooms	integer	Number of bedrooms
bathrooms	integer	Number of bathrooms
suites	integer	Number of en-suite bedrooms
parkingSpaces	integer	Number of parking spaces
furnished	boolean	Comes furnished
amenities	array	Building and unit amenities as clean English labels
specialConditions	array	Active promotions (e.g. first-month discount)
categories	array	QuintoAndar listing category tags

Address & Location

Field	Type	Description
address.street	string	Street name
address.neighborhood	string	Neighbourhood
address.city	string	City (resolved server-side)
address.state	string	Two-letter Brazilian state code
address.countryCode	string	Always "BR"
address.lat	number	Latitude
address.lng	number	Longitude
region	string	Region / zone name

Media & Provenance

Field	Type	Description
coverPhoto	string	Full URL of the main cover photo (always included)
photos	array	Full gallery URLs (up to 40 per listing) when includePhotos is on; otherwise just the cover
sourceSearchUrl	string	The search URL this listing came from
scrapedAt	string	ISO timestamp the row was collected

Tips for Best Results

• totalCost is already the full monthly bill — it bundles base rent, condominium fee, IPTU, and service fee, so there's no need to sum line items to compare listings.
• Paste a URL with filters already applied — filter on quintoandar.com.br until the results look right, then copy the browser URL into startUrls to mirror exactly what you see.
• Start small, then scale — run 50–100 results first to confirm the city and filters resolve, then raise maxResults (or set 0) for the full drain.
• Leave the cover photo and skip the gallery for big runs — every listing already ships its coverPhoto for free; turning on includePhotos adds one request per listing and makes large runs noticeably slower.
• Use accents in city names — "São Paulo, SP" and "Rio de Janeiro, RJ" resolve most reliably; adding the state code disambiguates same-named cities.
• Bedroom selection is a floor, not an exact match — choosing "2 bedrooms" and "3 bedrooms" returns everything with two or more bedrooms, mirroring QuintoAndar's own minimum-bedroom search.
• For yield analysis, pair a rent run and a buy run in the same neighbourhood — divide annualized totalCost by salePrice to estimate gross rental yield.

Pricing

$1.30 per 1,000 results — undercuts comparable QuintoAndar actors while returning a cleaner, normalized listing object. No compute charges — you only pay per result returned.

Results	Estimated Cost
100	$0.13
1,000	$1.30
10,000	$13.00
100,000	$130.00

A "result" is one property listing row in your dataset. Standard Apify platform fees may apply on top of the per-result price.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor collects publicly available property-listing data for legitimate research, analysis, and aggregation. You are responsible for using it in compliance with QuintoAndar's terms of service, applicable laws, and Brazil's data-protection regulations (LGPD). Do not use collected data to harass individuals, send unsolicited communications, or for any unlawful purpose. Always respect the rights of property owners, agents, and platform operators.