Especificação Técnica | API de CEPs e Código IBGE

Nossa API oferece respostas rápidas e estáveis para localização de endereços por CEP, integrando também os dados de geolocalização e códigos verificadores do IBGE.

Chave para testes: Chave_Gratuita_BuscarCep
Esta chave permite 1 busca por minuto e deve ser utilizada estritamente para testes de integração.

HTTPS / SSL: O serviço suporta criptografia de ponta a ponta. Exemplo:
https://buscarcep.com.br/?cep=30010960&chave=Chave_Gratuita_BuscarCep

Formato de Requisição

Para buscar um CEP, envie uma requisição GET HTTP no formato desejado:

Formato URL de Exemplo
JSON https://buscarcep.com.br/?cep=30010960&formato=json&chave=Chave_Gratuita_BuscarCep
XML https://buscarcep.com.br/?cep=30010960&formato=xml&chave=Chave_Gratuita_BuscarCep
String https://buscarcep.com.br/?cep=30010960&formato=string&chave=Chave_Gratuita_BuscarCep

Parâmetros da API

Parâmetro Tipo Obrigatório? Descrição
cep String (9) Sim CEP a ser pesquisado (com ou sem hífen).
formato String Não json, xml ou string. Padrão: xml.
chave String Sim Sua chave única gerada no cadastro.
identificador String Não Nome do seu sistema para acompanhamento estatístico.

Formato de Resposta (JSON)

{
  "resultado": "1",
  "resultado_txt": "sucesso - cep completo",
  "uf": "MG",
  "cidade": "Belo Horizonte",
  "bairro": "Centro",
  "tipo_logradouro": "Praça",
  "logradouro": "da Estação",
  "ibge_municipio_verificador": "3106200"
}

Tipos de Logradouros Suportados

Atualmente nosso sistema suporta e identifica os seguintes tipos de logradouros nas buscas:

  • 10ª Rua
  • 10ª Travessa
  • 11ª Rua
  • 11ª Travessa
  • 12ª Rua
  • 12ª Travessa
  • 13ª Travessa
  • 14ª Travessa
  • 15ª Travessa
  • 16ª Travessa
  • 1ª Paralela
  • 1ª Rua
  • 1ª Subida
  • 1ª Travessa
  • 1ª Vila
  • 1º Alto
  • 1º Beco
  • 1º Parque
  • 2ª Paralela
  • 2ª Rua
  • 2ª Subida
  • 2ª Travessa
  • 2ª Vila
  • 2º Alto
  • 2º Beco
  • 2º Parque
  • 3ª Paralela
  • 3ª Rua
  • 3ª Subida
  • 3ª Travessa
  • 3ª Vila
  • 3º Alto
  • 3º Beco
  • 3º Parque
  • 4ª Paralela
  • 4ª Rua
  • 4ª Subida
  • 4ª Travessa
  • 4ª Vila
  • 4º Alto
  • 4º Beco
  • 5ª Paralela
  • 5ª Rua
  • 5ª Subida
  • 5ª Travessa
  • 5ª Vila
  • 5º Alto
  • 5º Beco
  • 6ª Rua
  • 6ª Subida
  • 6ª Travessa
  • 7ª Rua
  • 7ª Travessa
  • 8ª Rua
  • 8ª Travessa
  • 9ª Rua
  • 9ª Travessa
  • Acampamento
  • Acesso
  • Adro
  • Aeroporto
  • Alameda
  • Alto
  • Artéria
  • Atalho
  • Avenida
  • Avenida Contorno
  • Baixa
  • Balneario
  • Balão
  • Beco
  • Belvedere
  • Bloco
  • Bosque
  • Boulevard
  • Buraco
  • Cais
  • Calçada
  • Caminho
  • Campo
  • Canal
  • Chapadão
  • Chácara
  • Circular
  • Colônia
  • Complexo Viário
  • Condomínio
  • Conjunto
  • Corredor
  • Córrego
  • Descida
  • Desvio
  • Distrito
  • Elevada
  • Entrada Particular
  • Entre-quadra
  • Escada
  • Esplanada
  • Estacionamento
  • Estação
  • Estrada
  • Estrada Municipal
  • Estádio
  • Estância
  • Favela
  • Fazenda
  • Feira
  • Ferrovia
  • Fonte
  • Forte
  • Galeria
  • Granja
  • Habitacional
  • Ilha
  • Jardim
  • Jardinete
  • Ladeira
  • Lago
  • Lagoa
  • Largo
  • Loteamento
  • Marina
  • Monte
  • Morro
  • Módulo
  • Núcleo
  • Parada
  • Paradouro
  • Paralela
  • Parque
  • Passagem
  • Passagem Subterrânea
  • Passarela
  • Passeio
  • Ponta
  • Ponte
  • Porto
  • Praia
  • Praça
  • Praça de Esportes
  • Prolongamento
  • Pátio
  • Quadra
  • Quinta
  • Quintas
  • Ramal
  • Rampa
  • Recanto
  • Residencial
  • Reta
  • Retiro
  • Retorno
  • Rodo Anel
  • Rodovia
  • Rotatória
  • Rotula
  • Rua
  • Rua de Ligação
  • Rua de Pedestre
  • Servidão
  • Setor
  • Subida
  • Sítio
  • Terminal
  • Travessa
  • Travessa Particular
  • Trecho
  • Trevo
  • Trincheira
  • Túnel
  • Unidade
  • Vala
  • Vale
  • Variante
  • Vereda
  • Via
  • Via Elevada
  • Via Expressa
  • Via de Acesso
  • Via de pedestre
  • Viaduto
  • Viela
  • Vila
  • Zigue-zague
  • Área
  • Área Especial