API za poštne številke - dostop do svetovnih podatkov o poštnih številkah

Poiščite poštne številke, pridobite razdaljo vseh poštnih številk in še veliko več z našim API-jem za poštne številke.

Podatki po vsem svetu

94+ Države

Oglejte si cene

Preberite dokumentacijo

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

Enostaven za uporabo API

PostalCodes.app je orodje, ki vam omogoča pridobivanje informacij o različnih poštnih številkah po vsem svetu. Poštne številke lahko dobite v razdalji v kilometrih ali miljah ali na splošno o podrobnostih poštne številke.

GET Poiščite poštne številke v bližini

S to enostavno uporabo končne točke boste dobili seznam poštnih številk, ki so znotraj določene razdalje. Primer zahteve bo vrnil seznam enoličnih poštnih številk, popoln seznam poštnih številk in podrobnosti o vsaki poštni številki.

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

Naš API sprejema meritve razdalje v kilometrih (privzeto) ali miljah.

Če želite meritev spremeniti v kilometre, morate v zahtevo ms

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

Odgovor bo videti tako:

{
   "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 Pridobite podrobnosti o poštnih številkah

Naslednji primer bo vrnil podrobnosti poštnih številk, ki se ujemajo z iskalno poizvedbo.

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

Odgovor bo videti tako:

{
   "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 Pridobite podatke po meri

Dodate lahko dodatne parametre, da v rezultatih dobite samo tisto, kar potrebujete, v zahtevo dodajte fields vrednosti.

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

Odgovor bo videti tako:

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

+94 Podprte države

AD (Andora)

AR (Argentina)

AS (Ameriška Samoa)

AT (Avstrija)

AU (Avstralija)

AX (Alandski otoki)

AZ (Azerbajdžanu)

BD (Bangladeš)

BE (Belgija)

BG (Bolgarija)

BM (Bermudi)

BR (Brazilija)

BY (Belorusijo)

CA (Kanada)

CH (Švica)

CL (Čile)

CO (Kolumbija)

CR (Kostarika)

CY (Ciper)

CZ (Češka)

DE (Nemčija)

DK (Danska)

DO (Dominikanska republika)

DZ (Alžirija)

EE (Estonija)

ES (Španija)

FI (Finska)

FM (Mikronezija)

FO (Ferski otoki)

FR (Francija)

GB (Združeno kraljestvo)

GF (Francoska Gvajana)

GG (Guernsey in Alderney)

GL (Grenlandija)

GP (Guadeloupe)

GT (Gvatemala)

GU (Guam)

HR (Hrvaška (Hrvaška))

HU (Madžarska)

IE (Irska)

IM (Človek (otok))

IN (Indija)

IS (Islandija)

IT (Italija)

JE (Jersey)

JP (Japonska)

KR (Južna Koreja)

LI (Lihtenštajn)

LK (Šrilanka)

LT (Litva)

LU (Luksemburg)

LV (Latvija)

MC (Monako)

MD (Moldavija)

MH (Marshallovi otoki)

MK (Makedonija)

MP (Severni Marijanski otoki)

MQ (Martinik)

MT (Malta)

MW (Malavi)