# Como buscar endereço por CEP em Python

> Logradouro, bairro, cidade com código IBGE e coordenadas a partir do CEP, com requests e cache.

A [API de CEP](https://apizen.com.br/docs/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

```python
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 SP
```

## Com cache

Os CEPs mudam pouco e a base é atualizada uma vez por mês: guardar a resposta economiza cota e tempo.

```python
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

```json
{
  "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](https://apizen.com.br/docs/maps).

[Crie uma chave grátis](https://apizen.com.br/entrar): 5 mil consultas por mês, sem cartão.
