Consulta CEP em Lote — Endereços Brasileiros

Consulte endereços brasileiros por CEP em lote, direto da base dos Correios via ViaCEP. Ideal para times de vendas, analistas e operações que precisam enriquecer planilhas com endereços completos sem trabalho manual.

Por que este Actor é diferente?

O CEP em lote mais simples disponível no mercado brasileiro cobra por resultado ou limita a 100 CEPs por run. Este Actor não tem limite de volume por execução e aceita sua planilha diretamente via CSV — sem precisar formatar nada antes.

Funcionalidade	Outros Actors	Este Actor
CEP com ou sem hífen	✅	✅
Lote ilimitado por run	❌	✅
Input via CSV	❌	✅
Controle de orçamento por run	❌	✅
Erro registrado sem parar execução	❌	✅
DDD exposto como campo separado	❌	✅

Casos de uso

Times de vendas B2B exportam a lista de clientes do CRM, colam o CSV no campo de input e recebem todos os endereços completos em minutos — prontos para importar de volta sem pós-processamento.

Operações e logística validam listas de CEPs antes de iniciar rotas de entrega, identificando automaticamente CEPs inválidos ou inexistentes sem interromper o processamento do restante da lista.

Escritórios contábeis e jurídicos enriquecem cadastros de clientes e fornecedores com endereço completo, município e UF para fins de emissão de nota fiscal e contratos.

Analistas de dados segmentam bases por UF, município ou DDD usando os campos já formatados no output, sem precisar de joins manuais com tabelas auxiliares.

Como usar

Cenário 1: Lista pequena de CEPs

Cole os CEPs diretamente no campo "Lista de CEPs", um por linha. O Actor aceita CEPs com ou sem hífen — tanto 01310-100 quanto 01310100 funcionam.

Cenário 2: Planilha com centenas de CEPs

Abra sua planilha no Excel ou Google Sheets e certifique-se de que existe uma coluna com o cabeçalho exato cep (em minúsculas). Exporte como CSV, abra o arquivo em um editor de texto, selecione tudo com Ctrl+A, copie e cole no campo "Conteúdo CSV". O Actor identifica automaticamente a coluna e processa todos os registros.

Exemplo de CSV válido:

cep,nome_cliente
01310-100,Empresa A
88010-000,Empresa B
20040-020,Empresa C

Cenário 3: Integração via API

{
  "ceps": ["01310-100", "88010-000", "20040-020"],
  "maxItems": 1000,
  "delayMs": 300
}

O que você recebe em cada consulta

Cada CEP consultado gera um item no dataset com os seguintes campos:

• cep_formatado — CEP no padrão visual brasileiro (XXXXX-XXX)
• logradouro — nome da rua ou avenida
• complemento — complemento do logradouro quando disponível
• bairro — bairro
• municipio — nome do município
• uf — estado em dois caracteres (ex: SP, RJ, SC)
• ddd — código de área telefônico da região
• ibge — código IBGE do município (útil para integrações com sistemas fiscais)
• siafi — código SIAFI
• status — sucesso ou erro
• consultado_em — timestamp da consulta

Exemplo de output

Consulta bem-sucedida:

{
  "cep_consultado": "01310-100",
  "cep_formatado": "01310-100",
  "logradouro": "Avenida Paulista",
  "complemento": "de 1 a 610 - lado par",
  "bairro": "Bela Vista",
  "municipio": "São Paulo",
  "uf": "SP",
  "ddd": "11",
  "ibge": "3550308",
  "siafi": "7107",
  "status": "sucesso",
  "consultado_em": "2026-04-10T15:00:00.000Z"
}

CEP inválido ou inexistente:

{
  "cep_consultado": "00000000",
  "cep_formatado": "00000-000",
  "status": "erro",
  "motivo": "CEP não encontrado na base dos Correios.",
  "consultado_em": "2026-04-10T15:00:00.000Z"
}

Preço

Este Actor cobra por resultado (Pay Per Event): US$ 5,00 por 1.000 CEPs consultados (US$ 0,005 por CEP). Cada CEP processado gera um item no dataset. Use o campo "Máximo de resultados" para limitar o volume e ter previsibilidade de custo. Você paga apenas pelo que consome — sem mensalidade fixa.

Limitações

Os dados vêm da ViaCEP, que disponibiliza a base pública dos Correios. Pode haver atraso de atualização em endereços muito recentes. Nem todos os CEPs têm logradouro registrado — CEPs de caixa postal ou grandes receptores retornam campos em branco.

Integração com Make, Zapier e n8n

A Apify tem integrações nativas com Make, Zapier, n8n e Google Sheets. Após cada execução, configure um webhook para receber os dados automaticamente ou use o módulo da Apify disponível nessas plataformas.

Actors relacionados

Monte um fluxo completo de dados de empresas brasileiras combinando esta suíte:

• Consulta CNPJ em Lote — Dados da Receita Federal — razão social, sócios, CNAE, situação cadastral e score de risco
• Reclame Aqui Scraper — Reputação de Empresas BR — nota, reclamações e reputação de cada empresa
• Brazil Due Diligence — CNPJ + Reclame Aqui — cadastro da Receita + reputação num único registro
• ZAP Imóveis Scraper — Anúncios de Venda e Aluguel — anúncios do mercado imobiliário brasileiro