Documentació · principis · cobertura

Sobre el projecte

Per què aquesta eina

A les democràcies representatives, els ciutadans no votem directament les lleis: deleguem aquesta decisió en les persones que triem cada quatre anys. El pacte funciona si podem veure què fan els nostres representants amb el mandat: quines lleis aproven, quines rebutgen, qui les proposa, com vota cada grup. Aquesta plataforma centralitza aquesta informació en un sol lloc, oberta i descarregable, perquè qualsevol ciutadà o periodista pugui seguir-ho sense navegar per portals oficials dispersos.

Què és Hola Política

Plataforma cívica oberta que centralitza les votacions, iniciatives i activitat parlamentària de les cambres espanyoles. Permet a periodistes i ciutadania consultar què ha votat cada diputat o grup, sense intermediaris ni interpretació política.

Principi: mirall, no megàfon

El projecte és infraestructura cívica neutra. No emet opinions ni valoracions sobre les votacions: només dades verificables. Les mètriques comparatives entre grups o diputats sempre es mostren completes (totes les parelles, els dos extrems del rang) per evitar narratives unilaterals.

API pública

Tota la informació que veus aquí és accessible per a periodistes, investigadors i la ciutadania a través d'una API REST documentada. Sense claus, sense registre, sense límits arbitraris. Les dades es publiquen sota CC-BY 4.0.

GET /docsDocumentació interactiva (Swagger UI)
GET /redocDocumentació alternativa (ReDoc)
GET /openapi.jsonEspecificació OpenAPI (JSON, llegible per màquina)

Volcats massius en JSON

Per a anàlisi acadèmica i periodisme de dades, exposem endpoints de volcat que retornen un dataset complet d'una sola petició:

GET /dump/deputies?legislature_id=1
Diputats actius d'una legislatura amb el seu grup i circumscripció.
```
curl 'https://api.holapolitica.org/dump/deputies?legislature_id=1'
```
GET /dump/votes?legislature_id=1&from=2024-01-01&to=2024-12-31
Totes les votacions d'una legislatura amb els resultats agregats (Sí/No/Abst/Absent). Filtre opcional per dates.
```
curl 'https://api.holapolitica.org/dump/votes?legislature_id=1&from=2024-01-01&to=2024-12-31'
```
GET /dump/vote-records?vote_id=42
Vot individual de cada diputat en UNA votació concreta (es passa l'identificador). Es separa per evitar baixades de centenars de milers de registres en una sola petició.
```
curl 'https://api.holapolitica.org/dump/vote-records?vote_id=42'
```
GET /dump/initiatives?legislature_id=1
Totes les iniciatives d'una legislatura amb la seva classificació temàtica.
```
curl 'https://api.holapolitica.org/dump/initiatives?legislature_id=1'
```

Quotes

Sense límits durs avui. Demanem que els consumidors mantinguin un ritme raonable. Per a càrregues massives recurrents o ús acadèmic intensiu, contacteu-nos per coordinar còpies dels dumps periòdics.

Cobertura

Fase 1 — Congrés dels Diputats (XV legislatura) — actiu.
Fase 2 — Parlament de Catalunya — proper.
Fase 3 — Plenari del Consell Municipal de Barcelona — proper.

Què vol dir cada cosa

El llenguatge parlamentari és tècnic. Aquí tens els termes que veuràs més sovint, en un llenguatge planer.

Proyecto de Ley: Llei proposada pel Govern. Si s'aprova, esdevé llei vigent. És la via principal per la qual el Govern legisla.
Proposición de Ley: Llei proposada per un grup parlamentari (no pel Govern). Si s'aprova, esdevé llei vigent.
Proposición no de Ley (PNL): Proposta NO vinculant. Demana al Govern que faci alguna cosa, però no canvia la llei. Si s'aprova, és un mandat polític sense força legal directa. Són les votacions més freqüents al ple.
Real Decreto-ley (RDL): Norma amb força de llei dictada pel Govern per urgència. El Congrés ha de convalidar-la (acceptar-la) o derogar-la (anul·lar-la) en 30 dies.
Moció consecuencia d'interpel·lació: Després d'una pregunta urgent al Govern (interpel·lació), un grup pot presentar una moció demanant una posició concreta. Vinculant políticament, no jurídicament.
Convalidación / Derogación: Decisió del Congrés sobre un RDL del Govern: convalidar és acceptar-lo, derogar és anul·lar-lo.
Cohesió interna: % de membres d'un grup que voten igual. Una cohesió del 100% vol dir disciplina total de vot; números més baixos, més votacions creuades.
Coincidència entre grups: % de votacions on dos grups van votar el mateix sentit (Sí, No o Abstenció).

Llicència i contribució

Codi sota EUPL-1.2. Dades sota CC-BY 4.0. El projecte és open source i les contribucions són benvingudes.