QuintoAndar Imoveis Brasil

Transforme buscas do QuintoAndar em uma base estruturada para inteligencia imobiliaria, monitoramento de precos, analise de oferta e prospeccao no mercado residencial brasileiro.

Use este Actor para acompanhar imoveis de aluguel e compra com dados prontos para planilhas, dashboards, CRM, BI e estudos de mercado. Cada resultado inclui uma URL de origem para auditoria e revisao individual.

Ideal para

• Monitorar precos de aluguel e venda por cidade, bairro ou regiao
• Acompanhar estoque residencial e novas oportunidades de mercado
• Comparar atributos de imoveis semelhantes
• Alimentar dashboards de inteligencia imobiliaria
• Enriquecer bases internas com dados comerciais verificaveis
• Criar amostras de mercado com custo controlado

O que voce recebe

• ID da listagem
• URL auditavel do imovel
• URL da busca de origem
• Aluguel, custo total e preco de venda
• Bairro, regiao, cidade e endereco
• Area, quartos, banheiros, suites e vagas
• Tipo de imovel
• Flags de aluguel/compra
• Mobiliado
• Condicoes especiais e tags
• Comodidades e instalacoes
• Imagem principal e lista de imagens
• Pagina e posicao na busca

Exemplo de input

{
  "startUrls": [
    "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil"
  ],
  "maxItemsPerUrl": 24,
  "maxPagesPerUrl": 2,
  "startPage": 1,
  "pageSize": 12,
  "failOnNoResults": false
}

Para compra, use uma URL /comprar/imovel/... ou informe businessContext: "SALE" junto com locationSlugs.

Os limites padrao foram pensados para uma primeira execucao economica. Aumente maxItemsPerUrl e maxPagesPerUrl gradualmente conforme a cobertura desejada.

Exemplo de resultado

{
  "status": "success",
  "country": "BR",
  "source": "QuintoAndar",
  "business_context": "RENT",
  "listing_id": "895323482",
  "title": "Kitnet mobiliada para aluguel na Republica, 1 quarto.",
  "property_type": "StudioOuKitchenette",
  "neighborhood": "Republica",
  "region": "Santa Cecilia",
  "city": "Sao Paulo",
  "area_m2": 49,
  "bedrooms": 1,
  "bathrooms": 1,
  "rent_price": 4450,
  "total_cost": 6422,
  "currency": "BRL",
  "source_url": "https://www.quintoandar.com.br/imovel/895323482/alugar",
  "search_url": "https://www.quintoandar.com.br/alugar/imovel/sao-paulo-sp-brasil",
  "page": 1,
  "rank": 1
}

Custo e controle

Cada imovel entregue com status: "success" cobra o evento result a USD 0.003.

Linhas de status no_results, blocked e failed ajudam a auditar a execucao e nao representam imoveis entregues.

Estados de saida

• success: imovel encontrado e entregue no dataset
• no_results: a busca nao encontrou imoveis
• blocked: a fonte restringiu a consulta naquele momento
• failed: a entrada nao pode ser processada

Observacoes

• O Actor entrega dados de listagens de busca, com foco em comparacao e monitoramento de mercado.
• URLs ou slugs de localizacao nao reconhecidos retornam no_results.
• Use limites menores para validacoes rapidas e aumente o volume quando a configuracao estiver pronta.