1001Ferramentas
📮Utilitários

Consulta CEP

Consulta endereço completo a partir de um CEP brasileiro via API ViaCEP. Retorna logradouro, bairro, cidade, UF e DDD.

Como funciona?

Por trás da consulta está a API ViaCEP, um serviço público e gratuito mantido por terceiros, sem vínculo com os Correios, que devolve os dados de endereço a partir de um CEP de 8 dígitos.

Quem fala com a API é o seu navegador, direto, sem passar pelos nossos servidores. Em conexões normais, cada requisição leva por volta de 200ms.

Se a sua demanda for pesada, na casa das centenas de consultas por minuto, vale considerar serviços comerciais como o CEP Aberto.

Consulte o endereço de um CEP

Montar o endereço a partir do CEP poupa tempo e corta os erros de digitação que vivem aparecendo em formulários e cadastros. Aqui você digita o CEP brasileiro e recebe o endereço completo de volta, vindo da base pública da API ViaCEP.

Do número, saem logradouro, bairro, cidade e estado correspondentes. Dá para conferir um endereço, completar um cadastro, calcular um frete ou só descobrir a que rua e bairro um CEP pertence, tudo sem precisar abrir o site dos Correios.

A busca vai direto à ViaCEP em tempo real, a partir do navegador. Tenha sempre por perto quando o CEP estiver na mão e faltar o endereço.

Perguntas frequentes

O CEP que eu digito sai do meu navegador?
Sim, sai. Ao clicar em Buscar, o seu navegador faz uma requisição direta para viacep.com.br, no endereço https://viacep.com.br/ws/OITODIGITOS/json/. O serviço ViaCEP recebe o CEP consultado junto com o seu endereço IP e os cabeçalhos normais de uma visita, e aplica a política de privacidade dele. A consulta não passa pelos servidores deste site, que não vê nem guarda nada, mas convém saber que o número sai da sua máquina — ao contrário da maioria das ferramentas aqui, que rodam fechadas no navegador.
Quais informações voltam da consulta?
Cinco campos: logradouro, bairro, cidade, UF e DDD. Complemento, código IBGE, GIA e SIAFI vêm na resposta do ViaCEP mas não são exibidos. Quando o CEP é um daqueles gerais, que cobrem uma cidade inteira em vez de uma rua, o logradouro e o bairro voltam vazios e a tela mostra travessão nos dois — não é erro. A busca também é de mão única: dá para ir do CEP ao endereço, não do endereço ao CEP.
Cliquei em Buscar e não aconteceu nada, o que está errado?
Quase sempre são dígitos faltando. O campo formata sozinho enquanto você digita, corta em oito dígitos e ignora letras, e a busca só dispara com os oito dígitos completos — abaixo disso o botão não faz absolutamente nada e nenhuma mensagem aparece. Se o CEP tiver os oito dígitos mas não existir na base, sai um aviso vermelho de CEP não encontrado. Se a requisição falhar por rede fora do ar, ViaCEP indisponível ou bloqueio de extensão do navegador, sai um aviso diferente, pedindo para verificar a conexão. Apertar Enter no campo tem o mesmo efeito de clicar no botão.

Ferramentas Relacionadas