Bradesco Imóveis API

Extraia anúncios de leilões imobiliários do site Vitrine Bradesco usando um Actor simples na Apify. Este Actor abre a página de leilões e salva os resultados no dataset padrão.

Recomendação de Proxy

Recomendamos usar Apify Proxy em execuções de produção.

Este Actor depende de abrir o site em um navegador e capturar respostas da API enquanto faz scroll. Sem proxy, a execução pode ficar menos estável, principalmente em coletas maiores, execuções repetidas ou quando o site começar a limitar ou bloquear requisições.

Configuração recomendada:

{
  "proxy": {
    "useApifyProxy": true
  }
}

Se você pretende rodar em escala, mantenha o proxy habilitado desde o início.

Entrada

O Actor aceita filtros de localização, filtros de listagem e limites de coleta.

Campos de entrada

Campo	Tipo	Descrição
uf	String	Filtra por estado. Exemplo: SP, RJ, RS.
city	String	Nome da cidade. O Actor resolve automaticamente o ID da cidade usando a base interna. Exemplo: Campinas.
cityId	Integer	ID da cidade usado pelo site. Se city e cityId forem enviados juntos, cityId tem prioridade.
debts	Boolean	Aplica o filtro de imóveis sem dívidas.
allow_visit	Boolean	Aplica o filtro de imóveis com visita permitida.
maxPages	Integer	Número máximo de páginas únicas da API que podem ser capturadas. Padrão: 400.
maxScrollRetries	Integer	Número de scrolls consecutivos sem nova página antes de encerrar a execução. Padrão: 8.
scrollDelayMs	Integer	Tempo de espera após cada scroll, em milissegundos. Padrão: 1500.
proxy.useApifyProxy	Boolean	Ativa o Apify Proxy. Recomendado: true.
proxy.apifyProxyGroups	Array	Grupos opcionais do proxy da Apify.
proxy.apifyProxyCountry	String	País opcional para o proxy.

Exemplo de entrada

{
  "uf": "SP",
  "city": "Campinas",
  "debts": true,
  "allow_visit": true,
  "maxPages": 100,
  "maxScrollRetries": 8,
  "scrollDelayMs": 1500,
  "proxy": {
    "useApifyProxy": true
  }
}

Observações sobre a entrada

• Use cityId se você já conhece o ID exato da cidade no site.
• Use city se quiser que o Actor resolva esse ID automaticamente.
• Se nenhum filtro for enviado, o Actor inicia com a listagem padrão configurada para este Actor.

Saída

O Actor salva os resultados no dataset padrão. Durante a execução, você pode receber até quatro tipos de registro:

• item de imóvel
• registro de resumo
• registro de nenhum resultado
• registro de erro

1. Item de imóvel

Cada imóvel retornado pela API capturada é salvo como um item no dataset. O Actor preserva os campos originais retornados pelo site e adiciona metadados com prefixo _.

Exemplo real de saída:

