API Pública de Consulta de Endereço por CEP

Visão Geral

Com essa API, você pode consultar dados de endereço (logradouro, bairro, cidade, UF, IBGE) a partir de um CEP (somente números). A resposta é em JSON e pode ser integrada em qualquer linguagem.

Exemplo de endpoint:

GET https://meucep.seunegocionanuvem.com.br/api/36240075

Parâmetros

Resposta de sucesso (200)

{
  "cep": "36240-075",
  "logradouro": "Avenida Presidente Getúlio Vargas",
  "complemento": "lado ímpar",
  "unidade": null,
  "bairro": "Centro",
  "localidade": "Santos Dumont",
  "uf": "MG",
  "ibge": "3160702",
  "ddd": "32",
  "siafi": "5213"
}

Erros / Códigos de resposta

• 400 Bad Request — CEP inválido ou formato incorreto.
• 404 Not Found — CEP não encontrado.
• 500 Internal Server Error — erro interno no servidor.

{
  "erro": "CEP inválido"
}

Exemplos de integração

PHP (cURL)

<?php
$cep = '01457000';
$url = "https://meucep.seunegocionanuvem.com.br/api/{$cep}";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
curl_close($ch);

$data = json_decode($result, true);
if (isset($data['erro'])) {
  echo "Erro: " . $data['erro'];
} else {
  echo "Logradouro: " . $data['logradouro'];
}
?>

JavaScript (Fetch)

fetch('https://meucep.seunegocionanuvem.com.br/api/36240075')
  .then(r => r.json())
  .then(json => {
    if (json.erro) {
      console.error('Erro:', json.erro);
    } else {
      console.log('Bairro:', json.bairro);
    }
  });

Python (requests)

import requests

resp = requests.get('https://meucep.seunegocionanuvem.com.br/api/36240075')
data = resp.json()
if 'erro' in data:
    print('Erro:', data['erro'])
else:
    print('Cidade:', data['localidade'])

Dicas & boas práticas

Sobre

Essa API é mantida por Seu Negócio na Nuvem. Você pode usá-la gratuitamente para fins pessoais ou comerciais, desde que cite a fonte.