API de códigos postales: acceso a datos de códigos postales de todo el mundo

Busque códigos postales, obtenga todas las distancias de rango de códigos postales y mucho más con nuestra API de códigos postales.

Datos mundiales

94+ Países

Ver precios

Leer documentación

{
   "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 de usar

PostalCodes.app es una herramienta que te permite obtener información sobre diferentes códigos postales alrededor del mundo. Puede obtener códigos postales en un rango de distancia en kilómetros o millas, u obtener los detalles de un código postal en general.

GET Obtenga códigos postales a distancia

Con este extremo fácil de usar, obtendrá una lista de códigos postales que se encuentran dentro de una distancia determinada. El ejemplo de solicitud devolverá una lista de códigos postales únicos, una lista completa de códigos postales y los detalles de cada código postal.

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

Nuestra API acepta mediciones de distancia en kilómetros (predeterminado) o millas.

Para cambiar la medida a kilómetros debe poner el ms en su solicitud:

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

La respuesta se verá así:

{
   "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 Obtener detalles de códigos postales

El siguiente ejemplo devolverá los detalles de los códigos postales que coinciden con la consulta de búsqueda.

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

La respuesta se verá así:

{
   "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 Obtener datos personalizados

Puede pasar parámetros adicionales para obtener solo lo que necesita en los resultados, simplemente agregue los fields valor en su solicitud.

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

La respuesta se verá así:

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

+94 Países admitidos

AD (Andorra)

AR (Argentina)

AS (Samoa Americana)

AT (Austria)

AU (Australia)

AX (Islas Aland)

AZ (Azerbaiyán)

BD (Bangladesh)

BE (Bélgica)

BG (Bulgaria)

BM (Islas Bermudas)

BR (Brasil)

BY (Bielorrusia)

CA (Canadá)

CH (Suiza)

CL (Chile)

CO (Colombia)

CR (Costa Rica)

CY (Chipre)

CZ (Republica checa)

DE (Alemania)

DK (Dinamarca)

DO (República Dominicana)

DZ (Argelia)

EE (Estonia)

ES (España)

FI (Finlandia)

FM (Micronesia)

FO (Islas Faroe)

FR (Francia)

GB (Reino Unido)

GF (Guayana Francesa)

GG (Guernsey y Alderney)

GL (Tierra Verde)

GP (Guadalupe)

GT (Guatemala)

GU (Guam)

HR (Croacia (Hrvatska))

HU (Hungría)

IE (Irlanda)

IM (Hombre (isla de))

IN (India)

IS (Islandia)

IT (Italia)

JE (Jersey)

JP (Japón)

KR (Corea del Sur)

LI (Liechtenstein)

LK (Sri Lanka)

LT (Lituania)

LU (Luxemburgo)

LV (Letonia)

MC (Mónaco)

MD (Moldavia)

MH (Islas Marshall)

MK (Macedonia)

MP (Islas Marianas del Norte)

MQ (Martinica)

MT (Malta)

MW (Malawi)