Per a redaccions

Eines llestes per a periodistes

Quatre maneres d'incorporar el que vota el Congrés en una peça: widgets responsius, cards socials, API REST i descàrregues directes. Tot CC-BY 4.0 — només cal citar Hola Política i la font original (Congreso de los Diputados).

Widgets per a articles

Cada widget és un <iframe> de menys d'un segon de càrrega, sense cookies de tercers, amb enllaç a la font original. Copia el fragment i enganxa'l al CMS.

Resultat d'una votació

Totals (Sí · No · Abst. · Absents), barra apilada, propietat institucional + enllaç a la fitxa.

Fragment HTML

<iframe
  src="https://holapolitica.org/embed/votes/1829"
  width="100%" height="320" frameborder="0"
  loading="lazy"
  title="Votació al Congrés — Hola Política"
></iframe>

Fitxa de grup parlamentari

Cohesió mitjana, vots emesos i mida del grup. Mateix patró visual per a totes les forces.

Fragment HTML

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

Tema · distribució d'iniciatives

Per a un tema concret: quantes iniciatives s'han aprovat, rebutjat o estan en tràmit.

Fragment HTML

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

Tots els slugs (grup, tema) i identificadors (vot, persona) són els de la nostra base de dades. Pots trobar-los a /votes, /groups, /topics o /persons.

Cards socials (Open Graph)

Cada votació, iniciativa, grup o persona té una imatge OG 1200×630 que es genera automàticament. Quan compartiu un enllaç de Hola Política a Bluesky, X o LinkedIn, la previsualització ja inclou el resultat de la votació o la fitxa del diputat — sense haver de fer cap muntatge.

https://holapolitica.org/api/og/vote/1829
https://holapolitica.org/api/og/group/gp-socialista
https://holapolitica.org/api/og/topic/habitatge
https://holapolitica.org/api/og/person/<id>

Idees de talls de dades

Aquestes són rutes obertes que es poden creuar amb facilitat — no són «històries», són dades sense interpretació que la redacció pot vestir:

Cohesió mitjana per grup a la legislatura actual i comparació amb anteriors (quan tinguem cobertura històrica completa).
Aprovació per tema: quins blocs temàtics tenen més iniciatives aprovades respecte rebutjades. Tots els temes, sense rànquings.
Coincidència entre parelles de grups: matriu simètrica completa amb el percentatge de vots on dos grups voten igual sentit.
Demografia per grup: distribució per gènere i edat mitjana de membres actius. Totes les forces visibles.
Assistència agregada per grup i diputat. Caveats clars per a càrrecs institucionals (govern, mesa) on la mètrica no és comparable amb la resta.

API REST i datasets

L'API està documentada a /apidocs — endpoints REST públics, paginació estable, JSON. Cap clau d'API ni registre. Cache de 5 minuts a la capa Vercel + 1 hora al backend.

Volums alts d'ús (> 100 req/min sostingudes) envieu-nos un correu abans de desplegar res — així us avancem quotes i preparem el caché.

Llicències

Dades: CC-BY 4.0. Atribució a Hola Política i la font original (Congreso de los Diputados).
Codi font: EUPL-1.2 — repositori a github.com/Pardo24/holapolitica.
Widgets i imatges OG: lliures d'ús editorial amb la mateixa obligació d'atribució.

Contacte editorial

Si la teva redacció vol un tall específic (per exemple, totes les votacions d'un partit en un trimestre, o l'activitat per circumscripció), escrivim-vos i ho preparem.

daniel@holapolitica.org