API de códigos postais - Acesso a dados de códigos postais mundiais

Pesquise códigos postais, obtenha a distância de alcance de todos os códigos postais e muito mais com nossa API de código postal.

Dados mundiais
94+ Países
{
   "query":{
      "code": "10005",
      "country": "US",
      "range": "25",
      "measure": "mi",
   },
   "results":{
       "range_codes_unique": [
           "07010", 
           "07020", 
           "07022", 
           "07024", 
           "07026", 
           ...
       ],
       "range_codes": [
           "07010", 
           "07020", 
           "07022", 
           "07024", 
           "07026", 
           ...
       ],
       "range_codes_details": [
          {
              "postal_code":"07010",
              "country_code":"US",
              "city":"Cliffside Park",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07020",
              "country_code":"US",
              "city":"Edgewater",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07022",
              "country_code":"US",
              "city":"Fairview",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07024",
              "country_code":"US",
              "city":"Fort Lee",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07026",
              "country_code":"US",
              "city":"Garfield",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
           ...
       ],
   }
}
Postalcodes.app - Access to Worldwide Postal Code data | Product Hunt






API fácil de usar

PostalCodes.app é uma ferramenta que permite obter informações sobre diferentes códigos postais em todo o mundo. Você pode obter códigos postais em uma faixa de distância em quilômetros ou milhas, ou obter os detalhes de um código postal em geral.

GET Obtenha códigos postais à distância

Com este terminal fácil de usar, você obterá uma lista de códigos postais que estão dentro de uma determinada distância. O exemplo de solicitação retornará uma lista de códigos postais exclusivos, uma lista completa de códigos postais e os detalhes de cada código postal.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&distance=25&zipcode=10005&country=us

Nossa API aceita medições de distância em quilômetros (padrão) ou milhas.

Para alterar a medição para quilômetros, você deve colocar o ms em sua solicitação:

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&ms=km&distance=25&zipcode=10005&country=us

A resposta será semelhante a esta:

{
   "query":{
      "code": "10005",
      "country": "US",
      "range": "25",
      "measure": "mi"
   },
   "results":{
       "range_codes_unique": ["07010", "07020", "07022", "07024", "07026", ...],
       "range_codes": ["07010", "07020", "07022", "07024", "07026", ...],
       "range_codes_details": [
          {
              "postal_code":"07010",
              "country_code":"US",
              "city":"Cliffside Park",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07020",
              "country_code":"US",
              "city":"Edgewater",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07022",
              "country_code":"US",
              "city":"Fairview",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07024",
              "country_code":"US",
              "city":"Fort Lee",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
          {
              "postal_code":"07026",
              "country_code":"US",
              "city":"Garfield",
              "state":"New Jersey",
              "state_code":"NJ",
              "province":"Bergen",
              "province_code":"003"
          },
           ...
       ],
   }
}

GET Obtenha detalhes dos códigos postais

O exemplo a seguir retornará os detalhes dos códigos postais que correspondem à consulta de pesquisa.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&zipcode=10005&country=us

A resposta será semelhante a esta:

{
   "query":{
      "code": "10005",
      "country": "us",
      "range": "",
      "measure": "mi"
   },
   "results":{
       "range_codes_unique": ["10005"],
       "range_codes": ["10005"],
       "range_codes_details": [
          {
              "postal_code":"10005",
              "country_code":"US",
              "city":"New York",
              "state":"New York",
              "state_code":"NY",
              "province":"New York",
              "province_code":"061"
          }
       ],
   }
}

GET Obtenha dados personalizados

Você pode passar parâmetros extras para obter apenas o que você precisa nos resultados, basta adicionar os fields valor em sua solicitação.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&fields=["range_codes_unique"]&distance=25&zipcode=10005&country=us

A resposta será semelhante a esta:

{
   "query":{
      "code": "10005",
      "country": "US",
      "range": "25",
      "measure": "mi"
   },
   "results":{
       "range_codes_unique": ["07010", "07020", "07022", "07024", "07026", ...]
   }
}



+94 Países com suporte

AD (Andorra)
AR (Argentina)
AS (Samoa Americana)
AT (Áustria)
AU (Austrália)
AX (Ilhas Aland)
AZ (Azerbaijão)
BD (Bangladesh)
BE (Bélgica)
BG (Bulgária)
BM (Bermudas)
BR (Brasil)
Flag of Belarus
BY (Belarus)
CA (Canadá)
CH (Suíça)
CL (Chile)
CO (Colômbia)
CR (Costa Rica)
CY (Chipre)
CZ (República Checa)
Flag of Germany
DE (Alemanha)
DK (Dinamarca)
DO (República Dominicana)
DZ (Argélia)
EE (Estônia)
ES (Espanha)
FI (Finlândia)
FM (Micronésia)
FO (ilhas Faroe)
FR (França)
GB (Reino Unido)
GF (Guiana Francesa)
GG (Guernsey e Alderney)
GL (Gronelândia)
GP (Guadalupe)
GT (Guatemala)
GU (Guam)
HR (Croácia (Hrvatska))
HU (Hungria)
IE (Irlanda)
IM (Homem (ilha de))
IN (Índia)
IS (Islândia)
IT (Itália)
JE (Jersey)
JP (Japão)
Flag of South Korea
KR (Coreia do Sul)
LI (Liechtenstein)
LK (Sri Lanka)
LT (Lituânia)
LU (Luxemburgo)
LV (Letônia)
MC (Mônaco)
MD (Moldávia)
Flag of the Marshall Islands
MH (Ilhas Marshall)
MK (Macedônia)
MP (Ilhas Marianas do Norte)
MQ (Martinica)
MT (Malta)
Flag of Malawi
MW (Malawi)
MX (México)
MY (Malásia)
Flag of New Caledonia
NC (Nova Caledônia)
NL (Holanda The)
NO (Noruega)
NZ (Nova Zelândia)
PE (Peru)
Flag of the Philippines Coding according to the official "description and specification of the FILIPINO flag" in Executive Order No. 23 from 1936
PH (Filipinas)
Flag of Pakistan
PK (Paquistão)
PL (Polônia)
PM (São Pedro e Miquelon)
the star is in the center of gravity of the triangle, so the x-pos is irrational (tan(30 deg) * 15)
PR (Porto Rico)
PT (Portugal)
PW (Palau)
RE (Reunião)
RO (Roménia)
RS (Sérvia)
RU (Rússia)
SE (Suécia)
SG (Cingapura)
Flag of Slovenia
SI (Eslovênia)
SJ (Ilhas Svalbard e Jan Mayen)
Flag of Slovakia
SK (Eslováquia)
SM (San Marino)
TH (Tailândia)
TR (Turcia)
UA (Ucrânia)
US (Estados Unidos)
Flag of Uruguay
UY (Uruguai)
Flag of Vatican City
VA (Estado da Cidade do Vaticano (Santa Sé))
VI (Ilhas Virgens (EUA))
WF (Ilhas Wallis e Futuna)
YT (Mayotte)
ZA (África do Sul)

Preços e planos


Plano grátis

O que está incluído?

240 pedidos diários

US$ 49/ano

O que está incluído?

4,800 pedidos diários

US$ 149/ano

O que está incluído?

60,000 pedidos diários

US$ 500/ano

O que está incluído?

300,000 pedidos diários

US$ 1,000/ano

O que está incluído?

1,200,000 pedidos diários

US$ 2,500/ano

O que está incluído?

Solicitações diárias ilimitadas

Comece a usar nossa API gratuitamente hoje!

Obtenha 240 pedidos diários gratuitos