Widget y API gratis de códigos postales de México
¿Tienes un sitio web o una tienda en línea? Agrega un buscador de códigos postales de México gratis con nuestro widget embebible, o integra los datos directamente con nuestra API JSON. Los datos provienen de la base de Sepomex.
1. Widget embebible
Copia este código donde quieras que aparezca el buscador. No requiere librerías ni configuración:
HTML
<div id="cp-widget"></div> <script src="https://www.correosmexico.com.mx/assets/js/cp-widget.js" async></script>
Demostración en vivo
2. API de códigos postales (JSON)
Consulta por código postal o por texto (colonia, municipio, ciudad o estado). Respuesta en JSON, con CORS abierto.
| Petición | Descripción |
|---|---|
GET /api/cp?cp=06700 | Datos del código postal indicado (5 dígitos). |
GET /api/cp?q=roma+norte | Búsqueda por texto (colonia, municipio, ciudad o estado), mínimo 3 caracteres. |
Respuesta en JSON · CORS abierto
Ejemplo de respuesta para /api/cp?cp=06700:
JSON
{
"cp": "06700",
"total": 1,
"resultados": [
{
"cp": "06700",
"estado": "Ciudad de México",
"municipio": "Cuauhtémoc",
"ciudad": "Ciudad de México",
"asentamiento": "Roma Norte",
"tipo": "Colonia"
}
]
}Términos de uso
El widget y la API son gratuitos para uso razonable. Solo te pedimos mantener el enlace de atribución a Códigos Postales de México que incluye el widget. Los datos se ofrecen tal cual, sin garantía de exactitud; ante dudas, confirma con Correos de México.