v2.2100% GratuitaSin registroSin API key

API de Codigos Postales
de España y Andorra

La alternativa gratuita a Correos. Codigos postales, municipios, callejero oficial, coordenadas GPS y festivos nacionales, regionales y locales (2024-2030). Todo en una API REST sin limites.

11.058
Codigos postales
8.131
Municipios
712.969
Calles (INE)
5.293
Con festivos
El gobierno espanol NO proporciona estos datos abiertamente. Correos te cobra ~800€/año. Nosotros te los regalamos. Leer la historia →

¿Que puedes hacer con esta API?

Desde autocompletar formularios hasta calcular dias laborables

Autocompletar direcciones

Usuario escribe CP → obtienes municipio, provincia y CCAA automaticamente. Perfecto para formularios de checkout o registro.

Validar codigos postales

Comprueba si un CP existe realmente en España o Andorra. Evita errores de envio y datos incorrectos.

Consultar festivos completos

Festivos nacionales, regionales (por CCAA) y locales de cualquier municipio (2024-2030). Ideal para apps de RRHH, control horario o calendarios.

Geocoding basico

Coordenadas GPS de 6.726 municipios. Muestra ubicaciones en mapas o calcula distancias.

Datos demograficos

Poblacion de cada municipio y codigos INE oficiales. Util para estudios de mercado y analisis.

Busqueda de municipios

Busca por nombre, obtiene el CP. Ideal para buscadores y autocompletados inversos.

NUEVO

Callejero oficial (INE)

712.969 calles en 10.061 codigos postales. Datos del Callejero del Censo Electoral del INE (Enero 2025).

¿Por que existe esta API?

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€/año... 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.

📄
PDFs del BOE
ilegibles
🌙
Noches en vela
scrapeando
🎁
Resultado:
API gratuita

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 España:

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.)

Lo que tienes aqui vs. lo que te venden

Hicimos el trabajo sucio: recopilamos, parseamos y estructuramos todos los datos. Y decidimos regalartelos.

Funcionalidad Correos (~800 euros) Esta API (GRATIS)
Codigos postales (España + 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 SI (712.969 calles)
Andorra (7 parroquias) SI SI (AD100-AD700)
PRECIO ~800 euros/año 0 euros

💸 Lo que cobran otros por datos similares

📮 Correos España

687 - 832 €/año

Base de datos descargable (NO es API REST).
Solo codigos postales, sin festivos ni GPS.

🌍 Postcode.eu

50 - 500+ €/año

API REST con validacion.
~0,02-0,04€ por cada llamada.

🔧 ZipBase

$49/mes (~588$/año)

Plan Pro: 100.000 requests/mes.
Gratis solo 1.000 requests/mes.

🇪🇸 Esta API (api.cerocoma.net)

0 €. Gratis.

Sin limites, sin registro, sin API key.
+ Festivos locales + GPS + Codigos INE.

Resumen: Otros cobran 500-800€/año por datos basicos. Nosotros te damos mas datos y mejores, y solo pedimos un cafe si te apetece. ☕

Privacidad total. Cero rastreo.

No somos Google. No somos Facebook. No nos interesan tus datos.

Sin cookies

Esta web no usa cookies. Ninguna. Ni propias ni de terceros.

Sin registro

Usa la API directamente. No pedimos email, ni cuenta, ni API key.

Sin logs de usuarios

No guardamos quien consulta, que consulta, ni desde donde.

Sin venta de datos

Tus consultas no se venden, analizan ni comparten. Jamas.

Endpoints disponibles

API REST sencilla. Sin autenticacion. JSON en todas las respuestas.

📅 Cobertura de festivos: Nacionales y regionales (CCAA) 2024-2030 oficiales. Locales de municipios: 2024-2026 oficiales, 2027-2030 proyecciones estimadas basadas en patrones historicos.

GET /festivos/v1/search?q={texto} UNIVERSAL

Buscador inteligente: detecta CP, calle, municipio, fecha, INE, provincia o CCAA

GET /festivos/v1/cp/{cp}

Festivos por codigo postal

GET /festivos/v1/ine/{ine}

Festivos por codigo INE

GET /festivos/v1/calles/{cp} NUEVO

Callejero por codigo postal (INE)

GET /festivos/v1/buscar-calle?q={texto} NUEVO

Buscar calle + datos completos (CP, GPS, festivos...)

GET /festivos/v1/buscar?q={texto}

Buscar municipios por nombre

GET /festivos/v1/anio/{ano}

Todos los festivos de un año

GET /festivos/v1/provincia/{cod}

Municipios de una provincia

GET /festivos/v1/ccaa/{cod}

Municipios de una CCAA

GET /festivos/v1/festivos-ccaa/{cod} NUEVO

Festivos regionales de una CCAA (2024-2030)

GET /festivos/v1/festivos-ccaa NUEVO

Festivos regionales de todas las CCAA

GET /festivos/v1/festivos-nacionales NUEVO

Festivos nacionales de Espana (2024-2030)

GET /festivos/v1/stats

Estadisticas de la API

GET /festivos/v1/data/municipios.json

Descarga completa (3.5 MB)

Buscador universal

Busca cualquier cosa: CP, calle, municipio, fecha festiva, provincia...

📮 30001 🏘️ Murcia 📍 Gran Via 📅 15/09 🏛️ MUR 🔢 28079 (INE)

                

Ejemplos de codigo

Integra la API en tu proyecto en minutos

JavaScript
// 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}`);
    });
}
PHP
// 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
curl https://api.cerocoma.net/festivos/v1/cp/30001

Plugin para WordPress v3.0

Autocompletado inteligente en TODOS los formularios + 712.969 calles del Callejero INE + festivos locales. Actualizaciones automaticas incluidas.

  • Autocompletar - CP → rellena ciudad, provincia automaticamente
  • Callejero INE - 712.969 calles con [buscar_calle] NUEVO
  • Buscador universal - CP, calle, municipio, fecha... [buscador_universal] NUEVO
  • Compatible - WooCommerce, CF7, WPForms, Gravity Forms, Elementor...
  • Auto-updates - Notificacion de actualizaciones en WordPress
Descargar Plugin v3.0.0
Changelog v3.0.0:
  • Callejero INE 2025 con 712.969 calles
  • Shortcode [buscador_universal]
  • Shortcode [buscar_calle]
  • Sistema de actualizaciones automaticas
  • Mejor deteccion de campos (React/Vue)

Creado por Fichiando · info@fichiando.com

Codigos Postales API

Autocompletar + Callejero + Festivos

☕ NECESITAMOS CAFEINA ☕

¿Te ha sido util? ¡Invitanos a un cafe!

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 año (es broma, con un bocadillo nos conformamos)

🏢 ¿Usas esto en tu app comercial que te genera dinero?
Correos te cobraria ~800€/año por datos peores. Si quieres echarnos un cable con lo que consideres justo... ¡te lo agradeceremos eternamente!