Para desarrolladores, periodistas y proyectos cívicos

API pública

API gratuita de solo lectura con los datos parlamentarios de esta web: votaciones de leyes del Congreso de los Diputados, diputados, grupos, histórico 2011–2023 y próximas votaciones. Sin registro ni clave.

Base URL:

https://www.elcongresoentumano.es/api/public/v1

Métodos: GET y OPTIONS. Sin autenticación.
CORS abierto (Access-Control-Allow-Origin: *), usable desde navegadores.
Caché: 1 hora (5 minutos en /health y /proximas).
Errores: 400 parámetro inválido, 404 no encontrado. Cuerpo: { "error": "mensaje" }.

Estado del servicio

GET/health

Comprueba que la API responde y hasta qué fecha llegan los datos (campo version).

{ "ok": true, "legislatura": "XV", "version": "2026-09-16", "diputados": 412, "votaciones": 90 }

Diputados y diputadas

Directorio completo de la Legislatura XV con alias para buscar por nombre. Los identificadores son propios del proyecto, no los del portal del Congreso.

GET/diputados

Índice completo (412 personas) con alias, grupo, circunscripción, foto y enlace a la ficha. Pensado para cachear en el cliente y buscar en local.

GET/diputados/lookup?q=Pedro%20Sánchez&limit=5

Búsqueda por nombre o alias. Devuelve candidatos ordenados por score con nivel de confianza.

Parámetros: q (obligatorio), limit 1–10 (por defecto 5)

GET/diputados/{id}/preview

Resumen ligero: foto, grupo, tendencia agregada de voto y los 5 votos más recientes.

GET/diputados/{id}?limit=20&offset=0&voto=no

Ficha completa: datos, biografía, tendencia y lista de votos paginada.

Parámetros: limit 1–100 (por defecto 20), offset, voto = si | no | abstencion | ausente

Votaciones (Legislatura XV, 2023–hoy)

GET/votaciones?q=vivienda&categoria=vivienda&aprobada=true&desde=2025-01-01&hasta=2026-12-31&limit=20&offset=0

Lista paginada de votaciones de leyes y decretos, más recientes primero, con totales y voto mayoritario de cada grupo. Todos los filtros son opcionales.

Parámetros: q, categoria, aprobada (true/false), desde, hasta, limit, offset

GET/votaciones/{id}?diputadoId=310

Detalle: título oficial y popular, resumen, qué propone, totales y desglose por grupo. Con diputadoId añade el voto de esa persona.

Parámetros: diputadoId (opcional)

GET/categorias

Temas válidos para el filtro categoria y cuántas votaciones tiene cada uno.

Grupos parlamentarios

GET/partidos

Lista de grupos de la Legislatura XV.

GET/partidos/{slug}

Ficha de un grupo: diputados, tendencia por tema, % de coincidencia con otros grupos y todas sus votaciones. El slug es el de la web (psoe, pp, vox, sumar…).

Histórico 2011–2023

Legislaturas X, XI, XII y XIV.

GET/historico

Legislaturas disponibles con número de votaciones.

GET/historico/{legislatura}

Lista de votaciones de una legislatura. Admite los mismos filtros que /votaciones.

GET/historico/{legislatura}/{id}

Detalle con el voto nominal de cada diputado o diputada.

Próximas votaciones

GET/proximas?todas=1

Votaciones anunciadas o pendientes de resultados. Estado: prevista | pendiente | votada | publicada. Sin todas=1 excluye las ya publicadas. Caché de 5 minutos.

Parámetros: todas=1 (opcional)

Ejemplos

curl -s "https://www.elcongresoentumano.es/api/public/v1/health"curl -s "https://www.elcongresoentumano.es/api/public/v1/diputados/lookup?q=Pedro%20S%C3%A1nchez"curl -s "https://www.elcongresoentumano.es/api/public/v1/votaciones?categoria=vivienda&limit=5"curl -s "https://www.elcongresoentumano.es/api/public/v1/proximas"

Qué datos son y qué no son

Solo Congreso y solo votaciones de conjunto de leyes y decretos; no hay mociones ni Senado.
Los datos de votos y resultados son oficiales; los nombres populares, resúmenes e impactos son elaboración propia con ayuda de IA: orientativos, no texto legal.
El dataset se actualiza a mano; el campo version de /health indica hasta qué fecha llega.

Enlaces profundos estables

/diputado/{id} — ficha de diputado (Legislatura XV)
/ley/{id} — ficha de votación (Legislatura XV)
/partido/{slug} — ficha de grupo parlamentario
/historico/{legislatura}/{id} — votaciones 2011–2023

Para agentes (MCP)

Además de la API REST, la web expone un servidor MCP en /mcp con las herramientas buscar_leyes, detalle_ley, buscar_diputados, votos_diputado, perfil_partido e impacto_perfil. Instrucciones para conectarlo a Claude, ChatGPT, Cursor o VS Code en Úsalo con tu IA.

¿La usas en un proyecto o echas algo en falta? Escríbenos a ivo@commitsans.com.