# QuintoAndar Scraper: Price per m² & Rental Yield (`roomy_tweet/quintoandar-scraper`) Actor Scrape QuintoAndar listings for sale and rent in any Brazilian city or neighborhood, past the 1,000-result limit. Each listing comes with price per m², rent per m², gross rental yield and the "Ótimo preço" badge, plus median prices per neighborhood. Export to Excel, CSV or JSON, or use the API. - **URL**: https://apify.com/roomy_tweet/quintoandar-scraper.md - **Developed by:** [roomy_tweet](https://apify.com/roomy_tweet) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README **QuintoAndar Scraper** extracts listings for sale and for rent from [QuintoAndar](https://www.quintoandar.com.br), one of Brazil's largest real estate platforms, for **any neighborhood or whole city**: São Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre and every other city QuintoAndar covers. Type a place like `Pinheiros, São Paulo, SP`, press Start, and get a spreadsheet of apartments and houses with **price per m², rent per m², gross rental yield and QuintoAndar's own "Ótimo preço" badge** already calculated, plus median prices for every neighborhood. > **Not affiliated with QuintoAndar.** This is an independent tool. It is not endorsed by, sponsored by or connected to QuintoAndar or its owners. "QuintoAndar" is a trademark of its owner and is used here only to describe where the data comes from. ### What is QuintoAndar Scraper? A tool that turns QuintoAndar's public listings into **Brazil real estate data ready for analysis**, without code: - 📍 **Every listing of the place**, not only the first 1,000 that a QuintoAndar search shows. Big searches are split into price and area ranges until everything fits. - 🎯 **Only the place you asked for.** A plain QuintoAndar search for Pinheiros mixes in Butantã, Sumarezinho and other neighbors; this Actor keeps Pinheiros. - 📈 **Investor metrics on every listing:** price per m², rent per m², gross yield per year, payback in years and condo + IPTU as a share of the rent. - 🏷️ **QuintoAndar's badges as columns:** "Ótimo preço" (good price), "Comprar já alugado" (sold with a tenant), new listing, rent reduced. - 🏘️ **Neighborhood summary:** median price per m² (with 25th and 75th percentiles), median rent, rent per m², yield and area for each neighborhood. - 🔎 **Optional details:** days on market, floor, CEP, condominium name, doorman and facilities, fire insurance and service fee, photos labelled by room and video links. - ⚡ **Fast and light:** plain HTTP requests, no browser and no proxy. All of Pinheiros, São Paulo (about 4,000 listings for sale and rent) took 37 requests and 13 seconds on the Apify platform. Because it runs on Apify, you also get the platform: **API access**, **scheduled runs** for daily monitoring, **integrations** (Make, Zapier, n8n, Google Drive, webhooks) and **exports to Excel, CSV, JSON or HTML**. ### What data can you extract from QuintoAndar? | Data | Fields | | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Prices | `salePrice`, `rent`, `condoAndIptu`, `iptu`, `totalMonthlyCost` (rentals) | | Investor metrics | `pricePerM2`, `monthlyRent`, `rentSource`, `rentPerM2`, `grossYieldAnnualPct`, `paybackYears`, `condoIptuShareOfRentPct` | | Property | `propertyType` (apartment, house, gated-community house, studio), `area`, `bedrooms`, `bathrooms`, `suites`, `parkingSpaces`, `furnished`, `isNewDevelopment` | | Location | `street`, `neighborhood`, `region`, `city`, `latitude`, `longitude` | | QuintoAndar badges | `listingTags`, `goodPrice`, `buyRented`, `newListing`, `rentPriceDecreased`, `availableWhenLeaseEnds` | | Listing | `url`, `dealTypes` (sale, rent or both), `listingSource`, `description`, `coverImageUrl`, `photos`, `amenities`, `buildingAmenities` | | Details add-on | `zipCode`, `condoFee`, `iptu`, `condominiumName`, `floorMin`, `floorMax`, `doorman`, `condominiumAmenities`, `fireInsurance`, `serviceFee`, `firstPublishedAt`, `daysOnMarket`, `roomPhotos`, `videoUrls`, `nearSubway`, `nearbyPlaces` | ### How to scrape QuintoAndar 1. Open **QuintoAndar Scraper** and click **Try for free**. 2. In **Locations**, type one place per line: a neighborhood (`Pinheiros, São Paulo, SP`), a city (`Curitiba, PR`) or the URL of a QuintoAndar search. 3. Choose **For sale**, **For rent** or **Both**. 4. Set **Max listings**, or `0` for every listing of every location. 5. Optionally add filters (price, rent, bedrooms, area, property type) and turn on **Include listing details**. 6. Click **Start**, then download the results as Excel, CSV or JSON, or open the **Investor overview** table. #### Input example Every apartment for sale up to R$ 800,000 in two neighborhoods, with details: ```json { "locations": ["Pinheiros, São Paulo, SP", "Copacabana, Rio de Janeiro, RJ"], "dealType": "sale", "maxListings": 0, "maxSalePrice": 800000, "propertyTypes": ["apartment"], "includeDetails": true } ``` | Field | Description | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ | | `locations` | Neighborhoods, cities or QuintoAndar search URLs. The state (UF) is required: `Vila Madalena, São Paulo, SP`, `Belo Horizonte - MG`. | | `dealType` | `sale`, `rent` or `both`. A search URL keeps its own choice. | | `maxListings` | Stop after this many listings in total (default 500). `0` = all. | | `onlyInsideLocation` | Keep only listings in the requested neighborhood or city (on by default). | | `includePartnerListings` | Also return partner-portal listings shown on QuintoAndar (off by default). | | `minSalePrice` / `maxSalePrice`, `minRent` / `maxRent` | Price filters in R$. | | `minBedrooms`, `minArea`, `maxArea`, `propertyTypes` | Property filters. | | `includeDetails` | Details add-on (see below). | | `includePhotos` | All photo URLs, not only the cover. | | `includeNeighborhoodSummary` | Save the neighborhood medians (on by default, free). | ### Output example One row per listing. A real listing from Pinheiros, São Paulo, shortened: ```json { "url": "https://www.quintoandar.com.br/imovel/894885875/comprar", "dealTypes": ["sale"], "propertyType": "apartment", "salePrice": 1555000, "condoAndIptu": 2350, "area": 120, "bedrooms": 3, "bathrooms": 2, "parkingSpaces": 2, "street": "Rua João Moura", "neighborhood": "Pinheiros", "city": "São Paulo", "latitude": -23.5598575, "longitude": -46.6779404, "pricePerM2": 12958, "monthlyRent": 6390, "rentSource": "estimate", "rentPerM2": 53.25, "grossYieldAnnualPct": 4.93, "paybackYears": 20.3, "condoIptuShareOfRentPct": 36.8, "listingTags": ["NEW_AD", "SALE_GOOD_PRICE"], "goodPrice": true, "newListing": true, "details": { "zipCode": "05412-001", "condoFee": 2100, "iptu": 250, "condominiumName": "San Paolo", "floorMin": 4, "floorMax": 7, "doorman": "NightAndDayShift", "condominiumAmenities": ["AREA_VERDE", "ACADEMIA", "ELEVADOR", "SALAO_DE_FESTAS"], "firstPublishedAt": "2025-04-24T19:58:33.000Z", "daysOnMarket": 544, "videoUrls": ["https://vimeo.com/1078454775/4e18654758"], "roomPhotos": [ { "room": "Sala", "url": "https://www.quintoandar.com.br/img/med/original894885875-341.10063881822197IMG5867.jpeg" } ] } } ``` #### How the investor metrics are calculated | Field | Formula | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | `pricePerM2` | sale price / area | | `monthlyRent` | the asking rent when the property is also for rent; otherwise the rent of its current lease or QuintoAndar's own estimate | | `rentSource` | `listed` (asking rent), `contract` (current lease) or `estimate` (QuintoAndar's rent calculator) | | `rentPerM2` | monthlyRent / area | | `grossYieldAnnualPct` | monthlyRent × 12 / sale price × 100 | | `paybackYears` | sale price / (monthlyRent × 12) | | `condoIptuShareOfRentPct` | (condo + IPTU) / monthlyRent × 100: high values make a property harder to rent | Yields are **gross**: before vacancy, income tax, maintenance and agency fees. Prices and areas are as advertised, and a few listings have typos (60,000 m² apartments), so prefer medians to averages. #### QuintoAndar's badges | Column | Badge | Meaning | | ------------------------ | ---------------------- | ------------------------------------------------------------ | | `goodPrice` | `SALE_GOOD_PRICE` | "Ótimo preço": QuintoAndar rates the asking price as good | | `buyRented` | `BUY_RENTED` | "Comprar já alugado": sold with a tenant already paying rent | | `newListing` | `NEW_AD` | recently published | | `rentPriceDecreased` | `RENT_PRICE_DECREASED` | the rent was lowered | | `availableWhenLeaseEnds` | `RENT_ON_TERMINATION` | rental free when the current lease ends | On 23 October 2026, 254 of the 3,149 listings for sale in Pinheiros had "Ótimo preço", at a median of R$ 14,760 per m² against R$ 18,462 for the neighborhood. #### Neighborhood summary Saved as the key-value store record `NEIGHBORHOOD_SUMMARY` (linked in the run's **Output** tab), one row per neighborhood: ```json { "city": "São Paulo", "neighborhood": "Pinheiros", "listings": 4034, "forSale": 3149, "forRent": 2099, "goodPriceListings": 254, "medianSalePrice": 869500, "medianPricePerM2": 18462, "p25PricePerM2": 14050, "p75PricePerM2": 22785, "medianRent": 3750, "medianRentPerM2": 106.65, "medianGrossYieldAnnualPct": 5.68, "medianArea": 45 } ``` Rent medians use asking rents only, never estimates. The yield median uses every listing for sale. #### Details add-on Turn on **Include listing details** to open each listing's page. You also get days on market and publication dates, floor, CEP, condominium name, doorman and facilities, condo fee and IPTU separately, fire insurance and service fee for rentals, every photo with the room QuintoAndar labelled it with, video links, the near-subway flag and nearby schools and parks. In a sample of 200 Pinheiros listings, 107 had a video and 112 had photos labelled by room. ### How much does it cost to scrape QuintoAndar? You pay per result, and platform usage is included: | Event | Price | Per 1,000 | | -------------------------------------- | ---------- | --------- | | Listing | US$ 0.0015 | US$ 1.50 | | Listing details (only with the add-on) | US$ 0.0005 | US$ 0.50 | Examples: - **One neighborhood, everything** (Pinheiros, about 4,000 listings for sale and rent): about **US$ 6**, or US$ 8 with details. - **Daily monitoring** of the newest 100 listings of a neighborhood: about **US$ 0.15 a day**. - **Free plan:** Apify's monthly US$ 5 of free credit covers about **3,300 listings**, enough to analyse a whole neighborhood. Listings left out as outside the location and the neighborhood summary are free. Set a **maximum cost per run** in the run options and the Actor stops when it is reached. The **Pricing** tab always shows the current price. ### Use cases - 🏠 **Buy-to-let screening:** rank a neighborhood by gross yield or price per m², and filter what QuintoAndar itself marks as "Ótimo preço" or already rented. - 📊 **Market research:** price per m² and rent per m² by neighborhood, for sale and for rent, in one run. - 🔔 **Monitoring:** listings come newest first, so a scheduled run with a small limit brings what was published since the last one. - 🧮 **Valuation:** comparables with area, rooms, parking, condo fee, IPTU and coordinates. ### Good to know - **Partner listings.** Besides its own listings, QuintoAndar shows listings from partner portals: in Pinheiros, 8,366 own and 13,302 partner listings for sale (21 October 2026). They are off by default because they have price, area, rooms, address and coordinates but no rent estimate, so no yield unless the property is also for rent, and some are the same property advertised by several agencies. Turn on `includePartnerListings` to get them; they come with `listingSource: "partner"`, without the details add-on. - **Only the place you asked for.** QuintoAndar's search also returns listings around a place; a São Paulo search includes Santo André, Guarulhos and Osasco. With `onlyInsideLocation` on, those are left out and not charged. - **Place names.** Write them as QuintoAndar does, with the state. If a place is not found, the log says so; pasting a QuintoAndar search URL always works. - **Very dense prices.** When more than 1,000 listings share exactly one price and one area (rare), only 1,000 of them can be reached; the log reports it. - `maxListings` is a total across all locations, filled in the order you list them. ### FAQ #### Is it legal to scrape QuintoAndar? The Actor reads only public listing pages that anyone can open without logging in. It does not collect owners' or agents' names or contacts, and phone numbers or e-mails written inside listing descriptions are replaced with `[contato removido]`. You are responsible for how you use the data; check QuintoAndar's terms and Brazil's LGPD for your use case. #### Is there a QuintoAndar API? QuintoAndar has no public API for listings. This Actor works as one: start it and read the results with the [Apify API](https://docs.apify.com/api/v2), the Python or JavaScript clients, or from Make, Zapier or n8n. #### Can I monitor new listings every day? Yes. Create a **schedule** in Apify with a small `maxListings`: listings come newest first, and `newListing` marks those QuintoAndar flags as new. #### Why did I get fewer listings than the QuintoAndar website shows? The website counts partner listings and listings around the place. Turn on `includePartnerListings`, or turn off `onlyInsideLocation`, to get those too. #### Does it need a login, cookies or proxies? No. It uses the same public data the website loads, with plain HTTP requests. #### Can you add a field or another website? Open an issue on the **Issues** tab and describe what you need. ### More scrapers from the same developer - [Argentina Real Estate Scraper: Zonaprop + Argenprop](https://apify.com/roomy_tweet/zonaprop-argenprop-scraper): the same kind of real estate data for Argentina, with price per m². - [Leads de Empresas CNPJ](https://apify.com/roomy_tweet/cnpj-leads): Brazilian companies by CNAE and city from Receita Federal data. - [iFood Restaurant Scraper](https://apify.com/roomy_tweet/ifood-scraper): Brazilian restaurants with menus, reviews and CNPJ. - [Google Jobs Scraper](https://apify.com/roomy_tweet/google-jobs-scraper): job listings with salaries and direct apply links. ### QuintoAndar scraper em português **Extraia imóveis à venda e para alugar do QuintoAndar** em qualquer bairro ou cidade inteira (São Paulo, Rio de Janeiro, Belo Horizonte, Curitiba, Porto Alegre e as demais cidades do QuintoAndar), sem programar e sem o limite de 1.000 resultados por busca. **Não é afiliado ao QuintoAndar**: é uma ferramenta independente, sem patrocínio, endosso ou vínculo com o QuintoAndar ou seus donos. **O que vem em cada imóvel:** - preço de venda, aluguel, condomínio + IPTU, área, quartos, banheiros, vagas, endereço, bairro e coordenadas; - **preço do m², aluguel do m², rentabilidade bruta anual e payback**, com a origem do aluguel usado (anunciado, contrato atual ou estimativa do QuintoAndar); - as etiquetas do QuintoAndar: **"Ótimo preço"**, **"Comprar já alugado"**, anúncio novo, aluguel reduzido; - com o extra de detalhes: tempo de anúncio, andar, CEP, nome do condomínio, portaria e lazer do condomínio, seguro incêndio e taxa de serviço, fotos por cômodo e vídeo. No fim, o **resumo por bairro** traz as medianas de preço do m², aluguel, rentabilidade e área. **Como usar:** 1. Em **Locations**, escreva um lugar por linha: `Pinheiros, São Paulo, SP`, `Curitiba, PR` ou a URL de uma busca do QuintoAndar. 2. Escolha venda, aluguel ou os dois, e quantos imóveis quer (`0` = todos). 3. Clique em **Start** e baixe em Excel, CSV ou JSON. **Quanto custa:** US$ 1,50 a cada mil imóveis, mais US$ 0,50 a cada mil se ligar os detalhes. Um bairro inteiro como Pinheiros (cerca de 4 mil imóveis) sai por uns US$ 6. Os US$ 5 de crédito grátis do plano gratuito da Apify dão cerca de 3.300 imóveis por mês. **Ideal para** investidores que procuram rentabilidade, imobiliárias que acompanham o mercado e analistas que montam relatórios ou avaliações de imóveis. # Actor input Schema ## `locations` (type: `array`): Where to search. Each line is a neighborhood ("Pinheiros, São Paulo, SP"), a city ("Curitiba, PR") or the URL of a QuintoAndar search (https://www.quintoandar.com.br/comprar/imovel/...). Every listing of the place is reachable, past QuintoAndar's limit of 1,000 results per search. ## `dealType` (type: `string`): Listings for sale, for rent, or both. A QuintoAndar search URL keeps its own choice. ## `maxListings` (type: `integer`): Stop after this many listings in total. 0 = all the listings of every location (São Paulo alone has over 170,000 for sale). ## `onlyInsideLocation` (type: `boolean`): QuintoAndar's search for a place also returns listings around it: a Pinheiros search has 8,300 listings for sale, of which 3,100 are in Pinheiros; a São Paulo search includes Santo André, Guarulhos, Osasco... Leave this on to keep only listings in the requested neighborhood or city. Left-out listings are not charged. ## `includePartnerListings` (type: `boolean`): Besides its own listings, QuintoAndar shows listings from partner portals (in Pinheiros, São Paulo: 8,300 own and 13,300 partner listings for sale). Partner listings have price, area, rooms, address and coordinates, but no rent estimate (so no yield unless they are also for rent), and some are the same property listed twice. Each one is charged as a listing. ## `minSalePrice` (type: `integer`): For sale listings only. 0 = no minimum. ## `maxSalePrice` (type: `integer`): For sale listings only. 0 = no maximum. ## `minRent` (type: `integer`): For rent listings only, rent alone (without condo and IPTU). 0 = no minimum. ## `maxRent` (type: `integer`): For rent listings only, rent alone (without condo and IPTU). 0 = no maximum. ## `minBedrooms` (type: `integer`): 0 = any. ## `minArea` (type: `integer`): 0 = no minimum. ## `maxArea` (type: `integer`): 0 = no maximum. ## `propertyTypes` (type: `array`): Leave empty for all types. ## `includeDetails` (type: `boolean`): Opens each of QuintoAndar's own listings for days on market, publication dates, floor, CEP, condominium name, doorman and facilities, condo fee and IPTU separately, fire insurance and service fee (rentals), photos labelled by room, video links, near-subway flag and nearby places. Charged per listing as a separate event; about two extra requests per listing. Partner listings are delivered without it and not charged for it. ## `includePhotos` (type: `boolean`): Every listing has its cover photo URL; turn this on for all its photos. ## `includeNeighborhoodSummary` (type: `boolean`): At the end of the run, save medians per neighborhood (price per m², rent per m², gross yield, area) to the key-value store record NEIGHBORHOOD_SUMMARY. Free. ## `maxRequestsPerMinute` (type: `integer`): Upper limit of requests to QuintoAndar. The Actor also slows down by itself if QuintoAndar asks it to. ## Actor input object example ```json { "locations": [ "Pinheiros, São Paulo, SP" ], "dealType": "sale", "maxListings": 500, "onlyInsideLocation": true, "includePartnerListings": false, "minSalePrice": 0, "maxSalePrice": 0, "minRent": 0, "maxRent": 0, "minBedrooms": 0, "minArea": 0, "maxArea": 0, "propertyTypes": [], "includeDetails": false, "includePhotos": false, "includeNeighborhoodSummary": true, "maxRequestsPerMinute": 240 } ``` # Actor output Schema ## `results` (type: `string`): No description ## `neighborhoodSummary` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "locations": [ "Pinheiros, São Paulo, SP" ] }; // Run the Actor and wait for it to finish const run = await client.actor("roomy_tweet/quintoandar-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "locations": ["Pinheiros, São Paulo, SP"] } # Run the Actor and wait for it to finish run = client.actor("roomy_tweet/quintoandar-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "locations": [ "Pinheiros, São Paulo, SP" ] }' | apify call roomy_tweet/quintoandar-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,roomy_tweet/quintoandar-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/FgnNF7K11AQ2y4NgX/builds/V7m19hXhQYItKKu58/openapi.json