API de codis postals: accés a dades de codis postals a tot el món

Cerqueu codis postals, obteniu la distància de tots els codis postals i molt més amb la nostra API de codis postals.

Dades a tot el món

94+ Països

Veure preus

Llegiu la documentació

{
   "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 fàcil d'utilitzar

PostalCodes.app és una eina que permet obtenir informació sobre diferents codis postals de tot el món. Podeu obtenir codis postals en un interval de quilòmetres o milles, o obtenir els detalls d’un codi postal en general.

GET Obteniu codis postals a una distància

Amb aquest punt final fàcil d’utilitzar, obtindreu una llista de codis postals que es troben a una distància determinada. L'exemple de sol·licitud retornarà una llista de codis postals únics, una llista completa de codis postals i les dades de cada codi postal.

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

La nostra API accepta mesures de distància en quilòmetres (predeterminat) o milles.

Per canviar la mesura a quilòmetres, heu de posar el ms a la vostra sol·licitud:

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

La resposta serà així:

{
   "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 Obteniu detalls dels codis postals

A l'exemple següent es mostraran els detalls dels codis postals que coincideixen amb la consulta de cerca.

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

La resposta serà així:

{
   "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 Obteniu dades personalitzades

Podeu passar paràmetres addicionals per obtenir només el que necessiteu als resultats, només cal afegir els fields valor a la vostra sol·licitud.

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

La resposta serà així:

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

+94 Països amb suport

AD (Andorra)

AR (Argentina)

AS (Samoa americana)

AT (Àustria)

AU (Austràlia)

AX (Illes Aland)

AZ (Azerbaidjan)

BD (Bangladesh)

BE (Bèlgica)

BG (Bulgària)

BM (Bermuda)

BR (Brasil)

BY (Bielorússia)

CA (Canadà)

CH (Suïssa)

CL (Xile)

CO (Colòmbia)

CR (Costa Rica)

CY (Xipre)

CZ (República Txeca)

DE (Alemanya)

DK (Dinamarca)

DO (República Dominicana)

DZ (Algèria)

EE (Estònia)

ES (Espanya)

FI (Finlàndia)

FM (Micronèsia)

FO (Illes Faroe)

FR (França)

GB (Regne Unit)

GF (Guaiana francesa)

GG (Guernsey i Alderney)

GL (Groenlàndia)

GP (Guadalupe)

GT (Guatemala)

GU (Guam)

HR (Croàcia (Hrvatska))

HU (Hongria)

IE (Irlanda)

IM (Man (Isle of))

IN (Índia)

IS (Islàndia)

IT (Itàlia)

JE (Jersey)

JP (Japó)

KR (Corea del Sud)

LI (Liechtenstein)

LK (Sri Lanka)

LT (Lituània)

LU (Luxemburg)

LV (Letònia)

MC (Mònaco)

MD (Moldàvia)

MH (Illes Marshall)

MK (Macedònia)

MP (Illes Mariannes del Nord)

MQ (Martinica)

MT (Malta)

MW (Malawi)