Sobre el proyecto
Qué es, cómo funciona y de dónde salen los datos.
Por qué esta herramienta
En las democracias representativas, los ciudadanos no votamos directamente las leyes: delegamos esa decisión en las personas que elegimos cada cuatro años. El pacto funciona si podemos ver qué hacen nuestros representantes con el mandato: qué leyes aprueban, cuáles rechazan, quién las propone, cómo vota cada grupo. Esta plataforma centraliza esa información en un único lugar, abierta y descargable, para que cualquier ciudadano o periodista pueda seguirla sin navegar por portales oficiales dispersos.
Qué es Hola Política
Plataforma cívica abierta que centraliza las votaciones, iniciativas y actividad parlamentaria de las cámaras españolas. Permite a periodistas y ciudadanía consultar qué ha votado cada diputado o grupo, sin intermediarios ni interpretación política.
Principio: espejo, no megáfono
El proyecto es infraestructura cívica neutra. No emite opiniones ni valoraciones sobre las votaciones: sólo datos verificables. Las métricas comparativas entre grupos o diputados siempre se muestran completas (todas las parejas, los dos extremos del rango) para evitar narrativas unilaterales.
Cómo usamos la IA
Los textos oficiales del Congreso son largos y técnicos. Para que se puedan leer, un modelo de lenguaje hace cuatro tareas, y ninguna consiste en decidir nada:
- Resume cada iniciativa en lenguaje llano y le pone un titular.
- La clasifica por temas (vivienda, sanidad, empleo…), que es como la puedes filtrar.
- Extrae a quién afecta a partir del propio texto de la ley (inquilinos, autónomos, jóvenes…).
- Lee el texto oficial de cada ley (el PDF del Congreso, o el BOE para los reales decretos-ley) para explicar sus medidas concretas, con el artículo donde aparece cada una, y qué cambia: impuestos, derechos, medio ambiente y gestión de los servicios, siempre en parejas. Cada etiqueta lleva el pasaje que la justifica y la revisa una segunda lectura más estricta; si no se puede justificar, no se pone.
Todo lo que hace la IA va marcado como «hecho con IA», y el texto oficial está siempre a un toque, en el botón «Texto original». Puede equivocarse: la fuente autorizada es el texto legal.
Los resultados de las votaciones y quién ha votado qué no pasan por ninguna IA: salen directamente de los datos oficiales del Congreso.
De dónde salen los datos
De los datos abiertos que publica el Congreso de los Diputados en congreso.es: las votaciones del pleno con el voto de cada diputado, las iniciativas y su recorrido, la composición de los grupos y el calendario de sesiones. Los importamos automáticamente.
No los retocamos. Si un dato falta en el origen, aquí también falta, y lo decimos: por ejemplo, una votación por asentimiento no tiene voto nominal y la tarjeta lo indica.
Datos personales y RGPDQué significa cada cosa
El lenguaje parlamentario es técnico. Aquí tienes los términos que verás más a menudo, en lenguaje llano.
- Proyecto de Ley
- Ley propuesta por el Gobierno. Si se aprueba, se convierte en ley vigente. Es la vía principal por la que el Gobierno legisla.
- Proposición de Ley
- Ley propuesta por un grupo parlamentario (no por el Gobierno). Si se aprueba, se convierte en ley vigente.
- Proposición no de Ley (PNL)
- Propuesta NO vinculante. Pide al Gobierno que haga algo, pero no cambia la ley. Si se aprueba, es un mandato político sin fuerza legal directa. Son las votaciones más frecuentes en el pleno.
- Real Decreto-ley (RDL)
- Norma con fuerza de ley dictada por el Gobierno por urgencia. El Congreso debe convalidarla (aceptarla) o derogarla (anularla) en 30 días.
- Moción consecuencia de interpelación
- Tras una pregunta urgente al Gobierno (interpelación), un grupo puede presentar una moción pidiendo una posición concreta. Vinculante políticamente, no jurídicamente.
- Convalidación / Derogación
- Decisión del Congreso sobre un RDL del Gobierno: convalidar es aceptarlo, derogar es anularlo.
- Cohesión interna
- % de miembros de un grupo que votan igual. Una cohesión del 100% significa disciplina total de voto; números más bajos, más votaciones cruzadas.
- Coincidencia entre grupos
- % de votaciones donde dos grupos votaron el mismo sentido (Sí, No o Abstención).
Cobertura
- Fase 1, Congreso de los Diputados (XV legislatura), activo.
- Fase 2, Parlament de Catalunya, próximamente.
- Fase 3, Pleno del Consejo Municipal de Barcelona, próximamente.
API pública
Toda la información que ves aquí está disponible para periodistas, investigadores y la ciudadanía a través de una API REST documentada. Sin claves, sin registro, sin límites arbitrarios. Los datos se publican bajo CC-BY 4.0.
GET /docsDocumentación interactiva (Swagger UI)GET /redocDocumentación alternativa (ReDoc)GET /openapi.jsonEspecificación OpenAPI (JSON, legible por máquina)
Volcados masivos en JSON
Para análisis académico y periodismo de datos, exponemos endpoints de volcado que devuelven un dataset completo en una sola petición:
Diputados activos de una legislatura con su grupo y circunscripción.
curl 'https://api.holapolitica.org/dump/deputies?legislature_id=1'
Todas las votaciones de una legislatura con los resultados agregados (Sí/No/Abst/Ausente). Filtro opcional por fechas.
curl 'https://api.holapolitica.org/dump/votes?legislature_id=1&from=2024-01-01&to=2024-12-31'
Voto individual de cada diputado en UNA votación concreta (se pasa el identificador). Se separa para evitar descargas de cientos de miles de registros en una sola petición.
curl 'https://api.holapolitica.org/dump/vote-records?vote_id=42'
Todas las iniciativas de una legislatura con su clasificación temática.
curl 'https://api.holapolitica.org/dump/initiatives?legislature_id=1'
Cuotas
Sin límites duros hoy. Pedimos a los consumidores mantener un ritmo razonable. Para cargas masivas recurrentes o uso académico intensivo, contáctanos para coordinar copias de volcados periódicos.
Licencia y contribución
Código bajo EUPL-1.2. Datos bajo CC-BY 4.0. El proyecto es open source y las contribuciones son bienvenidas.