# $1.5/1K 💜 Quintoandar Scraper ⚡Brazil Real Estate API (`azzouzana/quintoandar-scraper`) Actor
🔥 Rápido, simples e barato! Insira o link e extraia em segundos dados completos de imóveis no QuintoAndar: preço, fotos, condomínio, tipo, localização e mais. Exportação em JSON/CSV/Excel ou use como API. Perfeito para análise e monitoramento do mercado imobiliário 🚀
- **URL**: https://apify.com/azzouzana/quintoandar-scraper.md
- **Developed by:** [Azzouzana](https://apify.com/azzouzana) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 52 total users, 3 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 3.70 out of 5 stars
## Pricing
$1.50 / 1,000 results
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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## QuintoAndar Real Estate Scraper (By search URL)
A ferramenta mais poderosa e eficiente para extrair dados imobiliários do [QuintoAndar](https://www.quintoandar.com.br). Seja para analisar tendências de mercado, monitorar preços ou construir um portal imobiliário, este actor fornece dados estruturados e de alta qualidade **em segundos**.
### 🚀 Principais Funcionalidades
- **Desempenho Ultra Rápido**: Otimizado para velocidade máxima.
- **Modo de Raspagem Profunda**: Vá além dos resultados de pesquisa. Extraia detalhes completos da propriedade, incluindo comodidades quarto por quarto, instalações do prédio, insights profundos do bairro, endereço e muito mais.
- **Fácil de Usar**: Basta inserir o URL de pesquisa do QuintoAndar e deixar o actor fazer o resto. Sem necessidade de conhecimento técnico ou configuração complexa.
---
### 🔍 Como Começar
1. **Pesquisar**: Vá para [QuintoAndar.com.br](https://www.quintoandar.com.br) e execute sua pesquisa normalmente.
2. **Copiar URL**: Copie o URL da barra de endereços do seu navegador. Exemplo `https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/de-500-a-1000-aluguel/de-20-a-30-m2`
3. **Executar**: Cole o URL no campo `searchUrl` deste actor e clique em **Iniciar**.
---
### 🛠️ Configuração
| Campo | Tipo | Padrão | Descrição |
| :--- | :--- | :--- | :--- |
| `searchUrl` | String | (Obrigatório) | O URL dos resultados de pesquisa do QuintoAndar. |
| `maxItems` | Número | `12` | Número máximo de itens a processar |
---
### 📊 Exemplo de Saída
O actor fornece um conjunto de dados rico. Abaixo está uma entrada de exemplo de propriedade:
```json
{
"acceptsPets": false,
"address": {
"city": "São Paulo",
"country": "Brasil",
"countryCode": "BR",
"countryName": "Brasil",
"lat": -23.5273021,
"lng": -46.4672914,
"neighborhood": "Cidade Antônio Estêvão de Carvalho",
"stateAcronym": "SP",
"stateName": "São Paulo",
"street": "Avenida Caititu",
"zipCode": "08223-000"
},
"allowDirectOffer": true,
"amenities": [
{
"key": "VARANDA",
"optional": false,
"text": "Varanda",
"value": "NAO"
},
{
"key": "PISCINA_PRIVATIVA",
"optional": false,
"text": "Piscina privativa",
"value": "NAO"
},
{
"key": "ARMARIOS_EMBUTIDOS_NO_QUARTO",
"optional": false,
"text": "Armários no quarto",
"value": "NAO"
}
...
],
"condoPrice": 0,
"condoType": "IncluidoNoAluguel",
"condominium": {
"error": {
"details": {
"code": 404,
"message": "Not found exception. Entity id: dyosw9xryk"
},
"response": {}
}
},
"constructionYear": null,
"displayId": "1330901",
"error": false,
"forRent": true,
"forSale": false,
"generatedDescription": {},
"hasFurniture": false,
"homeProtection": 12,
"houseAgent": {
"alreadyOpenedByQueryParam": false,
"isDialogOpen": false
},
"houseVisitStatus": "ACCEPT_NEW",
"id": "894030901",
"installations": [
{
"key": "PISCINA",
"text": "Piscina",
"value": "NAO"
},
{
"key": "CHURRASQUEIRA",
"text": "Churrasqueira",
"value": "NAO"
},
{
"key": "SAUNA",
"text": "Sauna",
"value": "NAO"
}
...
],
"iptu": 0,
"iptuType": "NaoInformado",
"isGalleryModalOpen": false,
"isNearSubway": false,
"isNewOrRenovated": false,
"isPrimaryMarket": false,
"isReserved": false,
"lastPublishedDate": "2025-12-18T17:49:01.000Z",
"listingPublication": "not_stranded",
"listingTags": [],
"listings": [
{
"businessContext": "RENT",
"firstPublicationDate": "2023-04-14T21:24:10.000+0000",
"imovelId": 894030901,
"isEarlyRelisting": true,
"lastPublicationDate": "2025-12-18T17:49:01.000+0000",
"listingRentModel": {
"listingBusinessContextId": 1555934,
"rentalAdministrator": "QUINTOANDAR"
},
"ownership": "STANDARD",
"relistingDetailsDTO": {
"isEarlyRelisting": true,
"isOwnerInRelistingExperiment": true,
"isRelistingPublished": true,
"isRelistingScheduled": false,
"isUnderTermination": true,
"newContractCreatedId": null,
"possibleMovingDate": "2026-01-27T00:00:00.000+0000",
"publishAllowed": true,
"relistingPublishDate": "2025-12-18T17:49:01.000+0000",
"underTerminationContractId": 543001
},
"status": "publicado",
"statusReason": "RELISTING_OFFER",
"suspensionReason": "RELISTING"
}
],
"loaded": true,
"loading": false,
"loadingCategorizedRooms": false,
"macroRegion": {
"id": 2767,
"name": "SPOO13"
},
"mortgageFirstInstallment": 0,
"parkingSpaces": 0,
"photos": [
{
"cover": true,
"id": 37657938,
"subtitle": "Quarto Suíte",
"url": "894030901-451.57199404263616AvenidaCaititu1268Casa41.JPG"
},
{
"cover": false,
"id": 37657941,
"subtitle": "Quarto Suíte",
"url": "894030901-465.0701435281591AvenidaCaititu1268Casa42.JPG"
}
...
],
"photosCategorizedByRooms": [],
"placesNearby": [
{
"name": "SESI Cidade AE Carvalho",
"slug": "sesi-cidade-ae-carvalho-artur-alvim-sao-paulo-sp",
"type": "SCHOOL"
},
{
"name": "Shopping Metrô Itaquera",
"slug": "shopping-metro-itaquera-itaquera-sao-paulo-sp",
"type": "SHOPPING_MALL"
},
{
"name": "Centro Social Santa Luzia",
"slug": "centro-social-santa-luzia-artur-alvim-sao-paulo-sp",
"type": "SCHOOL"
}
],
"practicalityCommodities": [
{
"key": "BOX",
"optional": false,
"text": "Box",
"value": "NAO"
},
{
"key": "ARMARIOS_EMBUTIDOS_NO_QUARTO",
"optional": false,
"text": "Armários no quarto",
"value": "NAO"
},
...
],
"promotions": [],
"rangeFloor": {},
"region": {
"hub": {
"enabled": false,
"isPrimaryMarket": false,
"loading": "UNSET"
},
"id": 2368,
"name": "Itaquera"
},
"regionParameters": {
"RENT": {
"talkToAgentEnabled": false,
"visitsEnabled": true
},
"SALE": {
"talkToAgentEnabled": false,
"visitsEnabled": true
},
"loaded": false,
"loading": false
},
"relevantRegions": [],
"remarks": "",
"rentOnTermination": true,
"rentPrice": 700,
"rentalGuarantee": {
"loaded": true,
"maxValue": 525,
"minValue": 175,
"value": 0
},
"reservationAvailability": null,
"salePrice": 0,
"selectedMedia": "tenant/HouseMedia/GALLERY_PHOTOS",
"showUrlHasBeenCopiedSnackbar": false,
"specialConditions": [
"Exclusivity"
],
"status": "published",
"suites": 1,
"tenantServiceFee": 18,
"terminationDate": "2026-01-05",
"totalCost": 730,
"type": "Casa",
"video": "",
"visitStatusReason": null,
"visitsUnavailable": false
}
````
### 🆓 Limitações do Plano Gratuito
Queremos que você veja como este actor funciona antes de se comprometer. Para manter as coisas justas para todos, o **plano gratuito** geralmente inclui estes limites de teste:
- **Dados de amostra:** até **5 anúncios** por execução—o suficiente para verificar a qualidade dos dados.
- **Limite diário:** **5 execuções** por dia civil (UTC).
- **Entre execuções:** pelo menos **30 minutos** antes de poder iniciar outra execução.
> Os limites podem mudar com a carga da plataforma, dependendo da carga do sistema e do seu volume de raspagem planejado.
#### Atualize quando estiver pronto para escalar
Use o plano gratuito para decidir se este actor se encaixa no seu projeto. Os planos pagos da Apify removem esses tempos de espera e limites para que você possa executar em volume total—[**atualize para um plano pago**](https://apify.com/pricing?fpr=cbgdsf).
***
### 📬 Contato e Soluções Personalizadas
Precisa de um raspador personalizado, entrega de dados históricos ou integração de API?
- **Discord**: `@azzouzana`
- **Email**: `labs@azzouzana.com`
***
***
## QuintoAndar Real Estate Scraper
The most powerful and efficient tool for extracting real estate data from [QuintoAndar](https://www.quintoandar.com.br). Whether you are analyzing market trends, monitoring prices, or building a property portal, this actor provides high-quality, structured data **in seconds**
### 🚀 Key Features
- **Blazing Fast Performance**: Optimized for maximum speed.
- **Deep Scraping Mode**: Go beyond search results. Extract full property details including room-by-room amenities, building installations, and deep neighborhood insights, addtresse & much more
- **Easy to Use**: Just plug in your QuintoAndar search URL and let the actor do the rest. No technical knowledge or complex configuration required
***
### 🔍 How to Start
1. **Search**: Go to [QuintoAndar.com.br](https://www.quintoandar.com.br) and execute your search as usual.
2. **Copy URL**: Copy the URL from your browser's address bar. Example `https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/de-500-a-1000-aluguel/de-20-a-30-m2`
3. **Run**: Paste the URL into the `searchUrl` input field of this actor and click **Start**.
***
### 🛠️ Configuration
| Field | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `searchUrl` | String | (Required) | The QuintoAndar search results URL. |
| `maxItems` | Number | `12` | Maximum number of items to process |
***
### 📊 Sample Output
The actor provides a rich dataset. Below is a sample property entry:
> *([See JSON output in the Portuguese section above](#exemplo-de-saida))*
***
### 🆓 Free tier limitations
We want you to see how this actor works before you commit. To keep things fair for everyone, the **free tier** usually includes these trial limits:
- **Sample data:** up to **5 listings** per run—enough to check data quality.
- **Daily cap:** **5 runs** per calendar day (UTC).
- **Between runs:** at least **30 minutes** before you can start another run.
> Limits can change with platform load depending on system load and your intended scraping to prevent what we might interpret as free users abuse.
#### Upgrade when you're ready!
Use the free tier to decide if this actor fits your project. Paid Apify plans remove these wait times and caps so you can run at full volume—[**upgrade to a paid plan**](https://apify.com/pricing?fpr=cbgdsf).
***
### 📬 Contact & Custom Solutions
Need a custom scraper, historical data delivery, or API integration?
- **Discord**: `@azzouzana`
- **Email**: `labs@azzouzana.com`
# Actor input Schema
## `searchUrl` (type: `string`):
A URL de busca do QuintoAndar a partir da qual iniciar | The QuintoAndar search URL to start from.
## `maxItems` (type: `integer`):
Número máximo de itens a serem coletados | Maximum number of items to scrape.
## Actor input object example
```json
{
"searchUrl": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil",
"maxItems": 12
}
```
# 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 = {
"searchUrl": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil"
};
// Run the Actor and wait for it to finish
const run = await client.actor("azzouzana/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 = { "searchUrl": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil" }
# Run the Actor and wait for it to finish
run = client.actor("azzouzana/quintoandar-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"searchUrl": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil"
}' |
apify call azzouzana/quintoandar-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=azzouzana/quintoandar-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "$1.5/1K 💜 Quintoandar Scraper ⚡Brazil Real Estate API",
"description": "🔥 Rápido, simples e barato! Insira o link e extraia em segundos dados completos de imóveis no QuintoAndar: preço, fotos, condomínio, tipo, localização e mais. Exportação em JSON/CSV/Excel ou use como API. Perfeito para análise e monitoramento do mercado imobiliário 🚀",
"version": "0.0",
"x-build-id": "Njugb1hwRmtGKbyeh"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/azzouzana~quintoandar-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-azzouzana-quintoandar-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/azzouzana~quintoandar-scraper/runs": {
"post": {
"operationId": "runs-sync-azzouzana-quintoandar-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/azzouzana~quintoandar-scraper/run-sync": {
"post": {
"operationId": "run-sync-azzouzana-quintoandar-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"searchUrl"
],
"properties": {
"searchUrl": {
"title": "Search URL",
"type": "string",
"description": "A URL de busca do QuintoAndar a partir da qual iniciar | The QuintoAndar search URL to start from."
},
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Número máximo de itens a serem coletados | Maximum number of items to scrape.",
"default": 12
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```