# Quinto Andar API com monitoramento (`leadercorp/quintoandar-monitor`) Actor

Coleta e monitora imóveis do QuintoAndar. Suporta aluguel e compra, paginação completa, modo rápido/completo, monitoramento de mudanças de preço e disponibilidade.

- **URL**: https://apify.com/leadercorp/quintoandar-monitor.md
- **Developed by:** [Leadercorp](https://apify.com/leadercorp) (community)
- **Categories:** Real estate
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 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 Monitor — Actor Apify

Coleta e monitora imóveis do [QuintoAndar](https://www.quintoandar.com.br) com output estruturado, pronto para automações e BI.

---

### O que este Actor faz

- **Coleta imóveis** de aluguel ou compra no QuintoAndar
- **Pagina automaticamente** para buscar centenas de resultados
- **Normaliza os dados** em formato consistente e limpo
- **Monitora mudanças** entre execuções: novos imóveis, alterações de preço, removidos
- **Deduplica** resultados automaticamente
- **Dois modos**: rápido (listagem) ou completo (com detalhes adicionais)

---

### Casos de uso

| Caso | Descrição |
|---|---|
| Pesquisa de mercado | Colete todos os imóveis de um bairro com preços e características |
| Alerta de preço | Execute periodicamente e detecte quando um imóvel baixa de preço |
| BI e dashboards | Alimente Power BI, Metabase ou planilhas com dados atualizados |
| Comparação de bairros | Compare preços médios por região, tipo e tamanho |
| Pipeline de dados | Integre com Make, Zapier ou n8n via webhook do Apify |

---

### Como usar

#### Opção 1 — Campos de busca (recomendado)

Preencha os campos diretamente no formulário do Apify Console ou via JSON:

```json
{
  "tipoOperacao": "aluguel",
  "cidade": "Campinas",
  "bairro": "Cambuí",
  "tipoImovel": "apartamento",
  "quartos": 2,
  "precoMax": 3000,
  "mobiliado": "sim",
  "aceitaPets": "sim",
  "modo": "rapido",
  "maxItems": 200
}
````

#### Opção 2 — URL direta

Cole a URL de busca do site diretamente:

```json
{
  "urlBusca": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil/apartamento/2-quartos",
  "modo": "rapido",
  "maxItems": 100
}
```

#### Opção 3 — Com monitoramento ativo

Execute periodicamente para detectar mudanças de preço e novos imóveis:

```json
{
  "tipoOperacao": "aluguel",
  "cidade": "São Paulo",
  "tipoImovel": "apartamento",
  "quartos": 2,
  "precoMax": 4000,
  "maxItems": 500,
  "monitoramentoAtivo": true,
  "monitoramentoChave": "sp-apto-2q"
}
```

***

### Parâmetros de input

#### Busca

| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
| `urlBusca` | string | — | URL completa do QuintoAndar. Use este campo **ou** os campos abaixo. |
| `tipoOperacao` | string | `aluguel` | `aluguel` ou `compra` |
| `cidade` | string | — | Nome da cidade (ex: `São Paulo`, `Campinas`, `Curitiba`) |
| `bairro` | string | — | Nome do bairro (ex: `Pinheiros`, `Consolação`) |
| `tipoImovel` | string | — | `apartamento`, `casa`, `casacondominio` ou `kitnet` |
| `precoMin` | integer | — | Preço mínimo em R$ |
| `precoMax` | integer | — | Preço máximo em R$ |
| `areaMin` | integer | — | Área mínima em m² |
| `areaMax` | integer | — | Área máxima em m² |
| `quartos` | integer | — | Número mínimo de quartos (1–4) |
| `banheiros` | integer | — | Número mínimo de banheiros |
| `vagas` | integer | — | Vagas mínimas de garagem |
| `suites` | integer | — | Número mínimo de suítes |
| `mobiliado` | string | — | `sim` ou `nao` |
| `aceitaPets` | string | — | `sim` ou `nao` |
| `pertoMetro` | string | — | `sim` ou `nao` |
| `disponibilidade` | string | — | `imediata` ou `em_breve` |

#### Execução

| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
| `modo` | string | `rapido` | `rapido`: só listagem · `completo`: inclui detalhes por imóvel |
| `maxItems` | integer | `200` | Limite de imóveis a coletar (máx: 10.000) |

#### Monitoramento

| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
| `monitoramentoAtivo` | boolean | `false` | Ativa comparação com a execução anterior |
| `monitoramentoChave` | string | — | Identificador único da busca. Deixe em branco para usar o slug da URL. |

***

### Output

Cada item do dataset representa um imóvel:

```json
{
  "fonte": "quintoandar",
  "idImovel": "895147323",
  "url": "https://www.quintoandar.com.br/imovel/895147323",
  "tipoOperacao": "aluguel",
  "tipoImovel": "apartamento",
  "titulo": "Apartamento 110m² com 1 quarto para alugar em Consolação, São Paulo",

  "cidade": "São Paulo",
  "estado": "SP",
  "bairro": "Consolação",
  "endereco": "Rua Frei Caneca",

  "precoAluguel": 6760,
  "precoCondominio": 2200,
  "precoIPTU": null,
  "precoTotalMensal": 8960,

  "areaM2": 110,
  "quartos": 1,
  "banheiros": 2,
  "vagas": 1,
  "suites": 1,
  "mobiliado": true,
  "aceitaPets": null,
  "pertoMetro": true,
  "disponivel": true,

  "descricao": "Apartamento mobiliado na Consolação com 1 suíte.",
  "comodidades": ["AR_CONDICIONADO", "MAQUINA_DE_LAVAR", "MICROONDAS"],
  "comodidadesPredio": ["SALAO_DE_FESTAS", "PERTO_DE_METRO_OU_TREM"],
  "imagens": ["https://www.quintoandar.com.br/img/med/..."],

  "coletadoEm": "2025-01-15T10:30:00.000Z",
  "modo": "rapido",
  "status": "ativo",
  "fingerprint": "a3f9b2c1d4e5"
}
```

#### Campos extras quando monitoramento está ativo

```json
{
  "tipoAlteracao": "alterado",
  "precoAlterado": true,
  "precoAnterior": 7000,
  "precoAtual": 6760,
  "variacaoPreco": -240,
  "variacaoPercentual": -3.43,
  "disponibilidadeAlterada": false,
  "vistoPrimeiraVez": "2025-01-10T08:00:00.000Z",
  "vistoUltimaVez": "2025-01-15T10:30:00.000Z"
}
```

`tipoAlteracao` pode ser:

- **`novo`** — imóvel que apareceu pela primeira vez
- **`alterado`** — preço ou disponibilidade mudou
- **`removido`** — imóvel não apareceu em 2+ execuções consecutivas

***

### Modos de execução

#### `rapido` (padrão)

- Coleta apenas dados da listagem
- Rápido e eficiente — ideal para monitoramento e coleta em escala

#### `completo`

- Inclui dados da página de detalhe de cada imóvel
- Adiciona: descrição completa, aceitação de pets confirmada
- Mais lento — use quando precisar dos campos adicionais

***

### Uso via API

#### Disparar execução

```bash
curl -X POST "https://api.apify.com/v2/acts/SEU_USERNAME~quintoandar-monitor/runs" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tipoOperacao": "aluguel",
    "cidade": "São Paulo",
    "quartos": 2,
    "precoMax": 4000,
    "maxItems": 200,
    "modo": "rapido"
  }'
```

#### Verificar status e baixar resultados

```bash
## Verifica status
curl "https://api.apify.com/v2/actor-runs/RUN_ID" \
  -H "Authorization: Bearer SEU_TOKEN"

## Baixa dataset em JSON
curl "https://api.apify.com/v2/actor-runs/RUN_ID/dataset/items?format=json" \
  -H "Authorization: Bearer SEU_TOKEN"

## Baixa em CSV
curl "https://api.apify.com/v2/actor-runs/RUN_ID/dataset/items?format=csv" \
  -H "Authorization: Bearer SEU_TOKEN"
```

***

### Monitoramento de mudanças

O monitoramento compara os resultados de cada execução com a execução anterior e classifica cada imóvel com um `tipoAlteracao`:

| Valor | Significado |
|---|---|
| `novo` | Imóvel apareceu pela primeira vez nesta busca |
| `alterado` | Preço ou disponibilidade mudou em relação à execução anterior |
| `removido` | Imóvel não apareceu em 2 execuções consecutivas |

Imóveis sem alteração não recebem o campo `tipoAlteracao`.

#### Como ativar

Adicione `monitoramentoAtivo: true` ao input. O campo `monitoramentoChave` é opcional — serve para identificar a busca quando você tem múltiplas buscas monitoradas na mesma conta. Se não for informado, o Actor usa o slug da URL automaticamente.

```json
{
  "tipoOperacao": "aluguel",
  "cidade": "São Paulo",
  "tipoImovel": "apartamento",
  "quartos": 2,
  "maxItems": 500,
  "monitoramentoAtivo": true,
  "monitoramentoChave": "sp-apto-2q"
}
```

#### Execuções agendadas

Configure o **Apify Scheduler** para rodar diariamente (ou na frequência que desejar). A cada execução o Actor carrega o estado anterior, compara, e salva o novo estado — tudo automaticamente, sem configuração extra.

#### Alertas em tempo real

Combine com os **webhooks da Apify** para receber notificações assim que a execução terminar. Configure o webhook para disparar quando `status = SUCCEEDED` e filtre os itens com `tipoAlteracao = novo` ou `tipoAlteracao = alterado` no seu sistema de destino (planilha, e-mail, Slack, CRM, etc.).

#### Histórico

O estado de cada execução é persistido no **KV Store** da Apify vinculado ao Actor. Cada `monitoramentoChave` tem seu próprio histórico isolado, permitindo monitorar múltiplas buscas simultaneamente sem interferência.

***

### Limitações

- O QuintoAndar pode alterar sua estrutura interna sem aviso
- O número máximo de imóveis por busca é limitado pelo site (~37.000 em SP)
- Imóveis "em breve" podem não ter preço definido
- O campo `precoIPTU` não é separado do condomínio na listagem rápida

***

### Suporte

Encontrou um problema ou tem sugestões? Entre em contato pelo marketplace da Apify.

# Actor input Schema

## `urlBusca` (type: `string`):

URL completa do QuintoAndar (ex: https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil). Use este campo OU os filtros abaixo.

## `tipoOperacao` (type: `string`):

Aluguel ou compra

## `cidade` (type: `string`):

Nome da cidade (ex: São Paulo, Rio de Janeiro, Campinas, Curitiba, Brasília)

## `bairro` (type: `string`):

Nome do bairro (ex: Pinheiros, Consolação, Moema)

## `tipoImovel` (type: `string`):

Filtrar por tipo de imóvel

## `precoMin` (type: `integer`):

Valor mínimo de aluguel ou venda em reais

## `precoMax` (type: `integer`):

Valor máximo de aluguel ou venda em reais

## `areaMin` (type: `integer`):

Área mínima do imóvel em metros quadrados

## `areaMax` (type: `integer`):

Área máxima do imóvel em metros quadrados

## `quartos` (type: `integer`):

Número mínimo de quartos

## `banheiros` (type: `integer`):

Número mínimo de banheiros

## `vagas` (type: `integer`):

Número mínimo de vagas de garagem

## `suites` (type: `integer`):

Número mínimo de suítes

## `mobiliado` (type: `string`):

Filtrar por imóveis mobiliados ou não

## `aceitaPets` (type: `string`):

Filtrar por imóveis que aceitam animais de estimação

## `pertoMetro` (type: `string`):

Filtrar por imóveis próximos a estações de metrô ou trem

## `disponibilidade` (type: `string`):

Filtrar por disponibilidade imediata ou em breve

## `modo` (type: `string`):

rapido: apenas listagem (alta performance) | completo: inclui detalhes do imóvel

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

Limite de imóveis a coletar por execução

## `monitoramentoAtivo` (type: `boolean`):

Se ativo, compara com a execução anterior e detecta imóveis novos, com preço alterado e removidos

## `monitoramentoChave` (type: `string`):

Identificador único para esta busca. Deixe em branco para usar o slug da URL automaticamente.

## Actor input object example

```json
{
  "tipoOperacao": "aluguel",
  "modo": "rapido",
  "maxItems": 200,
  "monitoramentoAtivo": false
}
```

# Actor output Schema

## `imoveis` (type: `string`):

Dataset com todos os imóveis coletados. Cada item contém: idImovel, tipoOperacao, tipoImovel, titulo, cidade, bairro, endereco, precoAluguel, precoVenda, precoCondominio, precoIPTU, precoTotalMensal, areaM2, quartos, banheiros, vagas, suites, mobiliado, aceitaPets, disponivel, comodidades, comodidadesPredio, imagens, fingerprint, coletadoEm. Quando monitoramento ativo: tipoAlteracao (novo|alterado|removido), precoAnterior, variacaoPercentual.

## `historico` (type: `string`):

Key-value store com o estado persistido da última execução, usado para detectar novos imóveis, alterações de preço e remoções em execuções futuras. Relevante apenas quando monitoramento.ativo = true.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("leadercorp/quintoandar-monitor").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("leadercorp/quintoandar-monitor").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 '{}' |
apify call leadercorp/quintoandar-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=leadercorp/quintoandar-monitor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Quinto Andar API com monitoramento",
        "description": "Coleta e monitora imóveis do QuintoAndar. Suporta aluguel e compra, paginação completa, modo rápido/completo, monitoramento de mudanças de preço e disponibilidade.",
        "version": "1.0",
        "x-build-id": "GKSFWZS0bgRf18gZX"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/leadercorp~quintoandar-monitor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-leadercorp-quintoandar-monitor",
                "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/leadercorp~quintoandar-monitor/runs": {
            "post": {
                "operationId": "runs-sync-leadercorp-quintoandar-monitor",
                "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/leadercorp~quintoandar-monitor/run-sync": {
            "post": {
                "operationId": "run-sync-leadercorp-quintoandar-monitor",
                "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",
                "properties": {
                    "urlBusca": {
                        "title": "URL de busca",
                        "type": "string",
                        "description": "URL completa do QuintoAndar (ex: https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil). Use este campo OU os filtros abaixo."
                    },
                    "tipoOperacao": {
                        "title": "Tipo de operação",
                        "enum": [
                            "aluguel",
                            "compra"
                        ],
                        "type": "string",
                        "description": "Aluguel ou compra",
                        "default": "aluguel"
                    },
                    "cidade": {
                        "title": "Cidade",
                        "type": "string",
                        "description": "Nome da cidade (ex: São Paulo, Rio de Janeiro, Campinas, Curitiba, Brasília)"
                    },
                    "bairro": {
                        "title": "Bairro",
                        "type": "string",
                        "description": "Nome do bairro (ex: Pinheiros, Consolação, Moema)"
                    },
                    "tipoImovel": {
                        "title": "Tipo de imóvel",
                        "enum": [
                            "apartamento",
                            "casa",
                            "casacondominio",
                            "kitnet"
                        ],
                        "type": "string",
                        "description": "Filtrar por tipo de imóvel"
                    },
                    "precoMin": {
                        "title": "Preço mínimo (R$)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Valor mínimo de aluguel ou venda em reais"
                    },
                    "precoMax": {
                        "title": "Preço máximo (R$)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Valor máximo de aluguel ou venda em reais"
                    },
                    "areaMin": {
                        "title": "Área mínima (m²)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Área mínima do imóvel em metros quadrados"
                    },
                    "areaMax": {
                        "title": "Área máxima (m²)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Área máxima do imóvel em metros quadrados"
                    },
                    "quartos": {
                        "title": "Quartos (mínimo)",
                        "minimum": 1,
                        "maximum": 4,
                        "type": "integer",
                        "description": "Número mínimo de quartos"
                    },
                    "banheiros": {
                        "title": "Banheiros (mínimo)",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Número mínimo de banheiros"
                    },
                    "vagas": {
                        "title": "Vagas de garagem (mínimo)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Número mínimo de vagas de garagem"
                    },
                    "suites": {
                        "title": "Suítes (mínimo)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Número mínimo de suítes"
                    },
                    "mobiliado": {
                        "title": "Mobiliado",
                        "enum": [
                            "sim",
                            "nao"
                        ],
                        "type": "string",
                        "description": "Filtrar por imóveis mobiliados ou não"
                    },
                    "aceitaPets": {
                        "title": "Aceita pets",
                        "enum": [
                            "sim",
                            "nao"
                        ],
                        "type": "string",
                        "description": "Filtrar por imóveis que aceitam animais de estimação"
                    },
                    "pertoMetro": {
                        "title": "Próximo ao metrô",
                        "enum": [
                            "sim",
                            "nao"
                        ],
                        "type": "string",
                        "description": "Filtrar por imóveis próximos a estações de metrô ou trem"
                    },
                    "disponibilidade": {
                        "title": "Disponibilidade",
                        "enum": [
                            "imediata",
                            "em_breve"
                        ],
                        "type": "string",
                        "description": "Filtrar por disponibilidade imediata ou em breve"
                    },
                    "modo": {
                        "title": "Modo de execução",
                        "enum": [
                            "rapido",
                            "completo"
                        ],
                        "type": "string",
                        "description": "rapido: apenas listagem (alta performance) | completo: inclui detalhes do imóvel",
                        "default": "rapido"
                    },
                    "maxItems": {
                        "title": "Máximo de imóveis",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Limite de imóveis a coletar por execução",
                        "default": 200
                    },
                    "monitoramentoAtivo": {
                        "title": "Ativar monitoramento",
                        "type": "boolean",
                        "description": "Se ativo, compara com a execução anterior e detecta imóveis novos, com preço alterado e removidos",
                        "default": false
                    },
                    "monitoramentoChave": {
                        "title": "Chave de monitoramento (opcional)",
                        "type": "string",
                        "description": "Identificador único para esta busca. Deixe em branco para usar o slug da URL automaticamente."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
