API · Gratis · Sin keys

200,028

entradas · 3 países · actualizadas semanalmente

API REST sobre los directorios oficiales de México, Colombia y España (Sepomex, GeoNames, GeoNames). Sin API key. Sin registro. Sin límite mensual. Cacheado en Cloudflare, así que es rápido desde donde sea.

Quickstart

Un curl. JSON. Listo.

Sin headers de auth, sin tokens. Pegá el comando, te responde.

Request

curl https://postali.app/api/v1/mx/cp/06700

El segmento /mx/ indica el país. Cambiá a /co/ o /es/ para Colombia o España. /api/v1/cp/... sin prefijo defaultea a México.

Response

{
  "cp": "06700",
  "estado": "Ciudad de México",
  "estado_slug": "ciudad-de-mexico",
  "municipio": "Cuauhtémoc",
  "municipio_slug": "cuauhtemoc",
  "asentamientos": [
    {
      "nombre": "Roma Norte",
      "tipo": "Colonia",
      "ciudad": "Ciudad de México",
      "zona": "Urbano",
      "asenta_slug": "roma-norte"
    }
  ]
}

Endpoints

REST puro

Método

Ruta

GET

/api/v1/{país}/cp/{codigo}

GET

/api/v1/{país}/validate/{codigo}

GET

/api/v1/{país}/search?q=…

GET

/api/v1/{país}/estados

GET

/api/v1/{país}/estado/{slug}

GET

/api/v1/{país}/estado/{slug}/municipios

GET

/api/v1/{país}/municipio/{estado}/{municipio}

POST

/api/v1/{país}/bulk

{país} es uno de mx, co, es. Omitir el prefijo equivale a mx. Detalles, parámetros y respuestas en la referencia →

Por qué es gratis

Datos públicos, infra eficiente.

Los códigos postales son información pública: vienen de SEPOMEX (MX) y GeoNames (CO, ES). El servidor es Rust + SQLite, las respuestas viven en Cloudflare edge — servir un lookup más cuesta esencialmente cero.

Si la usás en un proyecto público, agradecemos un link a postali.app. No es obligatorio, pero ayuda.

Empezar

Copiá. Pegá. Servite.

curl https://postali.app/api/v1/mx/cp/06700

Ver referencia →