API · Gratis · Sin keys
200,874
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 cuota mensual. Cacheado en Cloudflare, así que es rápido desde donde sea.
Quickstart
Un curl. JSON. Listo.
Sin headers de auth, sin tokens. Pega el comando, te responde.
Request
curl https://postali.app/api/v1/mx/cp/06700El segmento /mx/ indica el país. Cambia 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 →
Integraciones
¿Vendes con WooCommerce?
El plugin Postali — Códigos postales de México usa esta API en el checkout: tu cliente escribe el código postal y se llenan el estado, la ciudad y una lista con las colonias. Funciona con el checkout clásico y el de bloques. Gratis y sin API key, como la API.
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 usas en un proyecto público, agradecemos un link a postali.app. No es obligatorio, pero ayuda.
Empezar
Copia. Pega. Listo.
curl https://postali.app/api/v1/mx/cp/06700