API des codes postaux - Accès aux données des codes postaux dans le monde entier

Recherchez des codes postaux, obtenez tous les codes postaux à distance et bien plus encore avec notre API de code postal.

Données mondiales

94+ Des pays

Voir les prix

Lire la documentation

{
   "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 facile à utiliser

PostalCodes.app est un outil qui vous permet d'obtenir des informations sur différents codes postaux à travers le monde. Vous pouvez obtenir des codes postaux dans une plage de distances en kilomètres ou en miles, ou obtenir les détails d'un code postal en général.

GET Obtenez les codes postaux à distance

Avec ce point de terminaison facile à utiliser, vous obtiendrez une liste des codes postaux qui se trouvent à une distance donnée. L'exemple de demande renverra une liste de codes postaux uniques, une liste complète des codes postaux et les détails de chaque code postal.

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

Notre API accepte les mesures de distance en kilomètres (par défaut) ou en miles.

Pour changer la mesure en kilomètres vous devez mettre le ms dans votre requête :

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

La réponse ressemblera à ceci :

{
   "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 Obtenir les détails des codes postaux

L'exemple suivant renverra les détails des codes postaux qui correspondent à la requête de recherche.

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

La réponse ressemblera à ceci :

{
   "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 Obtenez des données personnalisées

Vous pouvez passer des paramètres supplémentaires pour obtenir uniquement ce dont vous avez besoin dans les résultats, ajoutez simplement les fields valeur dans votre demande.

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

La réponse ressemblera à ceci :

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

+94 Pays pris en charge

AD (Andorre)

AR (Argentine)

AS (Samoa Américaines)

AT (L'Autriche)

AU (Australie)

AX (Iles Aland)

AZ (Azerbaïdjan)

BD (Bangladesh)

BE (Belgique)

BG (Bulgarie)

BM (Bermudes)

BR (Brésil)

BY (Biélorussie)

CA (Canada)

CH (Suisse)

CL (Chili)

CO (Colombie)

CR (Costa Rica)

CY (Chypre)

CZ (République Tchèque)

DE (Allemagne)

DK (Danemark)

DO (République Dominicaine)

DZ (Algérie)

EE (Estonie)

ES (Espagne)

FI (Finlande)

FM (Micronésie)

FO (Îles Féroé)

FR (France)

GB (Royaume-Uni)

GF (Guinée Française)

GG (Guernesey et Alderney)

GL (Groenland)

GP (Guadeloupe)

GT (Guatemala)

GU (Guam)

HR (Croatie (Hrvatska))

HU (Hongrie)

IE (Irlande)

IM (Man (île de))

IN (Inde)

IS (Islande)

IT (Italie)

JE (Jersey)

JP (Japon)

KR (COREE DU SUD)

LI (Liechtenstein)

LK (Sri Lanka)

LT (Lituanie)

LU (Luxembourg)

LV (Lettonie)

MC (Monaco)

MD (La Moldavie)

MH (Iles Marshall)

MK (Macédoine)

MP (Îles Mariannes du Nord)

MQ (Martinique)

MT (Malte)

MW (Malawi)