5 melhores apis de cep para você usar em 2023
O que é CEP?
Cep é a sigla para código de endereçamento postal. Ele é um código composto por oito algarismos que agiliza o encaminhamento de correspondências. Os cinco primeiros algarismos do código correspondem à Região, Sub-região, Setor, Sub-setor e Divisor do Sub-setor. Já os três últimos representam os Indentificadores de distribuição. Você pode conferir mais informações diretamente no site dos correios (opens in a new tab).
APIs para consulta de CEP
Brasil Aberto
O Brasil Aberto (opens in a new tab) é um serviço bem completo que visa oferecer uma solução que vai muito além de CEPs. No retorno a API traz também o cityId e o districtId, além dos dados mais comuns. Você pode usar o cityId, por exemplo, para listar todas os bairros da cidade da qual esse CEP faz parte. Você pode obter mais informações clicando aqui (opens in a new tab).
// https://api.brasilaberto.com/v1/zipcode/01001000
{
"meta": {
"currentPage": 1,
"itemsPerPage": 1,
"totalOfItems": 1,
"totalOfPages": 1
},
"result": {
"street": "Praça da Sé",
"complement": "lado ímpar",
"district": "Sé",
"districtId": 1,
"city": "São Paulo",
"cityId": 1,
"ibgeId": 3550308,
"state": "São Paulo",
"stateShortname": "SP",
"zipcode": "01001000"
}
}Outro ponto muito positivo é que na versão preemium da API você tem acesso a coordenadas do CEP (opens in a new tab) e até mesmo cálculo de distâncias entre CEPs (opens in a new tab):
// https://api.brasilaberto.com/v1/zipcode/26277630
{
"meta": {
"currentPage": 1,
"itemsPerPage": 1,
"totalOfItems": 1,
"totalOfPages": 1
},
"result": {
"street": "Rua Cajurana",
"complement": "",
"district": "Jardim Palmares",
"districtId": 22687,
"city": "Nova Iguaçu",
"cityId": 669,
"ibgeId": 3303500,
"state": "Rio de Janeiro",
"stateShortname": "RJ",
"zipcode": "26277645",
"coordinates": {
"latitude": -22.75901,
"longitude": -43.51527
}
}
}ViaCep
ViaCep (opens in a new tab) é um serviço bem famoso e funciona muito bem, o serviço conta com os formatos de retorno Json (opens in a new tab) e XML (opens in a new tab). Confira um exemplo de requisição:
// https://viacep.com.br/ws/01001000/json/
{
"cep": "01001-000",
"logradouro": "Praça da Sé",
"complemento": "lado ímpar",
"bairro": "Sé",
"localidade": "São Paulo",
"uf": "SP",
"ibge": "3550308",
"gia": "1004",
"ddd": "11",
"siafi": "7107"
}OpenCep
OpenCep (opens in a new tab) é um serviço open source cuja base de dados fica hospedada no github (opens in a new tab). Confira um exemplo de requisição:
// https://opencep.com/v1/15050305
{
"cep": "15050-305",
"logradouro": "Rua Josina Teixeira de Carvalho",
"complemento": "",
"bairro": "Vila Anchieta",
"localidade": "São José do Rio Preto",
"uf": "SP",
"ibge": "3549805"
}Brasil API
Brasil API é um gateway open source que busca informações em diversos provedores, o que o torna teoricamente mais resiliente. Além de tudo, na versão 2 do endpoint de busca de CEP, é retornada a coordenada geográfica do endereço. Vale ressaltar, entretanto, que esse serviço busca as coordenadas no Open Street Map (opens in a new tab) e por isso não são todos os CEPs que virão com essa informação (como no exemplo abaixo).
// https://brasilapi.com.br/api/cep/v2/01001000
{
"cep": "01001000",
"state": "SP",
"city": "São Paulo",
"neighborhood": "Sé",
"street": "Praça da Sé - lado ímpar",
"service": "correios-alt",
"location": {
"type": "Point",
"coordinates": {
}
}
}ApiCEP
ApiCEP (opens in a new tab) é um outro serviço que você pode testar para usar em seus projetos. Ele é bem simples mas pode te ajudar caso outra solução venha falhar.
// https://cdn.apicep.com/file/apicep/06233-030.json
{
"code": "06233-030",
"state": "SP",
"city": "Osasco",
"district": "Piratininga",
"address": "Rua Paula Rodrigues",
"status": 200,
"ok": true,
"statusText": "ok"
}