API de códigos postais: acceso a datos mundiais de códigos postais

Busca códigos postais, obtén todos os códigos postais a distancia e moito máis coa nosa API de código postal.

Datos 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 é unha ferramenta que permite obter información sobre diferentes códigos postais de todo o mundo. Pode obter códigos postais nunha distancia de quilómetros ou millas ou obter os detalles dun código postal en xeral.

GET Obter códigos postais a unha distancia

Con este punto de uso sinxelo obterás unha lista de códigos postais que se atopan a unha distancia determinada. O exemplo de solicitude devolverá unha lista de códigos postais únicos, unha lista completa de códigos postais e os detalles de cada código postal.

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

A nosa API acepta medicións de distancia en quilómetros (predeterminado) ou millas.

Para cambiar a medida a quilómetros debes poñer o ms na túa solicitude:

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

A resposta será así:

{
   "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 Obter detalles de códigos postais

O seguinte exemplo devolverá os detalles dos códigos postais que coinciden coa consulta de busca.

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

A resposta será así:

{
   "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 Obter datos personalizados

Podes pasar parámetros adicionais para obter só o que necesitas nos resultados, só tes que engadir os fields valor na túa solicitude.

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

A resposta será así:

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



+94 Países apoiados

AD (Andorra)
AR (Arxentina)
AS (Samoa americana)
AT (Austria)
AU (Australia)
AX (Illas Aland)
AZ (Azerbaiyán)
BD (Bangladesh)
BE (Bélxica)
BG (Bulgaria)
BM (Bermuda)
BR (Brasil)
Flag of Belarus
BY (Bielorrusia)
CA (Canadá)
CH (Suíza)
CL (Chile)
CO (Colombia)
CR (Costa Rica)
CY (Chipre)
CZ (República Checa)
Flag of Germany
DE (Alemaña)
DK (Dinamarca)
DO (República Dominicana)
DZ (Alxeria)
EE (Estonia)
ES (España)
FI (Finlandia)
FM (Micronesia)
FO (Illas Feroe)
FR (Francia)
GB (Reino Unido)
GF (Güiana Francesa)
GG (Guernsey e Alderney)
GL (Groenlandia)
GP (Guadalupe)
GT (Guatemala)
GU (Guam)
HR (Croacia (Hrvatska))
HU (Hungría)
IE (Irlanda)
IM (Man (Isle of))
IN (India)
IS (Islandia)
IT (Italia)
JE (Xersei)
JP (Xapón)
Flag of South Korea
KR (Corea do Sur)
LI (Liechtenstein)
LK (Sri Lanka)
LT (Lituania)
LU (Luxemburgo)
LV (Letonia)
MC (Mónaco)
MD (Moldavia)
Flag of the Marshall Islands
MH (Illas Marshall)
MK (Macedonia)
MP (Illas Marianas do Norte)
MQ (Martinica)
MT (Malta)
Flag of Malawi
MW (Malawi)
MX (México)
MY (Malaisia)
Flag of New Caledonia
NC (Nova Caledonia)
NL (Países Baixos)
NO (Noruega)
NZ (Nova Zelandia)
PE (Perú)
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án)
PL (Polonia)
PM (San Pedro e Miquelón)
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ón)
RO (Romanía)
RS (Serbia)
RU (Rusia)
SE (Suecia)
SG (Singapur)
Flag of Slovenia
SI (Eslovenia)
SJ (Illas Svalbard e Jan Mayen)
Flag of Slovakia
SK (Eslovaquia)
SM (San Marino)
TH (Tailandia)
TR (Turquía)
UA (Ucraína)
US (Estados Unidos)
Flag of Uruguay
UY (Uruguay)
Flag of Vatican City
VA (Estado do Vaticano (Santa Sé))
VI (Illas Virxes (EUA))
WF (Illas Wallis e Futuna)
YT (Mayotte)
ZA (África do Sur)

Prezos e plans


Plan gratuíto

Que se inclúe?

240 peticións diarias

US$ 49/ano

Que se inclúe?

4,800 peticións diarias

US$ 149/ano

Que se inclúe?

60,000 peticións diarias

US$ 500/ano

Que se inclúe?

300,000 peticións diarias

US$ 1,000/ano

Que se inclúe?

1,200,000 peticións diarias

US$ 2,500/ano

Que se inclúe?

Solicitudes diarias ilimitadas

Comeza a usar a nosa API de balde hoxe.

Recibe 240 peticións diarias de balde