Data and APIs
Iniciar sesiónComenzar
Zip & Postal Code API
DatosMANTENIDA2 tokens / llamada

Zip & Postal Code API

Consulta de códigos postales de unos 100 países, con localidad, región y coordenadas

Consulta códigos postales/ZIP de ~100 países — nombre del lugar, estado/provincia, condado y coordenadas geográficas. Busca de forma directa por código, o inversa por nombre del lugar. Basado en el conjunto de datos postal de GeoNames (~1,5 millones de códigos).

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 2 tokens por llamada, así que el plan gratuito cubre unas 250 llamadas al mes.

Start free — 500 tokens / mo →See all plans
Sin tarjeta de créditoAcceso a más de 125 APIsCancela cuando quieras
response.json
{
  "country": "US",
  "postal_code": "90210",
  "place_count": 1,
  "places": [
    {
      "country_code": "US",
      "postal_code": "90210",
      "place_name": "Beverly Hills",
      "state": "California",
      "state_code": "CA",
      "county": "Los Angeles",
      "latitude": 34.0901,
      "longitude": -118.4065,
      "accuracy": 4
    }
  ]
}
Listo para producción
Infraestructura probada en producción con un SLA de disponibilidad del 99,9 %. Límites de uso generosos y respuestas consistentes.
Integración sencilla
REST + JSON estándar. Funciona con cualquier cliente HTTP. Fragmentos de código listos para copiar en 4 lenguajes.
Una clave, más de 125 APIs
Tu suscripción a DataAndAPIs desbloquea todas las APIs de la plataforma: anime, finanzas, deportes y más.

Casos de uso de Zip & Postal Code API

  • Rellenar automáticamente ciudad y provincia a partir del código postal en un formulario de pago o alta.

  • Validar que un código postal existe y pertenece al país que seleccionó el cliente.

  • Obtener las coordenadas de un código postal para estimar la distancia de entrega o encontrar la tienda más cercana.

  • Buscar en sentido inverso, del nombre de un lugar a sus códigos postales, para ayudas de introducción de direcciones.

Endpoints de Zip & Postal Code API

Todos los endpoints con sus parámetros y una respuesta de ejemplo real.

Definición OpenAPIEspacio de trabajo en Postman

GETPostal Code Lookup

https://api-postal-code.dataandapis.com/v1/postal-code

Parámetros de consulta

ParámetroEjemplo
code90210Obligatorio
countryUSObligatorio

Petición de ejemplo

curl "https://api-postal-code.dataandapis.com/v1/postal-code?code=90210&country=US" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "country": "US",
  "postal_code": "90210",
  "place_count": 1,
  "places": [
    {
      "country_code": "US",
      "postal_code": "90210",
      "place_name": "Beverly Hills",
      "state": "California",
      "state_code": "CA",
      "county": "Los Angeles",
      "county_code": "037",
      "latitude": 34.0901,
      "longitude": -118.4065,
      "accuracy": 4
    }
  ]
}

GETSearch By Place

https://api-postal-code.dataandapis.com/v1/search

Parámetros de consulta

ParámetroEjemplo
countryUSObligatorio
placeBeverly HillsObligatorio

Petición de ejemplo

curl "https://api-postal-code.dataandapis.com/v1/search?country=US&place=Beverly%20Hills" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "country": "US",
  "query": "Beverly Hills",
  "result_count": 1,
  "results": [
    {
      "country_code": "US",
      "postal_code": "90210",
      "place_name": "Beverly Hills",
      "state": "California",
      "state_code": "CA",
      "county": "Los Angeles",
      "county_code": "037",
      "latitude": 34.0901,
      "longitude": -118.4065,
      "accuracy": 4
    }
  ]
}

De dónde salen los datos

Fuente
Conjunto de códigos postales de GeoNames (CC BY 4.0), cerca de 1,5 millones de códigos.
Actualización
Recargado desde la exportación postal de GeoNames con cada actualización del conjunto.

Una instalación. Todos los endpoints.

No necesitas SDKs propietarios. Funciona con cualquier cliente HTTP. Elige tu lenguaje y pega el código.

3lenguajes
2endpoints
RESTarquitectura
1clave para todas las APIs
  • Respuestas totalmente tipadas — autocompletado en tu IDE
  • Sigue la API al día — los nuevos endpoints llegan el mismo día
  • Una sola clave funciona en más de 125 APIs de la plataforma
import axios from 'axios';

const { data } = await axios.get(
  'https://api-postal-code.dataandapis.com/v1/postal-code',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Zip & Postal Code API · X-Api-Key

Explora los endpoints

Explora los parámetros de solicitud e inspecciona ejemplos de respuesta en vivo.

Endpoints disponibles

Parámetros de la solicitud

URL de la API

Encabezados

X-Api-Key

Parámetros de consulta

code(Obligatorio)
country(Obligatorio)
import axios from 'axios';

const url = 'https://api-postal-code.dataandapis.com/v1/postal-code';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Una suscripción. Todas las APIs.

Los tokens desbloquean esta API y más de 20 más en DataAndAPIs. Cambia de API cuando quieras.

GRATIS

$0/mes

500 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte comunitario
Comienza gratis
Más Popular

STARTER

$6.99/mes

25.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email
Suscribirse

PRO

$24.99/mes

100.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email prioritario
Suscribirse

ULTRA

$99.99/mes

1.000.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte prioritario
Suscribirse

¿Necesitas mayor volumen, infraestructura dedicada o un contrato personalizado? Habla con ventas →

Preguntas sobre Zip & Postal Code API

APIs que suelen usarse con Zip & Postal Code API

Lanza Zip & Postal Code API esta tarde.

500 tokens gratis. Sin tarjeta. Y más de 125 APIs más con la misma clave.

Obtén tu clave API →Explorar todas las APIs