CEP em Lote — Consulta de 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"
}

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.

---

For international users: This Actor queries Brazilian postal codes (CEP) from the public Correios database via ViaCEP. Returns street, neighborhood, city, state, area code (DDD), and IBGE municipality code. Accepts bulk input via direct list or CSV file with no per-run volume limit.