Temos o prazer de anunciar uma das features mais pedidas pelos nossos desenvolvedores: a Busca Geoespacial.

Até hoje, a maioria das APIs de CEP funcionava de forma unidirecional: você enviava o código postal e recebia o endereço. Mas e se você tiver a localização do usuário (GPS) e precisar saber o CEP? Ou se precisar encontrar todas as farmácias num raio de 2km?

O que é possível fazer agora?

1. Reverse Geocoding (Lat/Long -> CEP)

Ideal para aplicativos de delivery e transporte. Quando o usuário abre o app, você captura a localização GPS dele e automaticamente preenche o endereço de entrega, sem que ele precise digitar nada.

GET /v1/ceps/geo?latitude=-23.56168&longitude=-46.65598&raioKm=1

2. Busca por Raio (Radius Search)

Encontre todos os CEPs dentro de uma distância específica de um ponto central. Isso é perfeito para:

  • Franquias: "Encontre a loja mais próxima".
  • Logística: Agrupar entregas por proximidade geográfica real, não apenas por similaridade de CEP.
  • Marketing: Segmentar campanhas para usuários que moram perto de um evento.

Como usar

A nova API segue os mesmos padrões de autenticação e performance que você já conhece. Veja um exemplo de busca de CEPs num raio de 1km:

const params = new URLSearchParams({
    latitude: -23.56168,
    longitude: -46.65598,
    raioKm: 1, // quilômetros
});

const response = await fetch(`https://api.nextapi.com.br/v1/ceps/geo?${params}`, {
    headers: { 'Authorization': 'Bearer SEU_TOKEN' }
});

const data = await response.json();
console.log(`Encontrados ${data.total} CEPs na região.`);

Disponibilidade

Os novos endpoints já estão disponíveis em produção para todos os planos, inclusive o Gratuito (com limites de requisição). Consulte a documentação oficial para ver todos os parâmetros disponíveis.