Rápida
8 ms al percentil 95
Con el catálogo completo cargado y sin caché. Con caché baja a 3 ms, así que cabe entre una tecla y la siguiente sin hacer esperar a nadie.
Catálogo nacional · 4 de septiembre de 2026
Cinco dígitos y el resto de la dirección se escribe sola.
Estado, municipio, oficina y colonias de cualquier código postal de México en una petición. El catálogo completo de Correos de México, normalizado y consultable por API.
1,000 peticiones al mes sin tarjeta · sin límite de tiempo
Remitente
pc-mex · API de
códigos postales
MÉXICO01000SEPOMEX
Ana Sofía Márquez Cordero
Av. Revolución 1425, Int. 3
Col. San Ángel
01000 Álvaro Obregón, Ciudad de México
Oficina postal 01001 · una petición a /v1/postal-codes/01000
- Colonias
- 159,201
- Códigos postales
- 31,875
- Municipios
- 2,478
- Estados
- 32
Empezar
Una key, una cabecera, listo
Creas la cuenta, generas una API key y la mandas en la cabecera X-Api-Key. No hay OAuth, ni SDK obligatorio, ni un proceso de alta que tarde días.
- JSON plano, con los mismos nombres de campo en todos los endpoints.
- Errores uniformes: siempre
{ error: { code, message } }. - OpenAPI 3.1 generado del código, con referencia navegable en /docs.
curl "https://api.pc-mex.jlpz.me/v1/postal-codes/01000" \
-H "X-Api-Key: $PCMEX_API_KEY"Respuesta: estado, municipio, oficina postal y la lista de colonias del código, cada una con su tipo (colonia, fraccionamiento, ejido…) y su zona.
curl "https://api.pc-mex.jlpz.me/v1/search?q=alvaro+obregon&limit=5" \
-H "X-Api-Key: $PCMEX_API_KEY"Búsqueda
«alvaro obregon» encuentra «Álvaro Obregón»
Nadie captura su colonia con acentos ni como viene en el catálogo. La búsqueda normaliza el texto, aguanta erratas y ordena por parecido real, no por orden alfabético.
Consulta
alvaro obregon
- 09230Álvaro Obregón · ColoniaIztapalapa, Ciudad de México
- 15990Álvaro Obregón · ColoniaVenustiano Carranza, Ciudad de México
- 29244Alvaro Obregón · FraccionamientoSan Cristóbal de las Casas, Chiapas
Pensada para vivir dentro de un formulario
Al día
El catálogo, no una copia vieja
Cada publicación de Correos de México se importa entera y se compara con la anterior: altas, bajas y cambios campo por campo. La versión vigente está siempre a la vista.
Barata de operar
304 cuando nada cambió
Cache-Control y ETag en todas las respuestas. Si mandas If-None-Match y el dato no se movió, recibes un 304 que no gasta cuota.
Precios
En pesos, IVA incluido, cobro mensual y sin permanencia. Empiezas gratis y sin tarjeta.
Gratis
Para probar la API y proyectos pequeños.
Gratis
- 1 000 peticiones al mes
- 2 peticiones por segundo
- 1 API key activa
- Catálogo completo y actualizado
Starter
Más elegidoPara un sitio o una app en producción.
$149MXN al mes, IVA incluido
- 50 000 peticiones al mes
- 10 peticiones por segundo
- 5 API keys activas
- Soporte por correo
Pro
Para volumen alto y varios entornos.
$499MXN al mes, IVA incluido
- 500 000 peticiones al mes
- 50 peticiones por segundo
- 100 API keys activas
- Soporte prioritario por correo
Preguntas frecuentes
¿De dónde salen los datos?
Del Catálogo Nacional de Códigos Postales que publica el Servicio Postal Mexicano. Cada publicación se importa completa y se compara contra la anterior, así que puedes ver qué cambió y desde cuándo. pc-mex no es un servicio oficial de Correos de México ni está afiliado a esa institución.
¿Cada cuándo se actualiza?
En cuanto Correos de México publica una versión nueva. La fecha de la que está en línea aparece en /v1/meta y en la página de estado del catálogo, así que nunca tienes que confiar en nuestra palabra.
¿Qué pasa si me paso de las peticiones incluidas?
La API responde 429 hasta el siguiente mes calendario. No hay cobros por excedente ni sorpresas en la factura; si el plan te queda corto puedes subir en cualquier momento y el límite nuevo aplica en la siguiente petición.
¿Necesito tarjeta para empezar?
No. El plan gratuito son 1 000 peticiones al mes, sin caducidad y sin método de pago. Cuando quieras más, los planes de pago se contratan con tarjeta desde tu panel.
¿Puedo guardar en caché las respuestas?
Sí, y conviene. Toda respuesta trae Cache-Control y ETag: si mandas If-None-Match y nada cambió recibes un 304 que no consume cuota.
¿Sirve para autocompletar direcciones en un checkout?
Es el caso para el que está pensada. La consulta por código postal responde en milisegundos y la búsqueda por colonia tolera acentos y erratas, así que cabe entre una tecla y la siguiente.
Tu primera petición, en dos minutos
Crea la cuenta, genera una key y pruébala desde la terminal.