# QuintoAndar Scraper - Property Listings, Prices & Amenities (`abotapi/quintoandar-scraper`) Actor

Scrape QuintoAndar property listings across Brazil with 80+ fields, including rent, sale price, condo fees, IPTU, area, rooms, parking, GPS, photos, amenities, and descriptions. Supports search, URLs, sorting, and price, area, and bedroom filters.

- **URL**: https://apify.com/abotapi/quintoandar-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 4 total users, 1 monthly users, 98.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 property results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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: Rentals, Sales, Prices & GPS

QuintoAndar Scraper turns quintoandar.com.br into structured property data. Search rental and for-sale listings across Brazil by location name with price, area and bedroom filters, or paste results-page URLs straight from your browser. Every enriched record carries the full price breakdown (rent, total monthly cost, condominium fee, IPTU, sale price), the area and room counts, the exact GPS coordinate, the full description, the complete photo gallery, in-unit and building amenities, and the furnished / pets-allowed / near-subway flags, in both English and Portuguese field names. Export to JSON, CSV or Excel, pull it through the API, or pipe results into the apps you already use.

### Why This Scraper?

- **80+ fields per listing.** English and Portuguese keys, so records drop straight into any pipeline.
- **Full price picture.** Rent, total monthly cost, condominium fee, IPTU and sale price side by side.
- **Exact location.** GPS coordinate, postal code, neighborhood, city and state on every enriched listing.
- **Photos and description.** The complete gallery and full property description, not just a card thumbnail.
- **Rich amenities.** In-unit and building amenities listed separately, plus furnished, pets-allowed and near-subway flags.
- **Two ways in, built for monitoring.** Search by location name, or paste results-page and property URLs (13 URL shapes supported); incremental mode returns only what changed on scheduled runs.
- **Native filters and views.** Type, price, area, bedrooms, bathrooms, parking, amenities and five sort orders, with four ready-made dataset views and one Max listings cap.

### Use Cases

- **Rental market research:** compare rent, total monthly cost and condominium fees across neighborhoods before signing a lease.
- **Real estate investment analysis:** pull sale prices, area and property specs to model returns on prospective properties.
- **Proptech and listings aggregators:** feed structured Brazilian rental and sale data into your own search or comparison app.
- **Relocation and moving services:** match clients to furnished, pet-friendly or subway-adjacent listings by city and neighborhood.
- **Academic and market research:** build datasets of pricing and amenities across Brazilian cities over time.

### Data You Get

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

| Field | Example |
| --- | --- |
| `id` | `100000000` |
| `title` | `"Apartamento · 2 quartos · Bairro Exemplo"` |
| `tipoOperacao` | `"aluguel"` (also `"venda"`) |
| `tipoImovel` | `"Apartamento"` |
| `precoAluguel` / `precoTotalMensal` | `2500` / `3200` |
| `precoVenda` | `0` |
| `precoCondominio` / `precoIPTU` | `500` / `200` |
| `area` | `65` |
| `quartos` / `banheiros` | `2` / `1` |
| `suites` / `vagas` | `0` / `1` |
| `floor` | `7` |
| `bairro` | `"Bairro Exemplo"` |
| `cidade` / `estado` | `"Cidade Exemplo"` / `"Estado Exemplo"` |
| `latitude` / `longitude` | `-23.55` / `-46.63` |
| `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"` |

GPS coordinates, state and postal code, the full description, the condominium / IPTU breakdown, floor, the in-unit and building amenity lists (`comodidades`, `comodidadesPredio`), the listing date and the furnished / pets / subway flags are added by the per-property detail fetch (`fetchDetails`, on by default). With it off you still get the id, link, prices, area, rooms, neighborhood, city and photos from the listing card, and the detail-only fields come back empty.

### How to Use

1. Pick a **mode**: `search` (build searches from location names + filters) or `url` (paste one or more quintoandar.com.br results-page URLs).
2. Fill in the fields for that mode: locations and operation for search mode, or URLs for URL mode. Property type, price, area, bedroom, bathroom, parking, furnished, pets, transit, amenity and sort filters apply to both modes.
3. Set **Max listings** to cap the run's cost, and leave **Fetch full detail** on for the richest output.
4. Click **Start**, then download the dataset as JSON, CSV or Excel, or read it through the API.

**Search for rent, with filters:**

