Para redacciones

Herramientas listas para periodistas

Cuatro formas de incorporar lo que vota el Congreso en una pieza: widgets responsivos, cards sociales, API REST y descargas directas. Todo CC-BY 4.0 — basta con citar a Hola Política y la fuente original (Congreso de los Diputados).

Widgets para artículos

Cada widget es un <iframe> de menos de un segundo de carga, sin cookies de terceros, con enlace a la fuente original. Copia el fragmento y pégalo en el CMS. Cinco widgets, ordenados por utilidad editorial.

Ficha completa de una ley (dossier)

Un solo iframe con todo lo que un artículo sobre una ley suele querer al lado: el título, el resumen en lenguaje claro, los temas clasificados, el resultado de la votación final y los enlaces al BOE + fecha de entrada en vigor. Pensado para la pieza monográfica sobre UNA ley.

Fragmento HTML

<iframe
  src="https://holapolitica.org/embed/initiatives/6"
  width="100%" height="560" frameborder="0"
  loading="lazy"
  title="Ley en el Congreso — Hola Política"
></iframe>

Explorador filtrado (la URL es el estado)

Tres filtros en la URL y sales con la vista que querías: por tema, por resultado, por grupo proponente, por ventana temporal. Compartir el iframe con otro periodista equivale a compartir la consulta exacta — la URL es la query. Patrón de Our World in Data.

Fragmento HTML

<iframe
  src="https://holapolitica.org/embed/explorer?topic=habitatge&result=approved&limit=6"
  width="100%" height="640" frameborder="0"
  loading="lazy"
  title="Votaciones filtradas — Hola Política"
></iframe>
<!-- Parámetros aceptados: topic, result (approved|rejected|tie), group, from, to, limit (1-20) -->

Resultado de una votación · con cohesión por grupo

Para una votación concreta: totales (Sí · No · Abst. · Ausentes), barra apilada, quién la propone y — la información periodística clave — la tira de cohesión para los 4 grupos mayoritarios (cómo votó cada grupo como bloque) + porcentaje vs media de la legislatura.

Fragmento HTML

<iframe
  src="https://holapolitica.org/embed/votes/16491"
  width="100%" height="520" frameborder="0"
  loading="lazy"
  title="Votación en el Congreso — Hola Política"
></iframe>

Snapshot de un grupo parlamentario

Para una pieza sobre un grupo: el tema que más propone, dónde vota a favor más a menudo y dónde vota en contra más a menudo, con el número de escaños. Tres hechos para situar a un grupo de un vistazo.

Elige un grupo:

Fragmento HTML

<iframe
  src="https://holapolitica.org/embed/groups/gp-socialista"
  width="100%" height="320" frameborder="0"
  loading="lazy"
  title="Grupo parlamentario — Hola Política"
></iframe>

Quién vota a favor y en contra de un tema

Para una pieza centrada en un tema: cada grupo ordenado según su proporción de votos a favor y en contra. Elige el tema y copia el código.

Elige un tema:

Fragmento HTML

<iframe
  src="https://holapolitica.org/embed/topics/habitatge/parties"
  width="100%" height="420" frameborder="0"
  loading="lazy"
  title="Votos por grupo en un tema - Hola Política"
></iframe>

Snapshot por tema

Para una pieza centrada en un tema: cuántas iniciativas se han presentado, aprobado, rechazado o están en trámite. Pequeño, rápido, complementa bien un artículo temático.

Fragmento HTML

<iframe
  src="https://holapolitica.org/embed/topics/<slug>"
  width="100%" height="280" frameborder="0"
  loading="lazy"
  title="Tema — Hola Política"
></iframe>

Todos los slugs (grupo, tema) e identificadores (voto, ley, persona) son los de nuestra base de datos. Puedes encontrarlos navegando a /votes, /groups, /topics o /persons — o consultando la API en /apidocs.

Cards sociales (Open Graph)

Cada votación, iniciativa, grupo o persona tiene una imagen OG 1200×630 que se genera automáticamente. Cuando compartes un enlace de Hola Política en Bluesky, X o LinkedIn, la previsualización ya incluye el resultado de la votación o la ficha del diputado — sin tener que hacer ningún montaje.

Si quieres usar la imagen directamente como archivo (header de artículo, etc.), estas son las URLs estables de la convención Next.js:

https://holapolitica.org/opengraph-image
https://holapolitica.org/votes/16491/opengraph-image
https://holapolitica.org/groups/gp-socialista/opengraph-image
https://holapolitica.org/topics/habitatge/opengraph-image
https://holapolitica.org/persons/<id>/opengraph-image
https://holapolitica.org/initiatives/<id>/opengraph-image
https://holapolitica.org/stats/opengraph-image

Ideas de cortes de datos

Estas son rutas abiertas que se pueden cruzar con facilidad — no son «historias», son datos sin interpretación que la redacción puede vestir:

Cohesión media por grupo en la legislatura actual y comparación con anteriores (cuando tengamos cobertura histórica completa).
Aprobación por tema: qué bloques temáticos tienen más iniciativas aprobadas frente a rechazadas. Todos los temas, sin rankings.
Coincidencia entre parejas de grupos: matriz simétrica completa con el porcentaje de votos en que dos grupos votan en el mismo sentido.
Demografía por grupo: distribución por género y edad media de miembros activos. Todas las fuerzas visibles.
Asistencia agregada por grupo y diputado. Caveats claros para cargos institucionales (gobierno, mesa) donde la métrica no es comparable con el resto.

API REST y datasets

La API está documentada en /apidocs — endpoints REST públicos, paginación estable, JSON. Sin clave de API ni registro. Caché de 5 minutos en la capa Vercel + 1 hora en el backend.

Volúmenes altos de uso (> 100 req/min sostenidas) envíanos un correo antes de desplegar nada — así te avanzamos cuotas y preparamos el caché.

Licencias

Datos: CC-BY 4.0. Atribución a Hola Política y la fuente original (Congreso de los Diputados).
Código fuente: EUPL-1.2 — repositorio en github.com/Pardo24/holapolitica.
Widgets e imágenes OG: libres de uso editorial con la misma obligación de atribución.

Contacto editorial

Si tu redacción quiere un corte específico (por ejemplo, todas las votaciones de un partido en un trimestre, o la actividad por circunscripción), escríbenos y lo preparamos.

daniel@holapolitica.org