{
"countryCode": "US",
"postalCode": "90210",
"found": true,
"partialMatch": false,
"count": 1,
"places": [
{
"countryCode": "US",
"postalCode": "90210",
"place": "Beverly Hills",
"region": "California",
"province": "Los Angeles",
"community": null,
"latitude": 34.0901,
"longitude": -118.4065,
"accuracy": "place"
}
],
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35344/look+up+a+postal+code&country=Required&/=Required&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"from": {
"countryCode": "ES",
"postalCode": "37007",
"place": "Salamanca",
"region": "Castilla - Leon",
"province": "Salamanca",
"community": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6716,
"accuracy": "place"
},
"to": {
"countryCode": "ES",
"postalCode": "28013",
"place": "Madrid",
"region": "Madrid",
"province": "Madrid",
"community": "Madrid",
"latitude": 40.4187,
"longitude": -3.7076,
"accuracy": "place"
},
"distanceKm": 176.5,
"distanceMiles": 109.7,
"note": "Straight-line (great-circle) distance between postal code centroids.",
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35345/distance+between+postal+codes?from=ES:37007&to=ES:28013' --header 'Authorization: Bearer YOUR_API_KEY'
{
"countryCode": "DE",
"postalCode": "10115",
"valid": true,
"places": 1
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35346/validate+a+postal+code?country=DE&code=10115' --header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 121,
"countries": [
{
"countryCode": "AD",
"postalCodes": 7
},
{
"countryCode": "AE",
"postalCodes": 178171
},
{
"countryCode": "AI",
"postalCodes": 1
},
{
"countryCode": "AL",
"postalCodes": 494
},
{
"countryCode": "AR",
"postalCodes": 20260
},
{
"countryCode": "AS",
"postalCodes": 1
},
{
"countryCode": "AT",
"postalCodes": 19225
},
{
"countryCode": "AU",
"postalCodes": 18521
},
{
"countryCode": "AX",
"postalCodes": 37
},
{
"countryCode": "AZ",
"postalCodes": 1186
},
{
"countryCode": "BD",
"postalCodes": 1349
},
{
"countryCode": "BE",
"postalCodes": 2781
},
{
"countryCode": "BG",
"postalCodes": 5304
},
{
"countryCode": "BM",
"postalCodes": 112
},
{
"countryCode": "BR",
"postalCodes": 5525
},
{
"countryCode": "BY",
"postalCodes": 3133
},
{
"countryCode": "CA",
"postalCodes": 1657
},
{
"countryCode": "CC",
"postalCodes": 1
},
{
"countryCode": "CH",
"postalCodes": 4520
},
{
"countryCode": "CL",
"postalCodes": 346
},
{
"countryCode": "CN",
"postalCodes": 2352
},
{
"countryCode": "CO",
"postalCodes": 3681
},
{
"countryCode": "CR",
"postalCodes": 473
},
{
"countryCode": "CX",
"postalCodes": 1
},
{
"countryCode": "CY",
"postalCodes": 1127
},
{
"countryCode": "CZ",
"postalCodes": 15507
},
{
"countryCode": "DE",
"postalCodes": 23300
},
{
"countryCode": "DK",
"postalCodes": 1159
},
{
"countryCode": "DO",
"postalCodes": 544
},
{
"countryCode": "DZ",
"postalCodes": 15951
},
{
"countryCode": "EC",
"postalCodes": 1225
},
{
"countryCode": "EE",
"postalCodes": 5398
},
{
"countryCode": "ES",
"postalCodes": 37867
},
{
"countryCode": "FI",
"postalCodes": 3576
},
{
"countryCode": "FK",
"postalCodes": 1
},
{
"countryCode": "FM",
"postalCodes": 4
},
{
"countryCode": "FO",
"postalCodes": 130
},
{
"countryCode": "FR",
"postalCodes": 51611
},
{
"countryCode": "GB",
"postalCodes": 27450
},
{
"countryCode": "GF",
"postalCodes": 77
},
{
"countryCode": "GG",
"postalCodes": 14
},
{
"countryCode": "GI",
"postalCodes": 1
},
{
"countryCode": "GL",
"postalCodes": 33
},
{
"countryCode": "GP",
"postalCodes": 105
},
{
"countryCode": "GS",
"postalCodes": 1
},
{
"countryCode": "GT",
"postalCodes": 548
},
{
"countryCode": "GU",
"postalCodes": 21
},
{
"countryCode": "HK",
"postalCodes": 1
},
{
"countryCode": "HM",
"postalCodes": 1
},
{
"countryCode": "HN",
"postalCodes": 38
},
{
"countryCode": "HR",
"postalCodes": 6774
},
{
"countryCode": "HT",
"postalCodes": 236
},
{
"countryCode": "HU",
"postalCodes": 3571
},
{
"countryCode": "ID",
"postalCodes": 81058
},
{
"countryCode": "IE",
"postalCodes": 139
},
{
"countryCode": "IM",
"postalCodes": 87
},
{
"countryCode": "IN",
"postalCodes": 155570
},
{
"countryCode": "IO",
"postalCodes": 1
},
{
"countryCode": "IS",
"postalCodes": 195
},
{
"countryCode": "IT",
"postalCodes": 18415
},
{
"countryCode": "JE",
"postalCodes": 5
},
{
"countryCode": "JP",
"postalCodes": 146883
},
{
"countryCode": "KE",
"postalCodes": 890
},
{
"countryCode": "KR",
"postalCodes": 35583
},
{
"countryCode": "LI",
"postalCodes": 13
},
{
"countryCode": "LK",
"postalCodes": 1837
},
{
"countryCode": "LT",
"postalCodes": 21870
},
{
"countryCode": "LU",
"postalCodes": 4519
},
{
"countryCode": "LV",
"postalCodes": 6101
},
{
"countryCode": "MA",
"postalCodes": 1325
},
{
"countryCode": "MC",
"postalCodes": 29
},
{
"countryCode": "MD",
"postalCodes": 1753
},
{
"countryCode": "MH",
"postalCodes": 2
},
{
"countryCode": "MK",
"postalCodes": 220
},
{
"countryCode": "MO",
"postalCodes": 1
},
{
"countryCode": "MP",
"postalCodes": 3
},
{
"countryCode": "MQ",
"postalCodes": 100
},
{
"countryCode": "MT",
"postalCodes": 73
},
{
"countryCode": "MW",
"postalCodes": 491
},
{
"countryCode": "MX",
"postalCodes": 144655
},
{
"countryCode": "MY",
"postalCodes": 2818
},
{
"countryCode": "NC",
"postalCodes": 52
},
{
"countryCode": "NF",
"postalCodes": 1
},
{
"countryCode": "NL",
"postalCodes": 4334
},
{
"countryCode": "NO",
"postalCodes": 5132
},
{
"countryCode": "NR",
"postalCodes": 1
},
{
"countryCode": "NU",
"postalCodes": 1
},
{
"countryCode": "NZ",
"postalCodes": 1738
},
{
"countryCode": "PA",
"postalCodes": 729
},
{
"countryCode": "PE",
"postalCodes": 96943
},
{
"countryCode": "PF",
"postalCodes": 207
},
{
"countryCode": "PH",
"postalCodes": 2317
},
{
"countryCode": "PK",
"postalCodes": 2563
},
{
"countryCode": "PL",
"postalCodes": 72899
},
{
"countryCode": "PM",
"postalCodes": 2
},
{
"countryCode": "PN",
"postalCodes": 1
},
{
"countryCode": "PR",
"postalCodes": 177
},
{
"countryCode": "PT",
"postalCodes": 206942
},
{
"countryCode": "PW",
"postalCodes": 1
},
{
"countryCode": "RE",
"postalCodes": 152
},
{
"countryCode": "RO",
"postalCodes": 37915
},
{
"countryCode": "RS",
"postalCodes": 1155
},
{
"countryCode": "RU",
"postalCodes": 43538
},
{
"countryCode": "SE",
"postalCodes": 18887
},
{
"countryCode": "SG",
"postalCodes": 121154
},
{
"countryCode": "SI",
"postalCodes": 556
},
{
"countryCode": "SJ",
"postalCodes": 8
},
{
"countryCode": "SK",
"postalCodes": 5233
},
{
"countryCode": "SM",
"postalCodes": 26
},
{
"countryCode": "TC",
"postalCodes": 1
},
{
"countryCode": "TH",
"postalCodes": 903
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35347/supported+countries' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el API de Códigos Postales - Búsqueda de Códigos ZIP en 121 Países API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
Cada punto final devuelve información detallada sobre los códigos postales, incluidos los nombres de los lugares, regiones, provincias, coordenadas y distancias entre códigos. El punto final de validación confirma si un código postal es válido, mientras que el punto final de países soportados lista todos los países y el número de códigos postales disponibles para cada uno
Los campos clave incluyen `countryCode`, `postalCode`, `place`, `region`, `province`, `latitude`, `longitude` y `distanceKm` o `distanceMiles` Estos campos proporcionan detalles geográficos y administrativos esenciales sobre los códigos postales
Los datos de respuesta están estructurados en formato JSON con objetos anidados para lugares y distancias Cada punto final devuelve una estructura consistente lo que facilita analizar y utilizar los datos programáticamente
El endpoint de búsqueda proporciona detalles del lugar y el estado de validación el endpoint de distancia calcula distancias entre códigos postales y el endpoint de países soportados lista todos los países con sus respectivos conteos de códigos postales
Los usuarios pueden ingresar códigos postales con o sin espacios y guiones. El punto final de distancia requiere dos códigos postales, mientras que el punto final de validación requiere uno. El punto final de búsqueda acepta un solo código postal para obtener información detallada
La precisión de los datos se mantiene mediante la obtención de información de GeoNames, que proporciona información geográfica confiable. Actualizaciones regulares y verificaciones de validación aseguran que los datos se mantengan actuales y precisos
Los casos de uso típicos incluyen servicios basados en la ubicación planificación logística análisis demográfico y validación de direcciones en aplicaciones Las empresas pueden utilizar estos datos para mejorar las experiencias del cliente y optimizar la entrega de servicios
Los usuarios pueden extraer campos específicos como `latitud` y `longitud` para mapeo, usar `distanciaKm` para cálculos de viaje o validar direcciones en formularios. El formato JSON estructurado permite una fácil integración en aplicaciones y servicios