Buscar CEP por Número

Consulta de CEP brasileiro em tempo real, direto da base oficial dos Correios via API ViaCEP. Digita os 8 dígitos e mostramos logradouro, bairro, cidade, UF, DDD e os códigos IBGE/SIAFI. Sem cadastro, sem captcha.

A busca acontece automaticamente quando você completa os 8 dígitos. Dados vêm da ViaCEP, base oficial dos Correios.

Perguntas Frequentes

Posso usar essa busca sem limite?+

Sim, a ViaCEP é pública e gratuita. Para volume alto (>1 chamada/segundo por IP), considere cachear localmente — a base muda raramente.

Por que alguns CEPs não trazem logradouro?+

CEPs gerais cobrem um bairro inteiro ou uma cidade pequena, não um logradouro específico. Nesses casos, vêm só bairro, cidade e UF.

Posso descobrir o CEP a partir do endereço?+

A ViaCEP suporta busca reversa (UF + cidade + parte do logradouro), mas essa rota aqui só faz busca direta por CEP. Pra reversa, consulte busca avançada no site da ViaCEP ou Correios.

Meus dados ficam armazenados?+

Não. A consulta vai direto do seu navegador pra ViaCEP, sem passar pelos nossos servidores.

O que é o código IBGE retornado?+

É o código numérico que o IBGE atribui a cada município brasileiro. Útil pra integrar com bases de cadastro nacionais, estatísticas, ou serviços do gov.br.

O que é CEP e como funciona

CEP (Código de Endereçamento Postal) é o sistema dos Correios para identificar endereços no Brasil. São 8 dígitos no formato XXXXX-XXX, divididos em região (1º dígito), sub-região (2º), setor (3º), subsetor (4º), divisor (5º) e distribuidor (últimos 3, separados por hífen). Cada faixa cobre uma área geográfica delimitada — um logradouro, um trecho dele, um bairro inteiro, ou um destinatário específico (caixa postal, grandes empresas, órgãos públicos).

+Para desenvolvedores: integrar busca de CEP em código

A ViaCEP tem endpoint REST aberto. Para integrar busca de CEP no seu app:

# cURL
curl https://viacep.com.br/ws/01310100/json/

# JavaScript
const res = await fetch("https://viacep.com.br/ws/01310100/json/");
const endereco = await res.json();
// { cep, logradouro, bairro, localidade, uf, ddd, ibge, ... }

# Erro de CEP inexistente vem como { erro: true }
if (endereco.erro) console.log("CEP nao encontrado");
+Precisa de CEP fictício para testes? Use o gerador

Esta página busca CEPs reais. Se você precisa de CEPs fictícios para popular banco de staging, fixtures de teste, ou mockar formulários sem expor endereços reais, use o gerador de CEP. Ele produz códigos no formato sintaticamente correto por estado, sem corresponder a endereços reais — útil pra QA sem violar LGPD.