API Codici Postali - Accessu à i Dati Mundiali di i Codici Postali

Circà i codici postali, uttene tutti i codici postali à distanza è assai di più cù a nostra API di codice postale.

Dati mundiali

94+ Paesi

Vede i prezzi

Leghje a ducumentazione

{
   "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"
          },
           ...
       ],
   }
}

API faciule da aduprà

PostalCodes.app hè un strumentu chì permette di ottene infurmazioni nantu à diversi codici postali in u mondu. Pudete uttene codici postali in una distanza in chilometri o miglia, o uttene i dettagli di un codice postale in generale.

GET Uttenite codici postali in una distanza

Cù questu endpoint faciule da uttene uttene un elencu di codici postali chì si trovanu à una distanza determinata. L'esempiu di dumanda ritorna un elencu di codici postali unici, un elencu cumpletu di codici postali è i dettagli di ogni codice postale.

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

A nostra API accetta misure di distanza in chilometri (Default) o miglia.

Per cambià a misura in chilometri duvete mette u ms in a vostra dumanda:

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

A risposta serà cusì:

{
   "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 Uttenite i dettagli di i codici postali

L'esempiu seguente restituverà i dettagli di i codici postali chì currispondenu à a ricerca di ricerca.

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

A risposta serà cusì:

{
   "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 Uttenite dati persunalizati

Pudete passà params extra per uttene solu ciò chì avete bisognu in i risultati, basta aghjunghje i fields valore in a vostra richiesta.

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

A risposta serà cusì:

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

+94 Paesi supportati

AD (Andorra)

AR (Argentina)

AS (Samoa Americana)

AT (Austria)

AU (Australia)

AX (Isole Aland)

AZ (Azerbaijan)

BD (Bangladesh)

BE (Belgica)

BG (Bulgaria)

BM (Bermuda)

BR (Brasile)

BY (Bielorussia)

CA (Canada)

CH (Svizzera)

CL (Chilì)

CO (Culombia)

CR (Costa Rica)

CY (Cipru)

CZ (Repubblica Ceca)

DE (Alemagna)

DK (Danimarcu)

DO (Republica Dumenicana)

DZ (Algeria)

EE (Estonia)

ES (Spagna)

FI (Finlandia)

FM (Micronesia)

FO (Isole Faroe)

FR (Francia)

GB (Regnu Unitu)

GF (Guyana Francese)

GG (Guernsey è Alderney)

GL (Groenlandia)

GP (Guadalupa)

GT (Guatemala)

GU (Guam)

HR (Croazia (Hrvatska))

HU (Ungheria)

IE (Irlanda)

IM (Man (Isle of))

IN (India)

IS (Islanda)

IT (Italia)

JE (Jersey)

JP (Giappone)

KR (Corea di u Sud)

LI (Liechtenstein)

LK (Sri Lanka)

LT (Littuania)

LU (Lussemburgu)

LV (Latvia)

MC (Monacu)

MD (Moldova)

MH (Isule Marshal)

MK (Maccedonia)

MP (Isule Mariana Settentriunali)

MQ (Martinica)

MT (Malta)

MW (Malawi)