Pricing

Rating

Developer

Actor stats

Categories

Share

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

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

Execução

Monitoramento

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:

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.