{
  "guid": "ba098185-319f-4e7f-83f1-41255e21fe54",
  "auctioneer": {
    "guid": "f76841e7-03e2-455d-8291-6580ee4abf1c",
    "name": "Pestana Leilões",
    "website": "https://www.leiloes.com.br/",
    "crawl_token": "pestana_leiloes",
    "profile_image": "https://images.vitrinebradesco.com.br/pestana_leiloes/header-logo.4fc203fd9a36695bdccaa27a7a50da6c.svg",
    "owners_names": "Liliamar Fátima Parmeggiani Pestana Marques Gomes",
    "last_sync_at": "2026-03-30T17:32:59.000Z",
    "sync_status": "success"
  },
  "name": "Casa - Rondonópolis/MT - Rua Maria Amanda Gonçalves Do Ó 221 (Lote 18 da Quadra 45) Lot. Parque das Rosas",
  "price": 310000,
  "auction_date": "2026-03-30T14:00:00.000Z",
  "images": [
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946137198",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946139140",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946141699",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946143788",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946145605",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946147280",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946149331",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946181311",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946183043",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946185078",
    "https://images.vitrinebradesco.com.br/pestana_leiloes/442263/1773946186814"
  ],
  "city": "Rondonópolis",
  "state": "MT",
  "description": "Rua Maria Amanda Gonçalves Do Ó, 221 - (Lote 18 da Quadra 45) - Lot. Parque das Rosas. Área Construída: 58,52m² Área de Terreno: 250,00m². Matrícula: 88116. Obs.: INFORMAÇÕES ALTERADAS CONFORME TRECHO DESTACADO NO TEXTO. Regularizações e encargos perante os órgãos competentes, inclusive quanto a eventual divergência de área construída que vier a ser apurada no local com a lançada em cadastro imobiliário e averbada no RI, correrão por conta do(a) comprador(a). O(A) VENDEDOR(A) TOMOU CONHECIMENTO DA(S) SEGUINTE(S) AÇÃO(ÕES) JUDICIAL(IS): AÇÃO ANULATÓRIA DE PROCEDIMENTO DE CONSOLIDAÇÃO DA PROPRIEDADE FIDUCIÁRIA C/C SUSPENSÃO DE LEILÃO EXTRAJUDICIAL COM PEDIDO DE TUTELA PROVISÓRIA DE URGÊNCIA, PROCESSOS N° 1033987-47.2025.8.11.0003, EM TRÂMITE NA 3ª VARA CÍVEL DE RONDONÓPOLIS/MT. O VENDEDOR RESPONDE PELO RESULTADO DA AÇÃO, DE ACORDO COM OS CRITÉRIOS E LIMITES ESTABELECIDOS NAS “CONDIÇÕES DE VENDA DOS IMÓVEIS” CONSTANTES DO EDITAL. APURAÇÃO, CONFIRMAÇÃO E PAGAMENTO DE EVENTUAIS DÉBITOS INCIDENTES SOBRE O IMÓVEL POR CONTA DO ARREMATANTE. IPTU APURADO EM APROXIMADAMENTE R$ 1.000,00. Ocupado. (AF). Ação Judicial: Vide Edital.",
  "neighborhood": "Lot. Parque das Rosas",
  "is_waste": null,
  "created_at": "2026-03-19T18:46:18.000Z",
  "type": "realstate",
  "realstate_auction_type": "convencional",
  "min_auction_value_1": null,
  "min_auction_value_2": null,
  "final_auction_value": null,
  "date_auction_1": null,
  "date_auction_2": null,
  "final_date_auction": null,
  "category": "Casa",
  "slug": "casa-rondonopolismt-rua-maria-amanda-goncalves-do-o-221-lote-18-da-quadra-45-lot-parque-das-rosas-6_1",
  "currency": null,
  "_page": 1,
  "_capturedAt": "2026-03-30T17:42:07.343Z",
  "_sourceUrl": "https://api.vitrinebradesco.com.br/v1/auctions?page=1&type=realstate",
  "_type": "realstate",
  "_totalPages": 10,
  "_totalAuctions": 291
}

Principais metadados adicionados pelo Actor:

Campo	Descrição
_page	Página da API em que o item foi capturado.
_capturedAt	Data e hora da captura em formato ISO.
_sourceUrl	URL da resposta da API usada como origem.
_type	Tipo de leilão usado na execução.
_totalPages	Total de páginas informado pela API, quando disponível.
_totalAuctions	Total de leilões informado pela API, quando disponível.

2. Registro de resumo

Ao final da execução, o Actor grava um item de resumo para facilitar a validação do resultado.

Exemplo:

{
  "_summary": true,
  "_capturedAt": "2026-04-01T12:30:00.000Z",
  "_sourceUrl": "https://vitrinebradesco.com.br/auctions?type=realstate&ufs=SP&city=12345",
  "_type": "realstate",
  "monetizationMode": "legacy",
  "monetizationEventName": "auction-item",
  "uniquePagesCaptured": 20,
  "totalItemsCaptured": 387,
  "totalPagesFromApi": 20,
  "totalAuctionsFromApi": 387,
  "stopReason": "TOTAL_PAGES_REACHED"
}

3. Registro de nenhum resultado

Se os filtros selecionados não retornarem imóveis, o Actor grava um registro indicando isso.

{
  "_notFound": true,
  "_capturedAt": "2026-04-01T12:05:00.000Z",
  "_sourceUrl": "https://vitrinebradesco.com.br/auctions?type=realstate&ufs=SP&city=99999",
  "_type": "realstate",
  "_message": "No results found for the selected filters."
}

4. Registro de erro

Se o Actor não conseguir capturar ou processar uma resposta válida da API, ele salva um registro de erro estruturado no dataset.

{
  "_error": true,
  "_errorType": "API_NOT_CAPTURED",
  "_errorMessage": "No matching API responses were captured during crawling.",
  "_capturedAt": "2026-04-01T12:05:00.000Z",
  "_sourceUrl": "https://vitrinebradesco.com.br/auctions?type=realstate",
  "_type": "realstate"
}

Quando a execução para

O Actor encerra a execução quando uma destas condições é atingida:

• todas as páginas disponíveis da API foram capturadas
• o limite definido em maxPages foi atingido
• o limite definido em maxScrollRetries foi atingido sem novas páginas
• o site retornou nenhum resultado para os filtros informados
• o limite de monetização da execução foi atingido na plataforma Apify

Boas práticas

• Ative proxy.useApifyProxy.
• Comece com um valor menor de maxPages para validar filtros novos.
• Use cityId quando precisar de mais consistência entre execuções.
• Verifique o registro final com _summary: true para confirmar quantas páginas e quantos itens foram capturados.