```json
{
  "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
}
```

**Search for sale:**

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

**Paste results-page URLs, with a page ceiling:**

```json
{
  "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
}
```

#### Supported URL shapes (URL mode)

| Shape | Example |
| --- | --- |
| City, rent | `https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil` |
| City, buy | `https://www.quintoandar.com.br/comprar/imovel/sao-paulo-sp-brasil` |
| Neighbourhood | `https://www.quintoandar.com.br/alugar/imovel/pinheiros-sao-paulo-sp-brasil` |
| Property type segment (apartment) | `.../alugar/imovel/sao-paulo-sp-brasil/apartamento` |
| Property type segment (house) | `.../alugar/imovel/sao-paulo-sp-brasil/casa` |
| Bedrooms segment | `.../alugar/imovel/sao-paulo-sp-brasil/2-quartos` |
| Furnished segment | `.../alugar/imovel/sao-paulo-sp-brasil/mobiliado` |
| Sort and price query | `.../alugar/imovel/sao-paulo-sp-brasil?ordenar=menor-preco&preco=1000-3000` |
| Bare domain | `https://quintoandar.com.br/comprar/imovel/belo-horizonte-mg-brasil` |
| Property page, rent | `https://www.quintoandar.com.br/imovel/894090267/alugar` |
| Property page, buy | `https://www.quintoandar.com.br/imovel/895818343/comprar` |
| Property page, id only | `https://www.quintoandar.com.br/imovel/894317939` |
| Property page with slug | `https://www.quintoandar.com.br/imovel/895097594/alugar/apartamento-2-quartos-pinheiros-sao-paulo` |

Filters and sort carried by a pasted results URL are applied and win over the matching input fields; any part of a URL that is not supported is logged as a warning that names the URL by its position and path, such as `URL #3 (/alugar/imovel/pinheiros-sao-paulo-sp-brasil)` (for example an `ordenar=` sort value other than `menor-preco` or `maior-preco`; use the **Sort order** field for newest or closest). Location and operation fields are ignored in URL mode. If none of the pasted locations can be matched, the run stops with a clear "No location matched" message instead of returning an empty dataset.

**Default URL list:** unlike a plain empty field, `urls` ships with a pre-filled list of one example per shape above, each pointing at a different results page or property. A run started in URL mode without editing it reads those 13 examples within **Max listings**: one slot is reserved for every pasted property page (up to the cap itself), and the remaining slots are shared evenly between the results pages, so property pages are read even at the default cap of 20 and at smaller caps. Replace the list with your own URLs before starting.

**Fast, listing-card-only run:**

```json
{
  "mode": "search",
  "locations": ["Curitiba"],
  "operationType": "rent",
  "propertyType": "studio",
  "fetchDetails": false,
  "maxListings": 0
}
```

#### Run it from your code

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/quintoandar-scraper").call(run_input={
    "mode": "search",
    "locations": ["São Paulo"],
    "operationType": "rent",
    "maxListings": 20,
})
for listing in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(listing["title"], listing["precoTotalMensal"])
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/quintoandar-scraper').call({
  mode: 'search',
  locations: ['São Paulo'],
  operationType: 'rent',
  maxListings: 20,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the **Integrations** tab.

#### How Max listings splits across a multi-location search

With more than one location or URL, **Max listings** is divided evenly (rounded up) into a per-search share, so no single location can use up the whole budget. A location that returns fewer listings than its share does not free that room up for the others: each stays capped at its own fixed share. Across several locations a run can therefore finish under **Max listings** even though another location in the same run had more to give. Raise **Max listings**, or run fewer locations per job, to collect more from any one of them.

**Max pages per search** is an optional, separate safety stop on how many result pages one location or URL reads; when left empty or 0 it uses a built-in hard ceiling of 1000 pages per search (about 11,000 listings) that applies even when **Max listings** is 0; below that ceiling the run is bounded by **Max listings**.

### Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step **after** the scrape: the Apify dataset is never changed.

**What gets written to the connector:** a condensed, human-readable **summary** of each listing, not the full JSON. Each item becomes one entry with a **title** and its key fields flattened to plain text. The **complete record always stays in the Apify dataset**.

1. Authorize a connector once under **Apify → Settings → Integrations** (Notion, Linear, Airtable, or Apify).
2. Select it in the **"Pipe results into your apps"** input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For **Notion**, also set `notionParentPageUrl` to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

