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)