QuintoAndar Monitor — Actor Apify

Coleta e monitora imóveis do QuintoAndar 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:

{
  "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:

{
  "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:

{
  "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:

{
  "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

{
  "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

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

# 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.

{
  "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.