### Input Parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | `search` | `search` builds searches from location names + filters; `url` reads pasted results-page URLs. |
| `locations` | array | `["São Paulo"]` | Location names to search, e.g. São Paulo, Rio de Janeiro, Pinheiros São Paulo. Only applies when mode = search. |
| `operationType` | string | `rent` | Rent or buy. Only applies when mode = search. |
| `propertyType` | string | `all` | One of `all`, `apartment`, `house`, `studio`, `condo_house`. Applies in search mode and URL mode, including a pasted URL. |
| `propertyTypes` | array | (none) | Pick several property types at once; when set it replaces the single property type. |
| `minPrice` | integer | (none) | Minimum total monthly cost (rent) or sale price, in BRL. Applies in search mode and URL mode, including a pasted URL. |
| `maxPrice` | integer | (none) | Maximum total monthly cost (rent) or sale price, in BRL. Applies in search mode and URL mode, including a pasted URL. |
| `minArea` | integer | (none) | Minimum area in square metres. Applies in search mode and URL mode, including a pasted URL. |
| `maxArea` | integer | (none) | Maximum area in square metres. Applies in search mode and URL mode, including a pasted URL. |
| `minBedrooms` | integer | (none) | Minimum number of bedrooms. Applies in search mode and URL mode, including a pasted URL. |
| `minBathrooms` | integer | (none) | Minimum number of bathrooms. Search and URL mode. |
| `minParking` | integer | (none) | Minimum number of parking spaces. Search and URL mode. |
| `neighborhood` | string | (none) | Neighbourhood added to every location, e.g. Pinheiros with São Paulo. Search mode only. |
| `furnished` | string | `all` | `all`, `furnished` or `unfurnished`. Search and URL mode. `furnished` is applied by the site itself; `unfurnished` drops listings the site marks as furnished. |
| `petsAllowed` | boolean | `false` | Only listings that accept pets. Search and URL mode. |
| `nearTransit` | boolean | `false` | Only listings near a subway station. Search and URL mode. |
| `amenities` | array | (none) | Listings that have ALL selected in-unit amenities: air conditioning, barbecue grill, gas shower, walk-in closet, private garden or outdoor area, private pool, laundry sink, television, kitchen utensils, ceiling fan. |
| `condoAmenities` | array | (none) | Listings whose building has ALL selected amenities: gym, green area, playroom, barbecue area, elevator, swimming pool, playground, 24-hour concierge, sports court, party room, game room, sauna. |
| `sortBy` | string | `relevance` | `relevance`, `price-asc`, `price-desc`, `newest` or `closest`. Applies in search mode and URL mode, including a pasted URL. |
| `urls` | array | 13 sample URLs | URL mode. See the table of supported shapes above. The default is a list with one example of each of the 13 shapes, every example a different results page or property. One slot of **Max listings** is reserved for each pasted property page (never more slots than the cap itself); the rest is shared evenly between results pages. Location and operation are ignored in this mode. |
| `fetchDetails` | boolean | `true` | Fetch each property page to add GPS, the full description, in-unit and building amenities, condo and IPTU breakdown, floor, and furnished / pets / subway flags. |
| `maxPages` | integer | (none, hard ceiling 1000) | Optional safety stop on result pages read per location or URL. Empty or 0 uses the built-in hard ceiling of 1000 pages per search; below it the run is bounded by Max listings. |
| `maxListings` | integer | `20` | The run's single hard cap: maximum total listings across all searches. `0` means unlimited. |
| `proxy` | object | Apify Proxy | Connection used for requests. |
| `resumeFromRunId` | string | (none) | Run or dataset ID of an interrupted run; listings it already collected are skipped and not charged again. |
| `incrementalMode` | boolean | `false` | Return only new, updated and reappeared listings on recurring runs over the same search. |
| `stateKey` | string | (none) | Name or share an incremental-mode monitoring campaign. |
| `emitUnchanged` | boolean | `false` | Incremental mode only: also return unchanged listings, marked `UNCHANGED` (they are delivered, so they are billed). |
| `emitExpired` | boolean | `false` | Incremental mode only: also return listings no longer found, marked `EXPIRED`, after a complete scan only. `EXPIRED` rows are dataset rows and are charged as a Property result each. |
| `ignoreFieldsForChanges` | array | (none) | Incremental mode only. Fields whose change alone does not make a listing `UPDATED` and is not listed in `changedFields`; they are still returned. The run timestamps are always ignored. |
| `mcpConnectors` | array | (none) | Optional: send a summary of each listing to apps you authorized under Integrations. |
| `notionParentPageUrl` | string | (none) | Notion connector only: page under which item pages are created. |
| `maxNotifyListings` | integer | `50` | 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.

