Pular para o conteúdo
Free API Today

API de CEP grátis

3 de 3 opções responderam com o dado esperado na última verificação. Consultar um CEP é a integração mais comum em formulários brasileiros: o usuário digita oito números e o site preenche rua, bairro, cidade e estado.
  1. BrasilAPI — CEP

    Consulta vários provedores ao mesmo tempo e devolve o primeiro que responder. A versão 2 inclui coordenadas quando disponíveis.

    GET https://brasilapi.com.br/api/cep/v2/01001000

    Roda no navegadorFuncionando

  2. ViaCEP

    A mais conhecida. Além da consulta por CEP, busca por UF, cidade e nome da rua.

    GET https://viacep.com.br/ws/01001000/json/

    Roda no navegadorFuncionando

  3. OpenCEP

    Baseada em arquivos estáticos, o que a torna rápida e previsível. Boa como segunda opção.

    GET https://opencep.com/v1/01001000

    Roda no navegadorFuncionando

Retrato do build, não é dado ao vivo. Uma execução do verificador em , a partir da máquina que gerou o site. Como verificamos (em inglês)

Exemplo com BrasilAPI — CEP

Shell
curl -s 'https://brasilapi.com.br/api/cep/v2/01001000'

Resposta guardada pelo verificador em (HTTP 200), encurtada:

application/json
{
  "cep": "01001000",
  "state": "SP",
  "city": "São Paulo",
  "neighborhood": "Sé",
  "street": "Praça da Sé",
  "service": "open-cep",
  "ibge": {
    "city": "3550308",
    "state": "35"
  },
  "timezoneName": "America/Sao_Paulo",
  "location": {
    "type": "Point",
    "coordinates": {
      "longitude": "-46.63611",
      "latitude": "-23.5475"
    }
  }
}

Como escolher e o que cuidar

As três APIs abaixo fazem isso sem chave e aceitam chamadas direto do navegador. A diferença está na origem do dado e no que acontece quando um provedor falha.

  • Valide o formato antes de chamar: oito dígitos, sem hífen. Isso evita requisições inúteis a cada tecla.
  • CEPs gerais de cidades pequenas não trazem rua nem bairro. Deixe esses campos editáveis.
  • Tenha uma segunda API como reserva e um tempo limite de poucos segundos; o formulário não pode travar se a consulta falhar.

Perguntas frequentes

Qual a melhor API de CEP gratuita?

Para a maioria dos casos, BrasilAPI CEP v2: não exige chave, permite chamada do navegador e consulta mais de um provedor. ViaCEP é uma boa alternativa e a única das três que busca por nome de rua.

A API dos Correios é gratuita?

A API oficial dos Correios exige contrato e credenciais. As APIs desta página usam bases públicas de CEP e não precisam de cadastro.

Posso consultar CEP direto do front-end?

Sim. BrasilAPI, ViaCEP e OpenCEP responderam ao nosso verificador com cabeçalho CORS, então funcionam em chamadas feitas pelo navegador.

Outros guias