# QuintoAndar & OLX Imóveis Scraper: Aluguel e Venda (`allanmxr/brazil-real-estate-scraper`) Actor

Rent and sale listings from QuintoAndar, OLX Imóveis, Chaves na Mão and Imovelweb in one flat dataset: price, condo fee, IPTU, total monthly cost, area, bedrooms, coordinates and photos. Search by city and neighborhood with filters for price, area, bedrooms and pets. No login or API key.

- **URL**: https://apify.com/allanmxr/brazil-real-estate-scraper.md
- **Developed by:** [Allan Marcelino](https://apify.com/allanmxr) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 property 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

## Brazil Real Estate Scraper: QuintoAndar, OLX Imóveis, Chaves na Mão and Imovelweb

Scrape **rent and sale listings from QuintoAndar, OLX Imóveis, Chaves na Mão and Imovelweb** in one run. Four of Brazil's biggest property portals, one clean dataset.

**Em português:** extraia anúncios de **aluguel e venda de imóveis** do QuintoAndar, OLX Imóveis, Chaves na Mão e Imovelweb por cidade, bairro e filtros (preço, área, quartos, vagas, mobiliado, aceita pet, condomínio). Um único formato de saída, com coordenadas, condomínio, IPTU e custo mensal total. Exemplos de busca: *apartamento para alugar em Campinas*, *casa à venda em Pinheiros São Paulo*, *kitnet para alugar no Rio de Janeiro*.

Search by state, city and neighborhood, filter by price, area, bedrooms, bathrooms, parking, suites, furnished, pets, condo fee and publication date, or paste a search URL from any of the four sites. You get one clean, flat dataset in English with coordinates, condo fee, IPTU and the **total monthly cost** of a rental.

No login, no API key and no proxy needed for normal use.

### What you get that other Brazil real estate scrapers don't give you

- **Search by city and neighborhood, not only by pasted URL.** Pick `SP`, type `São Paulo` and `Pinheiros` and run. URLs are optional.
- **Beyond the site result limits.** QuintoAndar caps one search at 1,000 results, OLX at 5,000 (100 pages) and Chaves na Mão at 2,970. When you ask for more than that, the actor splits the search into price bands, so one run can return tens of thousands of listings with no duplicates. Smaller runs are never split.
- **Four portals, one schema.** The same fields in the same units from every portal, so you can compare them in one table. The `maxItems` budget is shared equally between the portals.
- **Total monthly cost for rentals** (rent + condo fee + IPTU), with the condo fee and IPTU as separate numeric fields.
- **Real coordinates, ZIP code and publication dates** on every listing.
- **Privacy by design.** No advertiser names, phone numbers or e-mails are collected.
- **Honest data.** Location and property type are checked again on every result, and ads that OLX pads into sparse searches from other neighborhoods are discarded.

### Use cases

- Rental and sale **price monitoring** per neighborhood
- **Investment analysis**: price per m², rental yield, condo fee burden
- Building a **real estate dataset** for dashboards, maps or machine learning
- Lead generation for **moving, furniture, insurance and renovation** services (property level data only)
- Market research for brokers, proptechs and relocation companies

### Input

| Field | Description |
|---|---|
| `sources` | Any of `quintoandar`, `olx`, `chavesnamao`, `imovelweb` (all four by default). The `maxItems` budget is shared equally; a source that runs dry hands its share to the others. |
| `dealType` | `rent` or `sale`. |
| `state` | State (UF), chosen from a list. |
| `cities` | City names only, e.g. `Campinas`. They must belong to `state`. |
| `neighborhoods` | Optional, only with exactly one city. |
| `startUrls` | Optional search page URLs from quintoandar.com.br, olx.com.br, chavesnamao.com.br (e.g. `/apartamentos-para-alugar/sp-campinas/`) or imovelweb.com.br (e.g. `/apartamentos-aluguel-campinas-sp.html`), one per line. OLX URLs keep every filter you set on the site. The other portals' URLs give the place and the deal type only. |
| `maxItems` | Total listings, default 100. |
| `fetchDetails` | Default on. Opens each listing for coordinates, ZIP code, street and (QuintoAndar) dates; on Imovelweb it adds amenities, IPTU and the publication date. Chaves na Mão needs no extra request. Off is much faster. |
| `proxyConfiguration` | Optional. By default the actor starts without a proxy and climbs by itself if a portal blocks it. |

#### Filters

Every filter is applied by the portal's own server, except where noted.

| Filter | QuintoAndar | OLX | Chaves na Mão | Imovelweb |
|---|---|---|---|---|
| `propertyTypes` (`apartment`, `house`, `studio`, `condo_house`; empty = all residential) | yes | yes | yes | yes |
| `minPrice`, `maxPrice` | yes | yes | yes | yes |
| `minArea`, `maxArea` | yes | yes | yes | yes |
| `minBedrooms` | yes | yes (5 means 5 or more) | yes | yes |
| `maxBedrooms` | yes | yes (5 means 5 or more) | after the search | yes |
| `minBathrooms`, `minParkingSpots` | yes | yes (5 means 5 or more) | yes | yes |
| `minSuites` | yes | no, OLX is skipped when set | after the search | after the search |
| `furnished` | yes | yes | after the search | yes |
| `petFriendly` | yes | yes | yes | no, Imovelweb is skipped when set |
| `maxCondoFee` | after the search | after the search | after the search | after the search |
| `sortBy` (`relevance`, `newest`) | yes | yes | yes | yes |
| `publishedWithinDays` | yes | yes | yes (last update) | yes (last update) |

With no `propertyTypes`, each portal is searched type by type (apartment first, then house, studio, condominium house). With a small `maxItems` the first types fill the budget, so pick the types you care about.

`publishedWithinDays` keeps listings published or renewed in the last N days and sorts them newest first. On QuintoAndar the dates only exist on the listing page, so every candidate is opened even with `fetchDetails` off.

#### Example input

```json
{
    "sources": ["quintoandar", "olx"],
    "dealType": "rent",
    "state": "SP",
    "cities": ["São Paulo"],
    "neighborhoods": ["Pinheiros"],
    "propertyTypes": ["apartment", "studio"],
    "minPrice": 2000,
    "maxPrice": 5000,
    "minBedrooms": 1,
    "furnished": true,
    "maxItems": 500
}
```

### Output

One flat item per listing:

```json
{
    "source": "quintoandar",
    "listingId": "895666067",
    "url": "https://www.quintoandar.com.br/imovel/895666067/alugar",
    "dealType": "rent",
    "propertyType": "apartment",
    "title": "3-bedroom apartment for rent in São Bernardo, Campinas",
    "price": 2992,
    "condoFee": 750,
    "iptu": 17,
    "totalMonthlyCost": 3759,
    "pricePerSqm": 29.33,
    "area": 102,
    "bedrooms": 3,
    "bathrooms": 2,
    "parkingSpots": 1,
    "street": "Rua Doutor Alves do Banho",
    "neighborhood": "São Bernardo",
    "city": "Campinas",
    "state": "SP",
    "zipCode": "13030-580",
    "latitude": -22.9266637,
    "longitude": -47.0748232,
    "amenities": ["party_room", "toy_room", "pets_allowed"],
    "coverImage": "https://www.quintoandar.com.br/img/med/original895666067-1.jpg",
    "images": ["https://www.quintoandar.com.br/img/med/original895666067-1.jpg"],
    "publishedAt": "2026-11-09T22:08:29+00:00",
    "updatedAt": "2026-11-09T22:08:29+00:00",
    "scrapedAt": "2026-11-17T22:12:54+00:00"
}
```

Field notes:

- `price`: monthly rent for rentals, asking price for sales. `condoFee` and `iptu` are monthly BRL amounts.
- `totalMonthlyCost`: rentals only, rent + condo fee + IPTU on both portals; `null` for sales. A fee a listing does not inform counts as zero.
- `title` is generated the same way on both portals. `pricePerSqm` is `price / area`. `coverImage` is the first photo.
- `amenities` use one English snake_case vocabulary on both portals (`pets_allowed`, `furnished`, `balcony`, `gym`, `pool`...).
- `propertyType` is `apartment`, `house`, `studio`, `condo_house`, or `land`, `commercial` and `other` for pasted URLs of other categories.
- `zipCode` is `00000-000` when present. Imovelweb does not publish it, so it is always `null` there; on Chaves na Mão about half of the listings have it.
- `iptu` is the amount the advertiser shows; on OLX sales it may be a yearly value.
- `street` never includes the house number. OLX hides the street on most ads, so it is often `null` there.
- `publishedAt` on OLX is the time shown on the ad (OLX refreshes it when the ad is renewed). `updatedAt` is always `null` for OLX.
- Without `fetchDetails`, coordinates, ZIP code and dates are `null` on QuintoAndar, coordinates, ZIP code and street on OLX, and amenities, IPTU and `publishedAt` on Imovelweb. Condo fee comes with the search on every portal, and IPTU on every portal but Imovelweb.
- On Chaves na Mão and Imovelweb `updatedAt` is the portal's last update of the listing. Imovelweb `publishedAt` is the first publication date, read from the listing page.

### Who it is for

Brokers, proptechs, investors, relocation and moving companies, researchers and anyone who needs rental and sale listings as structured data.

### Pricing

Pay per event: **US$ 2.00 per 1,000 listings** (US$ 0.002 per listing, event `listing`), charged for each listing written to the dataset. Platform usage (compute and proxy) is included.

| Listings | Cost |
|---|---|
| 100 | US$ 0.20 |
| 500 | US$ 1.00 |
| 1,000 | US$ 2.00 |

### FAQ

**Do I need a proxy?** No. The actor decides per portal: it starts with browser-grade TLS and, when a portal blocks or rate-limits (403/429), climbs by itself to Apify Proxy datacenter, then residential in Brazil, then a real browser. On Apify, OLX and Imovelweb usually end on the residential rung; there only the search results are read (no detail pages), so those listings come without coordinates, ZIP code and amenities. If one portal still fails, the others keep delivering and the run's `RUN_SUMMARY` record (key-value store) says what happened per portal.

**How many listings can I get in one run?** As many as the portal has for your filters. Big searches are split automatically. Add price, area or bedroom filters to keep runs cheap and focused.

**Why do I sometimes get fewer listings than `maxItems`?** Your filters match fewer listings, or very sparse price tails of a huge OLX search were dropped to avoid unrelated ads.

**Does it collect owner or broker contact data?** No. Only property level data.

**Can I paste a QuintoAndar search URL with filters?** The place and the deal type are read from the URL. Filters come from the input fields.

**Why is a portal skipped when I set `minSuites` or `petFriendly`?** OLX has no suites filter and Imovelweb has no pets filter, so their results could not honor it. The run status message says which portal was skipped.

**Can it run on a schedule to track new listings?** Yes. Use an Apify schedule and compare `listingId` and `price` between runs.

### Notes

This actor only reads publicly visible listing data. You are responsible for using the data in line with each portal's terms and with Brazilian data protection law (LGPD).

**Preço:** US$ 2,00 por 1.000 anúncios (US$ 0,002 por anúncio entregue). Exemplo: 500 anúncios custam US$ 1,00.

### Other Actors by the same author

- [Brazil Vehicle Auctions Scraper](https://apify.com/allanmxr/brazil-vehicle-auctions-scraper)
- [Brazil Public Tenders Scraper](https://apify.com/allanmxr/brazil-public-tenders)
- [Brazil Real Estate Auctions Scraper](https://apify.com/allanmxr/brazil-real-estate-auctions)
- [Mexico Vehicle Auctions Scraper](https://apify.com/allanmxr/mexico-vehicle-auctions-scraper)

# Actor input Schema

## `sources` (type: `array`):

Portals to search. The listing budget (Max items) is shared equally between them.

## `dealType` (type: `string`):

Rent or buy.

## `state` (type: `string`):

State (UF) of the cities below. Not needed when you only paste search URLs.

## `cities` (type: `array`):

City names only, one per line, for example Campinas. They must belong to the state above.

## `neighborhoods` (type: `array`):

Narrow the search to these neighborhoods, for example Cambuí. Works with exactly one city; leave empty to search the whole city.

## `startUrls` (type: `array`):

Search pages copied from quintoandar.com.br (/alugar or /comprar/imovel/...), olx.com.br (/imoveis/...), chavesnamao.com.br (e.g. /apartamentos-para-alugar/sp-campinas/) or imovelweb.com.br (e.g. /apartamentos-aluguel-campinas-sp.html), one per line. They are searched in addition to the cities above, only for the selected sources. An OLX URL keeps its own filters; the other portals only give the place and the deal type, so use the filters below there.

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

Leave empty for all residential types. All four portals.

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

Monthly rent for rentals, asking price for sales. QuintoAndar, OLX, Chaves na Mão and Imovelweb.

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

Monthly rent for rentals, asking price for sales. QuintoAndar, OLX, Chaves na Mão and Imovelweb.

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

Minimum usable area. QuintoAndar, OLX, Chaves na Mão and Imovelweb.

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

Maximum usable area. QuintoAndar, OLX, Chaves na Mão and Imovelweb.

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

QuintoAndar, OLX, Chaves na Mão and Imovelweb. On OLX 5 means 5 or more.

## `maxBedrooms` (type: `integer`):

QuintoAndar, Imovelweb and Chaves na Mão. On OLX anything above 5 also returns listings with 5 or more.

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

QuintoAndar, OLX, Chaves na Mão and Imovelweb. On OLX 5 means 5 or more.

## `minParkingSpots` (type: `integer`):

QuintoAndar, OLX, Chaves na Mão and Imovelweb. On OLX 5 means 5 or more.

## `minSuites` (type: `integer`):

QuintoAndar, Chaves na Mão and Imovelweb. OLX has no suites filter, so OLX is skipped when this is set.

## `furnished` (type: `boolean`):

Only furnished properties. QuintoAndar, OLX, Chaves na Mão and Imovelweb.

## `petFriendly` (type: `boolean`):

Only properties that accept pets. QuintoAndar, OLX and Chaves na Mão. Imovelweb has no pets filter, so Imovelweb is skipped when this is set.

## `maxCondoFee` (type: `integer`):

Applied by the actor after the search, on every portal. Listings without a condo fee are kept.

## `publishedWithinDays` (type: `integer`):

Only listings published or renewed in the last N days, newest first. QuintoAndar, OLX, Chaves na Mão (last update) and Imovelweb (last update). QuintoAndar dates only exist on the listing page, so this opens every candidate listing even with Fetch listing details off.

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

Order of the results, which matters most when Max items is smaller than the number of matches. Newest uses the last publication, renewal or update date. QuintoAndar, OLX, Chaves na Mão and Imovelweb.

## `maxItems` (type: `integer`):

Total listings across all sources.

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

Opens each listing page to add coordinates, ZIP code, street and, on QuintoAndar, publication dates; on Imovelweb it adds amenities, IPTU and the publication date. Costs one extra request per listing, so turn it off for a much faster run that returns everything else. Chaves na Mão already returns all of that in the search, so it ignores this option.

## `proxyConfiguration` (type: `object`):

Leave empty: runs start without a proxy and, if a portal blocks or rate-limits (403/429), the actor climbs by itself to Apify Proxy datacenter, then residential in Brazil, then a real browser. On the residential rung the detail pages are skipped (listings keep the search data, without coordinates). Set a proxy here only to replace that default.

## Actor input object example

```json
{
  "sources": [
    "quintoandar",
    "olx",
    "chavesnamao",
    "imovelweb"
  ],
  "dealType": "rent",
  "state": "SP",
  "cities": [
    "Campinas"
  ],
  "furnished": false,
  "petFriendly": false,
  "sortBy": "relevance",
  "maxItems": 20,
  "fetchDetails": true
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped items in the default dataset.

# 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 = {
    "sources": [
        "quintoandar",
        "olx",
        "chavesnamao",
        "imovelweb"
    ],
    "state": "SP",
    "cities": [
        "Campinas"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("allanmxr/brazil-real-estate-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 = {
    "sources": [
        "quintoandar",
        "olx",
        "chavesnamao",
        "imovelweb",
    ],
    "state": "SP",
    "cities": ["Campinas"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("allanmxr/brazil-real-estate-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 '{
  "sources": [
    "quintoandar",
    "olx",
    "chavesnamao",
    "imovelweb"
  ],
  "state": "SP",
  "cities": [
    "Campinas"
  ],
  "maxItems": 20
}' |
apify call allanmxr/brazil-real-estate-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,allanmxr/brazil-real-estate-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/oPfZlAeXLdx2WNt3d/builds/5DIK6E2CyphJgQOgo/openapi.json