```json
{
  "id": 100000000,
  "idImovel": 100000000,
  "url": "https://www.quintoandar.com.br/imovel/100000000/alugar",
  "fonte": "quintoandar.com.br",
  "title": "Apartamento · 2 quartos · Bairro Exemplo",
  "titulo": "Apartamento · 2 quartos · Bairro Exemplo",
  "tipoOperacao": "aluguel",
  "tipoImovel": "Apartamento",
  "propertyType": "Apartamento",
  "modo": "rent",
  "precoAluguel": 2500,
  "precoTotalMensal": 3200,
  "precoAtual": 3200,
  "precoVenda": 0,
  "precoCondominio": 500,
  "precoIPTU": 200,
  "area": 65,
  "areaM2": 65,
  "quartos": 2,
  "banheiros": 1,
  "suites": 0,
  "vagas": 1,
  "floor": 7,
  "bairro": "Bairro Exemplo",
  "cidade": "Cidade Exemplo",
  "estado": "Estado Exemplo",
  "endereco": "Rua Ficticia, 123",
  "latitude": -23.55,
  "longitude": -46.63,
  "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"
}
```

#### Output views

The dataset has four views, also linked from the run's Output tab:

- **Listings Overview:** id, title, operation, type, rent, total monthly cost, sale price, condominium, IPTU, area, rooms, parking, neighbourhood, city, state, GPS and link.
- **Amenities & Features:** furnished, pets, subway flags, floor, suites and the in-unit and building amenity lists.
- **Listing Details:** description, GPS, address, condominium, IPTU, floor and flags.
- **Changes since the last run:** incremental mode only; change type, changed fields, first and last seen.

At the end of every run a summary is saved to the key-value store under `OUTPUT`: total listings, details enriched, searches requested, unmatched locations and a per-source breakdown.

### Plan Requirement

Works on any Apify plan with the default connection, including the free tier; no residential proxy is required. If the primary connection is unavailable or is repeatedly refused, the run automatically falls back to a shared, self-rotating backup connection, and a short message in the log says so ("Served over the backup connection (the default connection was unavailable)."). The backup can be rate-limited, so results may come back more slowly. On a free plan that selected a residential pool, the log explains that free plans do not include residential proxies and the run continues on the backup connection. You can also supply your own proxy URLs.

### FAQ

#### How much does it cost?

Pricing is pay per event, and the **Pricing** tab shows the current rates:

| Event | Unit | When it is charged |
| --- | --- | --- |
| Actor start | once per run | When the run starts. |
| Property result | one per listing | For each listing pushed to the dataset. |
| Detail enrichment | one per property | For each pushed listing whose property page was successfully read to add its detail fields. It is charged right after the batch is saved, so it is not lost if a run is stopped, and it is never charged when **Fetch full detail** is off or for a listing whose detail page could not be read. A pasted property-page URL follows the same rule: one detail enrichment while **Fetch full detail** is on, none when it is off. |

A run that finds no matching listings saves no dataset row and so charges no listing event; the empty result is reported in the run's status message instead. Use **Max listings** to cap the cost of any run.

#### Is it legal to scrape quintoandar.com.br?

This actor collects only publicly available listing data. You are responsible for how you use it: follow quintoandar.com.br's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Property photos and descriptions may be subject to third-party rights.

#### Can I get only what changed since my last run?

Yes. Turn on **Incremental mode** and schedule the actor. The first run returns every matching listing as `NEW`; later runs return only `NEW`, `UPDATED` and `REAPPEARED` listings, with `changedFields` naming what moved (for example `precoAluguel`). Unchanged listings are not returned or billed unless you turn on `emitUnchanged`. `emitExpired` adds `EXPIRED` rows for listings that disappeared, only after a run that scanned the whole search (never when Max listings, Max pages, a failed page or Resume stopped it); `EXPIRED` rows are dataset rows and are charged as a Property result each. Rows are `changeType`, `changedFields`, `firstSeenAt` and `lastSeenAt`, shown in the Changes view. With Fetch details on, a listing whose detail page could not be read is skipped for that run and picked up on the next one. **Resume from a previous run** continues one specific interrupted run instead; the two are different features.

