Pesquisa Código Postal & CEP
API postal

API global de códigos postais e validação de endereços

Integre pesquisa de códigos postais, normalizacao de moradas e coordenadas geograficas para mais de 190 paises.

API JSON para pesquisa, verificação e geocodificação

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 código postal
GET https://pt.postalcodes.info/api/v1/postal-code/{country_code}/{postal_code}
// Pesquisar localidades por nome
GET https://pt.postalcodes.info/api/v1/search?q={query}&country={iso2}

Funcoes principais

  • 🔹 Pesquisa instantanea: cidades, regioes e códigos 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.

Se precisa de exports regulares, snapshots ou um uso mais analitico, consulte tambem as bases de dados descarregaveis.