Documentación de la API REST Pública
Diseñada para desarrolladores, periodistas de datos, investigadores y analistas fiscales. Permite consultar, filtrar y vincular en tiempo real todos los acuerdos adoptados por el Consejo de Ministros de España mediante peticiones estándar GET HTTP.
Todos los acuerdos de un año completo
Filtra automáticamente todos los acuerdos adoptados a lo largo del año indicado.
Acuerdos de un año y mes concreto
Permite especificar el año y el mes deseado (calcula días bisiestos y fin de mes).
Período mensual en formato directo
Sintaxis compacta año-mes para consultas rápidas.
Rango de fechas libre
Permite consultar acuerdos entre cualquier fecha inicial y final.
Acuerdos del Ministerio de Defensa
Búsqueda estricta por ministerio, sin mezclar acuerdos de otros departamentos.
Acuerdos del Ministerio de Economía
Filtrado por slug o nombre común del ministerio.
Acuerdos de Hacienda
Consulta de acuerdos e inversiones promovidos por Hacienda.
Filtrar únicamente cuando es ministerio proponente principal
Excluye acuerdos donde el ministerio solo figura como co-proponente secundario.
Buscar subvenciones o acuerdos de Cruz Roja
Localiza acuerdos por palabra clave en título, resumen y entidades beneficiarias.
Buscar convenios y proyectos sobre Vacunas
Búsqueda transversal de salud, ciencia e investigación.
Buscar acuerdos con dotación en Teruel
Planes territoriales específicos o inversiones por provincia.
Buscar acuerdos combinando texto y año
Combina palabra clave y filtro temporal en una sola consulta.
Convenios con Correos
Filtra acuerdos vinculados a organismos públicos específicos.
Inversiones en Cooperación Internacional
Filtra acuerdos por el área temática de cooperación y acción exterior.
Inversiones transversales sin ministerio exclusivo
Acuerdos generales, fondos de contingencia o de Presidencia del Gobierno.
KPIs Globales del Observatorio
Métricas agregadas: total acuerdos, millones de euros acumulados y sesiones registradas.
Descarga de datos tabulares sin programar
Si no necesitas integrar la API y prefieres abrir y filtrar los acuerdos directamente en Excel, LibreOffice o scripts de análisis, visita el nuevo Centro de Descargas.
Guía de Parámetros para GET /api/v1/acuerdos
Combina los parámetros libremente mediante & en la URL.
| Parámetro | Tipo | Ejemplo | Descripción |
|---|---|---|---|
| year / año | number | year=2024 | Filtra acuerdos de un año completo. |
| month / mes | number (1-12) | month=10 | Utilizado junto con year para filtrar un mes concreto. |
| periodo | YYYY-MM | periodo=2024-03 | Filtra directamente por año y mes. |
| desde / hasta | YYYY-MM-DD | desde=2023-01-01 | Rango libre de fechas. |
| ministerio | slug | string | ministerio=defensa | Filtro estricto por ministerio (defensa, economia, hacienda, etc.). |
| q / buscar | string | q=cruz roja | Búsqueda libre por palabra clave en título, resumen y entidades. |
| organismo | slug | string | organismo=correos | Filtra acuerdos vinculados a organismos o entidades específicas. |
| tema | slug | string | tema=cooperacion | Filtra por área de política pública o temática de gasto. |
| page / pageSize | number | page=1&pageSize=20 | Paginación de resultados (máximo 100 por página). |