#### Can I schedule this to track a market over time?

Yes, schedule it from the **Schedules** tab. Each run reads the current live listings for your locations or URLs; there is no built-in change-tracking between runs, so keep the run's output (or your own downstream store) if you want to compare snapshots over time.

#### Why did I get fewer listings than Max listings?

With more than one location or URL, **Max listings** is split evenly across them, and an under-delivering location does not free its unused share up for the others. A location can also run dry before its share is filled, a results page that could not be read ends that location early, or **Max pages per search** can stop it first. Raise **Max listings**, raise or clear **Max pages per search**, or run fewer locations per job to collect more.

#### Why did my run fail instead of returning an empty dataset?

If nothing could be read, the run stops with a clear message so "no listings matched" is never confused with "nothing could be read". The messages are: the proxy connection was refused for this account (a paid plan is required, or check your own proxy credentials); residential proxies are unavailable on a free plan and the backup connection could not load the pages; or no results page could be loaded and it is a connection problem, not an empty search, so try again later. A URL-mode or location list where nothing matches stops with "No location matched". If the site answered but no listing matched your filters, the run succeeds with an empty dataset and the status message "No listings matched the given locations/URLs and filters." No row is saved or charged for it.

#### Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear or Airtable.

### 🔗 Want more real estate data?

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>🏠 <a href="https://apify.com/abotapi/zapimoveis-scraper"><b>Zap Imóveis Scraper</b></a><br>Scrape Zap Imóveis sale, rental and new-development listings by city, filters or URL...</td><td>🏠 <a href="https://apify.com/abotapi/zumper-scraper"><b>Zumper Scraper</b></a><br>Scrape Zumper.com rental listings: apartments, houses, condos and rooms. Pulls 60+ fields...</td></tr>
<tr><td>🛒 <a href="https://apify.com/abotapi/americanas-com-br-scraper"><b>Americanas Brazil</b></a><br>Scrape Americanas Brazil (americanas.com.br) by keyword, department or pasted link...</td><td>🛒 <a href="https://apify.com/abotapi/netshoes-scraper"><b>Netshoes Brazil</b></a><br>Scrape sportswear and footwear from netshoes.com.br. Search by keyword with the store's...</td></tr>
<tr><td>🏠 <a href="https://apify.com/abotapi/apartments-com-scraper"><b>Apartments.com Scraper</b></a><br>Scrape Apartments.com rentals by city, ZIP, neighborhood, address or URL. Extract rent...</td><td>🏠 <a href="https://apify.com/abotapi/zonaprop-scraper"><b>Zonaprop Argentina</b></a><br>Scrape Zonaprop.com.ar property listings across Argentina. Extract 140+ fields including...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/quintoandar-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

search = build searches from location names + filters. url = paste one or more quintoandar results-page URLs.

## `locations` (type: `array`):

Location names to search, e.g. São Paulo, Rio de Janeiro, Pinheiros São Paulo, Belo Horizonte. Accents and spaces are handled automatically. Only applies when mode = search.

## `operationType` (type: `string`):

Rent or buy. Only applies when mode = search.

## `propertyType` (type: `string`):

Property category to search. 'All' covers every type. Applies in Search mode and URL mode, including a pasted URL.

## `propertyTypes` (type: `array`):

Pick several property categories at once. When set, it replaces the single Property type above. Applies in Search mode and URL mode.

## `minPrice` (type: `integer`):

Minimum total monthly cost (rent) or sale price, in BRL. Applies in Search mode and URL mode, including a pasted URL.

## `maxPrice` (type: `integer`):

Maximum total monthly cost (rent) or sale price, in BRL. Applies in Search mode and URL mode, including a pasted URL.

## `minArea` (type: `integer`):

Minimum area in square metres. Applies in Search mode and URL mode, including a pasted URL.

## `maxArea` (type: `integer`):

Maximum area in square metres. Applies in Search mode and URL mode, including a pasted URL.

