Bradesco Vehicles API

Extraia anúncios de leilões de veículos 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.
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",
  "maxPages": 100,
  "maxScrollRetries": 8,
  "scrollDelayMs": 1500,
  "proxy": {
    "useApifyProxy": true
  }
}

Observações sobre a entrada

• 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 veículo
• registro de resumo
• registro de nenhum resultado
• registro de erro

1. Item de veículo

Cada veículo 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": "8b71f64d-25cf-44e1-b4ce-27fb2a839cbb",
  "auctioneer": {
    "guid": "8a2c8678-156b-4b98-92e5-65a8d59fe6a8",
    "name": "Freitas Leiloeiro",
    "website": "https://www.freitasleiloeiro.com.br/",
    "crawl_token": "freitas_leiloes",
    "profile_image": "https://images.vitrinebradesco.com.br/Logo-Freitas-branco.png",
    "owners_names": "Sérgio Villa Nova Freitas",
    "last_sync_at": "2026-04-13T09:16:50.000Z",
    "sync_status": "success"
  },
  "name": "Porsche - Macan Gts - 2016  /  2017",
  "price": 142000,
  "auction_date": "2026-04-17T10:00:00.000Z",
  "images": [
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663170012",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663170297",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663171299",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663172237",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663173354",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663174235",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663175155",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663176009",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663177124",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663178094",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663179041",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663180142",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663181423",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663181846",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663183168",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663184089",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663185146",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663185641",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663186609",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663187740",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663188852",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663189693",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663190939",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663191801",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663192957",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663194023",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663195851",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663197123",
    "https://images.vitrinebradesco.com.br/freitas_leiloes/446456/1775663198522"
  ],
  "city": "Santo André",
  "state": "SP",
  "description": "Porsche, Macan Gts, 2016, 2017, Cinza, Gasolina, 41478",
  "neighborhood": null,
  "is_waste": false,
  "created_at": "2026-04-08T15:45:58.000Z",
  "type": "vehicles",
  "realstate_auction_type": null,
  "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": "Carro",
  "slug": "porsche-macan-gts-2016-2017-9",
  "currency": null,
  "_page": 1,
  "_capturedAt": "2026-04-13T09:29:20.238Z",
  "_sourceUrl": "https://api.vitrinebradesco.com.br/v1/auctions?page=1&type=vehicles",
  "_type": "vehicles",
  "_totalPages": 10,
  "_totalAuctions": 280
}

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=vehicles&ufs=SP&city=12345",
  "_type": "vehicles",
  "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 veículos, o Actor grava um registro indicando isso.

{
  "_notFound": true,
  "_capturedAt": "2026-04-01T12:05:00.000Z",
  "_sourceUrl": "https://vitrinebradesco.com.br/auctions?type=vehicles&ufs=SP",
  "_type": "vehicles",
  "_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=vehicles",
  "_type": "vehicles"
}

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.

links úteis

• Criscon - Empresa de tecnologia especializada em soluções de Scraping e automação de dados.