La alternativa gratuita a Correos. Codigos postales, municipios, provincias, coordenadas GPS y festivos locales. Todo en una API REST sin limites.
Desde autocompletar formularios hasta calcular dias laborables
Usuario escribe CP → obtienes municipio, provincia y CCAA automaticamente. Perfecto para formularios de checkout o registro.
Comprueba si un CP existe realmente en Espana o Andorra. Evita errores de envio y datos incorrectos.
Obten los festivos locales de cualquier municipio (2023-2026). Ideal para apps de RRHH, control horario o calendarios.
Coordenadas GPS de 6.726 municipios. Muestra ubicaciones en mapas o calcula distancias.
Poblacion de cada municipio y codigos INE oficiales. Util para estudios de mercado y analisis.
Busca por nombre, obtiene el CP. Ideal para buscadores y autocompletados inversos.
Todo empezo con Fichiando, nuestra app de control horario para empresas espanolas. Necesitabamos saber los festivos locales de cada municipio para calcular correctamente las horas trabajadas.
El problema: el gobierno espanol NO proporciona estos datos de forma abierta y estructurada. Correos vende una base de datos por ~800€/ano... pero solo tiene codigos postales, sin festivos ni coordenadas.
Asi que nos pusimos manos a la obra: meses scrapeando BOEs, boletines autonomicos, cruzando datos del INE, parseando PDFs ilegibles... Un trabajo de locos que decidimos compartir gratis.
Creemos que los datos publicos deben ser publicos de verdad.
No deberia costarte 800€ saber que festivos tiene tu pueblo.
— El equipo de Fichiando
info@fichiando.com
📢 Mensaje al Gobierno de Espana:
Si desde algun ministerio leen esto y quieren contratarme para hacer este trabajo bien hecho
y con datos oficiales actualizados... ¡estoy disponible!
Eso si, aviso: no soy una Jessica, ni una Andrea, ni Miss Asturias.
Lo mas lejos que van a poder verme la hucha es si me agacho a recoger algo.
Pero vamos, que si viene con pisito en Gran Via, viajes en business y demas... tampoco voy a decir que no. 😏
(Por cierto, empresas privadas tambien pueden escribir. Prometo no morder... mucho.)
Hicimos el trabajo sucio: recopilamos, parseamos y estructuramos todos los datos. Y decidimos regalartelos.
| Funcionalidad | Correos (~800 euros) | Esta API (GRATIS) |
|---|---|---|
| Codigos postales (Espana + Andorra) | 11.051 | 11.058 |
| Municipios | 8.124 | 8.131 |
| Festivos locales | NO TIENEN | 5.293 municipios |
| Coordenadas GPS | NO | 6.719 municipios |
| Codigos INE | NO | 8.131 |
| API REST JSON | NO (ficheros .txt) | SI |
| Nivel callejero | SI | Proximamente |
| Andorra (7 parroquias) | SI | SI (AD100-AD700) |
| PRECIO | ~800 euros/ano | 0 euros |
687 - 832 €/ano
Base de datos descargable (NO es API REST).
Solo codigos postales, sin festivos ni GPS.
50 - 500+ €/ano
API REST con validacion.
~0,02-0,04€ por cada llamada.
$49/mes (~588$/ano)
Plan Pro: 100.000 requests/mes.
Gratis solo 1.000 requests/mes.
0 €. Gratis.
Sin limites, sin registro, sin API key.
+ Festivos locales + GPS + Codigos INE.
Resumen: Otros cobran 500-800€/ano por datos basicos. Nosotros te damos mas datos y mejores, y solo pedimos un cafe si te apetece. ☕
No somos Google. No somos Facebook. No nos interesan tus datos.
Esta web no usa cookies. Ninguna. Ni propias ni de terceros.
Usa la API directamente. No pedimos email, ni cuenta, ni API key.
No guardamos quien consulta, que consulta, ni desde donde.
Tus consultas no se venden, analizan ni comparten. Jamas.
API REST sencilla. Sin autenticacion. JSON en todas las respuestas.
/festivos/v1/cp/{cp}
Festivos por codigo postal
/festivos/v1/ine/{ine}
Festivos por codigo INE
/festivos/v1/buscar?q={texto}
Buscar municipios por nombre
/festivos/v1/anio/{ano}
Todos los festivos de un ano
/festivos/v1/provincia/{cod}
Municipios de una provincia
/festivos/v1/ccaa/{cod}
Municipios de una CCAA
/festivos/v1/stats
Estadisticas de la API
/festivos/v1/data/municipios.json
Descarga completa (3.5 MB)
Introduce un codigo postal y comprueba la respuesta en tiempo real
Integra la API en tu proyecto en minutos
// Obtener festivos de un codigo postal const response = await fetch('https://api.cerocoma.net/festivos/v1/cp/30001'); const data = await response.json(); if (data.success) { data.municipios.forEach(muni => { console.log(`${muni.municipio}: ${muni.festivos}`); }); }
// Consultar festivos por codigo postal $cp = '30001'; $response = json_decode(file_get_contents("https://api.cerocoma.net/festivos/v1/cp/{$cp}"), true); foreach ($response['municipios'] as $muni) { echo "{$muni['municipio']}: " . implode(', ', $muni['festivos']['2026'] ?? []); }
curl https://api.cerocoma.net/festivos/v1/cp/30001
Autocompletado de direcciones en cualquier formulario. El usuario escribe el CP y se rellenan automaticamente municipio y provincia. Ademas, muestra festivos locales.
Creado por Fichiando · info@fichiando.com
Autocompletar + Festivos para WordPress
Recopilar estos datos ha sido un trabajo de
locos: parsear PDFs ilegibles, scrapear webs del BOE a las 3 de la manana, cruzar miles de registros...
🍕 Necesitamos comer para seguir vivos
🏎️ Y comprarnos un Ferrari cada ano (es broma, con un bocadillo nos conformamos)
🏢 ¿Usas esto en tu app comercial que te genera dinero?
Correos te cobraria ~800€/ano por datos peores. Si quieres echarnos un cable con lo que consideres justo... ¡te lo agradeceremos eternamente!