API postal

API global de codigos postais e validacao de enderecos

Integre pesquisa de codigos postais, normalizacao de moradas e coordenadas geograficas para mais de 190 paises.

API JSON para pesquisa, verificacao e geocodificacao

A API foi desenhada para integracoes rapidas, formularios de endereco, fluxos logisticos e aplicacoes que precisam de um esquema postal estavel.

// Obter metadados de um codigo postal

GET https://api.postalcodes.info/v1/postal-code/{country_code}/{postal_code}

// Pesquisar localidades por nome

GET https://api.postalcodes.info/v1/search?q={query}&country={iso2}

Funcoes principais

🔹 Pesquisa instantanea: cidades, regioes e codigos postais.
🔹 Coordenadas geocodificadas: latitude e longitude WGS84.
🔹 Hierarquia administrativa: niveis 1, 2 e 3 quando disponiveis.
🔹 Formato consistente: respostas JSON simples de integrar.

Acesso e autenticacao

O acesso publico foi pensado para investigacao e integracao leve. Para usos mais intensivos, os exports e a documentacao ajudam a preparar tratamentos bulk e caches aplicacionais.

Ler a documentacao API

Casos de uso

As equipas usam a API para validar formularios, enriquecer CRMs, apoiar expedicoes e alimentar mapas ou motores de pesquisa locais.

O esquema mantem-se estavel entre paises, o que facilita consolidacao de dados, auditorias e pipelines multi-mercado.

Qualidade dos dados

As respostas sao construidas a partir de registos postais, fontes abertas verificadas e um pipeline de normalizacao que controla niveis administrativos e coordenadas.