Postal Codes API - Prístup k údajom o celosvetových poštových smerovacích číslach

Vyhľadajte poštové smerovacie čísla, získajte vzdialenosť všetkých poštových smerovacích čísel a oveľa viac pomocou nášho rozhrania API pre poštové smerovacie čísla.

Celosvetové údaje

94+ Krajiny

Zobraziť ceny

Prečítajte si dokumentáciu

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

Ľahko použiteľné API

PostalCodes.app je nástroj, ktorý umožňuje získať informácie o rôznych poštových smerovacích číslach po celom svete. Môžete získať poštové smerovacie čísla v rozmedzí vzdialeností v kilometroch alebo míľach, alebo môžete získať všeobecné informácie o PSČ.

GET Získajte poštové smerovacie čísla na vzdialenosť

S týmto ľahko použiteľným koncovým bodom získate zoznam poštových smerovacích čísel, ktoré sú v danej vzdialenosti. Príklad žiadosti vráti zoznam jedinečných poštových smerovacích čísel, kompletný zoznam poštových smerovacích čísel a podrobnosti každého poštového smerovacieho čísla.

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

Naše API akceptuje merania vzdialenosti v kilometroch (predvolené) alebo v míľach.

Ak chcete zmeniť meranie na kilometre, musíte do svojej žiadosti ms

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

Odpoveď bude vyzerať takto:

{
   "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 Získajte poštové smerovacie čísla

Nasledujúci príklad vráti podrobnosti poštových smerovacích čísel, ktoré sa zhodujú s vyhľadávacím dotazom.

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

Odpoveď bude vyzerať takto:

{
   "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 Získajte vlastné údaje

Môžete odovzdať ďalšie parametre, aby ste vo výsledkoch dostali iba to, čo potrebujete, stačí do svojej žiadosti fields

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

Odpoveď bude vyzerať takto:

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

+94 Podporované krajiny

AD (Andorra)

AR (Argentína)

AS (Americká Samoa)

AT (Rakúsko)

AU (Austrália)

AX (Alandské ostrovy)

AZ (Azerbajdžan)

BD (Bangladéš)

BE (Belgicko)

BG (Bulharsko)

BM (Bermudy)

BR (Brazília)

BY (bielorusko)

CA (Kanada)

CH (švajčiarsko)

CL (Čile)

CO (Kolumbia)

CR (Kostarika)

CY (Cyprus)

CZ (Česká republika)

DE (Nemecko)

DK (Dánsko)

DO (Dominikánska republika)

DZ (Alžírsko)

EE (Estónsko)

ES (španielsko)

FI (Fínsko)

FM (Mikronézia)

FO (Faerské ostrovy)

FR (Francúzsko)

GB (Spojene kralovstvo)

GF (Francúzska Guiana)

GG (Guernsey a Alderney)

GL (Grónsko)

GP (Guadeloupe)

GT (Guatemala)

GU (Guam)

HR (Chorvátsko (Hrvatska))

HU (maďarsko)

IE (Írsko)

IM (Muž (ostrov))

IN (India)

IS (Island)

IT (Taliansko)

JE (trikot)

JP (Japonsko)

KR (Južná Kórea)

LI (Lichtenštajnsko)

LK (Srí Lanka)

LT (Litva)

LU (Luxembursko)

LV (Lotyšsko)

MC (Monaco)

MD (Moldavsko)

MH (Maršalove ostrovy)

MK (macedónsko)

MP (Severné Mariány)

MQ (Martinique)

MT (Malta)

MW (Malawi)