Como buscar endereço por CEP em Python
Ver em .mdLogradouro, bairro, cidade com código IBGE e coordenadas a partir do CEP, com requests e cache.
A API de CEP da Apizen devolve, para um CEP, o logradouro, o bairro, o município com o código do IBGE, a UF e um ponto no mapa (latitude e longitude). Com Python é uma chamada.
Uma consulta
import os
import requests
def buscar_cep(cep: str) -> dict | None:
cep = "".join(c for c in cep if c.isdigit())
res = requests.get(
f"https://ceps.apizen.com.br/v1/cep/{cep}",
headers={"Authorization": f"Bearer {os.environ['CEPS_API_KEY']}"},
timeout=10,
)
if res.status_code == 404:
return None # CEP que não existe
res.raise_for_status()
return res.json()
endereco = buscar_cep("01001-000")
print(endereco["logradouro"], endereco["municipio"]["nome"], endereco["uf"])
# Praca da Se São Paulo SPCom cache
Os CEPs mudam pouco e a base é atualizada uma vez por mês: guardar a resposta economiza cota e tempo.
from functools import lru_cache
@lru_cache(maxsize=10_000)
def buscar_cep_cache(cep: str) -> dict | None:
return buscar_cep(cep)Num serviço com vários processos, use o Redis ou o banco no lugar do lru_cache.
O que vem na resposta
{
"cep": "01001000",
"logradouro": "Praca da Se",
"bairro": "Centro",
"municipio": { "codigo_ibge": "3550308", "nome": "São Paulo" },
"uf": "SP",
"localizacao": { "latitude": -23.549153, "longitude": -46.63359 },
"enderecos": 6999,
"estabelecimentos": 449,
"fonte": "receita"
}O codigo_ibge é o que a nota fiscal eletrônica e muitos cadastros pedem; a localizacao serve para calcular distância ou mostrar no mapa.
Crie uma chave grátis: 5 mil consultas por mês, sem cartão.