## `minBedrooms` (type: `integer`):

Minimum number of bedrooms (quartos). Applies in Search mode and URL mode, including a pasted URL.

## `minBathrooms` (type: `integer`):

Minimum number of bathrooms. Applies in Search mode and URL mode.

## `minParking` (type: `integer`):

Minimum number of parking spaces. Applies in Search mode and URL mode.

## `neighborhood` (type: `string`):

Optional neighbourhood (bairro) added to every location, e.g. Pinheiros with location São Paulo. Search mode only.

## `furnished` (type: `string`):

Furnished listings only, or exclude furnished listings (unfurnished is applied after the fetch, from the furnished flag when the site exposes it). Applies in Search mode and URL mode.

## `petsAllowed` (type: `boolean`):

Only listings that accept pets. Applies in Search mode and URL mode.

## `nearTransit` (type: `boolean`):

Only listings near a subway station. Applies in Search mode and URL mode.

## `amenities` (type: `array`):

Only listings that have ALL selected in-unit amenities.

## `condoAmenities` (type: `array`):

Only listings whose building has ALL selected amenities.

## `sortBy` (type: `string`):

Result ordering. Applies in Search mode and URL mode, including a pasted URL.

## `urls` (type: `array`):

Paste one or more quintoandar.com.br URLs: results pages (city or neighbourhood, with an optional property type, bedroom count, mobiliado segment or ?ordenar= / ?preco= query) or single property pages (/imovel/{id}). Filters and sort carried by a pasted results URL are applied and win over the fields above. Unsupported parts of a URL are logged as warnings. Location and operation above are ignored in this mode; property type, price, area, bedroom and sort filters above still apply to results URLs that do not set their own.

## `fetchDetails` (type: `boolean`):

Fetch each property page to add GPS coordinates, the full description, in-unit and building amenities, condo and IPTU breakdown, floor, and furnished / pets / subway flags. Adds one request per property. Leave on for the richest output.

## `maxPages` (type: `integer`):

Optional safety stop on how many result pages to read per location/URL. This does NOT cap the run: leave it empty (or 0) to use the built-in hard ceiling of 1000 pages per search (about 11,000 listings), which applies even when Max listings is 0. Set a lower value if you want a tighter per-search page ceiling.

## `maxListings` (type: `integer`):

The run's single hard cap: maximum total listings across all searches. Defaults to 20. Set 0 for unlimited. This is the only default limit; Max pages falls back to a built-in hard ceiling of 1000 pages per search.

## `proxy` (type: `object`):

Connection used for requests. The default works on any Apify plan, including the free tier.

## `resumeFromRunId` (type: `string`):

Paste a previous run ID or dataset ID to continue a large catalogue pull without returning or charging for listings already collected there. Use this after an interrupted run. For recurring daily monitoring of the same search, use Incremental mode below instead.

## `incrementalMode` (type: `boolean`):

Turn this on for daily or recurring monitoring. The first run returns every matching listing as NEW. Later runs normally return only NEW, UPDATED and REAPPEARED listings, which is how a price cut or a stock change is spotted. Turn on Emit unchanged or Emit expired only when you also want those rows returned (and billed). State is kept separately for each search, filter and detail setup; use State key to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.

## `stateKey` (type: `string`):

Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to let the actor derive a key automatically from the search, filters and detail settings, so different searches never mix state with each other.

## `emitUnchanged` (type: `boolean`):

Off by default. Turn on to also return listings that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have, so leave it off unless you want the full snapshot every run.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return listings that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search, so never when Max listings capped it or when Resume was used. This returns, and bills, extra synthetic rows, so leave it off unless you need expiry tracking.

## `ignoreFieldsForChanges` (type: `array`):

Incremental mode only. Fields whose changes do not count as an update: a change in them alone leaves the listing UNCHANGED and they are not listed in changedFields. They are still returned in every row. Use a dotted path for a nested field. The run timestamps (scrapedAt, coletadoEm, vistoPrimeiraVez, vistoUltimaVez) are always ignored. Add more field names here to ignore them as well, for example precoCondominio.

## `mcpConnectors` (type: `array`):

Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify, Settings, Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON; the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com).

## `notionParentPageUrl` (type: `string`):

URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "locations": [
    "São Paulo"
  ],
  "operationType": "rent",
  "propertyType": "all",
  "furnished": "all",
  "petsAllowed": false,
  "nearTransit": false,
  "sortBy": "relevance",
  "urls": [
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil",
    "https://www.quintoandar.com.br/comprar/imovel/sao-paulo-sp-brasil",
    "https://www.quintoandar.com.br/alugar/imovel/pinheiros-sao-paulo-sp-brasil",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/apartamento",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/casa",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/2-quartos",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/mobiliado",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil?ordenar=menor-preco&preco=1000-3000",
    "https://quintoandar.com.br/comprar/imovel/belo-horizonte-mg-brasil",
    "https://www.quintoandar.com.br/imovel/894090267/alugar",
    "https://www.quintoandar.com.br/imovel/895818343/comprar",
    "https://www.quintoandar.com.br/imovel/894317939",
    "https://www.quintoandar.com.br/imovel/895097594/alugar/apartamento-2-quartos-pinheiros-sao-paulo"
  ],
  "fetchDetails": true,
  "maxListings": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "ignoreFieldsForChanges": [
    "scrapedAt"
  ],
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `amenities` (type: `string`):

No description

## `detail` (type: `string`):

No description

## `changes` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "locations": [
        "São Paulo"
    ],
    "urls": [
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil",
        "https://www.quintoandar.com.br/comprar/imovel/sao-paulo-sp-brasil",
        "https://www.quintoandar.com.br/alugar/imovel/pinheiros-sao-paulo-sp-brasil",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/apartamento",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/casa",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/2-quartos",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/mobiliado",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil?ordenar=menor-preco&preco=1000-3000",
        "https://quintoandar.com.br/comprar/imovel/belo-horizonte-mg-brasil",
        "https://www.quintoandar.com.br/imovel/894090267/alugar",
        "https://www.quintoandar.com.br/imovel/895818343/comprar",
        "https://www.quintoandar.com.br/imovel/894317939",
        "https://www.quintoandar.com.br/imovel/895097594/alugar/apartamento-2-quartos-pinheiros-sao-paulo"
    ],
    "proxy": {
        "useApifyProxy": true
    },
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "ignoreFieldsForChanges": [
        "scrapedAt"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "locations": ["São Paulo"],
    "urls": [
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil",
        "https://www.quintoandar.com.br/comprar/imovel/sao-paulo-sp-brasil",
        "https://www.quintoandar.com.br/alugar/imovel/pinheiros-sao-paulo-sp-brasil",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/apartamento",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/casa",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/2-quartos",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/mobiliado",
        "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil?ordenar=menor-preco&preco=1000-3000",
        "https://quintoandar.com.br/comprar/imovel/belo-horizonte-mg-brasil",
        "https://www.quintoandar.com.br/imovel/894090267/alugar",
        "https://www.quintoandar.com.br/imovel/895818343/comprar",
        "https://www.quintoandar.com.br/imovel/894317939",
        "https://www.quintoandar.com.br/imovel/895097594/alugar/apartamento-2-quartos-pinheiros-sao-paulo",
    ],
    "proxy": { "useApifyProxy": True },
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "ignoreFieldsForChanges": ["scrapedAt"],
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/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 '{
  "mode": "search",
  "locations": [
    "São Paulo"
  ],
  "urls": [
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil",
    "https://www.quintoandar.com.br/comprar/imovel/sao-paulo-sp-brasil",
    "https://www.quintoandar.com.br/alugar/imovel/pinheiros-sao-paulo-sp-brasil",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/apartamento",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/casa",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/2-quartos",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/mobiliado",
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil?ordenar=menor-preco&preco=1000-3000",
    "https://quintoandar.com.br/comprar/imovel/belo-horizonte-mg-brasil",
    "https://www.quintoandar.com.br/imovel/894090267/alugar",
    "https://www.quintoandar.com.br/imovel/895818343/comprar",
    "https://www.quintoandar.com.br/imovel/894317939",
    "https://www.quintoandar.com.br/imovel/895097594/alugar/apartamento-2-quartos-pinheiros-sao-paulo"
  ],
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "ignoreFieldsForChanges": [
    "scrapedAt"
  ]
}' |
apify call abotapi/quintoandar-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/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 <APIFY_API_TOKEN>` 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/AqbOHJGKz91XmogrA/builds/QAVobriGvx9KDwa2C/openapi.json