API v1.0 REST & Bulk Open Data

API y Datos Abiertos del Radar de Subvenciones

Auditoría automatizada y acceso programático a las concesiones de la Base de Datos Nacional de Subvenciones (BDNS). Diseñado para periodistas de investigación, analistas económicos y fiscalizadores cívicos del gasto público.

Especificación OpenAPI 3.1 Descargar Datasets

Total Auditado

17.6 mil M€

En fondos públicos fiscalizados

Beneficiarios

48.360

Entidades y particulares

Alertas Rojas

4749

Riesgo crítico o tope minimis

Ayudas a Dedo

3.5 mil M€

En concesiones directas

Descargas de Auditoría (Open Data)

Exportación de Datasets de Subvenciones

Descarga en streaming los datasets completos de beneficiarios auditados o de adjudicaciones BDNS individuales para análisis masivo en Excel, Python, R o bases de datos SQL.

Colección de Datos

Criterio de Filtrado

Descargar CSV

Formato:

BOM UTF-8 incluido para Microsoft Excel (evita problemas con acentos y eñes)

Guía Rápida de Consulta

Ejemplos listos para ejecutar en terminal o integrar en scripts de análisis automatizados.

# Consultar beneficiarios en ALERTA ROJA con concesiones directas
curl -s "https://sontusimpuestos.com/api/v1/subvenciones/beneficiarios?nivelAlerta=ALERTA_ROJA&soloDirectas=true&pageSize=10" \
  -H "Accept: application/json"

# Descargar directamente el dataset completo de concesiones en CSV (con BOM para Excel)
curl -s "https://sontusimpuestos.com/api/v1/subvenciones/descargas?tipo=concesiones&format=csv" -o concesiones_bdns.csv

Catálogo Oficial de Endpoints

Estructura RESTful estándar, respuestas en JSON con formato ApiResponse y paginación uniforme.

GET/api/v1/subvenciones/beneficiarios

Listado y auditoría de entidades

Búsqueda y filtrado de los más de 46.000 beneficiarios con soporte para banderas de riesgo, concesiones directas y acumulación de minimis.

Parámetro	Tipo	Descripción
q / nombre	string	Razón social o nombre (ej: `Constructora`).
nivelAlerta	string	`ALERTA_ROJA`, `ALERTA_NARANJA`, `ALERTA_AMARILLA`, `NORMAL`.
soloDirectas	boolean	Filtrar entidades con al menos una ayuda directa a dedo.
cercaMinimis	boolean	Filtrar entidades que rozan o superan el 80% del tope europeo (300.000 €).
page / pageSize	integer	Paginación (por defecto page 1, pageSize 20, máx 100).

GET/api/v1/subvenciones/beneficiarios/{id_persona}

Ficha monográfica e histórico

Devuelve la ficha consolidada de un beneficiario identificado por su id_persona (ej: 12345), incluyendo sus métricas de riesgo y el desglose de todas sus concesiones individuales recibidas.

GET/api/v1/subvenciones/concesiones

Concesiones BDNS individuales

Permite buscar y paginar entre las más de 72.000 concesiones registradas en la Base de Datos Nacional de Subvenciones. Soporta filtros por órgano convocante, importes, tipo de convocatoria (directa o concurrencia) y fechas.

GET/api/v1/subvenciones/concesiones/{id}

Ficha atómica de adjudicación

Detalle específico de una concesión concreta con código BDNS oficial, órgano concedente, instrumentos y bases reguladoras.

GET/api/v1/subvenciones/kpis

Indicadores consolidados

Métricas agregadas del dinero público auditado, recuentos de alertas por color, volumen de concesiones directas y casos en el límite de la normativa europea.

STREAM/api/v1/subvenciones/descargas

Exportación masiva (CSV, JSON, NDJSON)

Descarga en streaming directo sin límites de paginación. Permite volcar el censo completo de beneficiarios o el histórico de concesiones en segundos.

Transparencia Pública y Reutilización de Datos

Origen Oficial de la Información

Todos los datos expuestos proceden de la Base de Datos Nacional de Subvenciones (BDNS) gestionada por la Intervención General de la Administración del Estado (IGAE - Ministerio de Hacienda) y son de libre reutilización ciudadana bajo la Ley 37/2007.

Acceso Libre y Rate Limiting

El acceso es 100% público sin necesidad de registro ni API Key. Se aplica un límite preventivo de 60 peticiones por minuto por IP para preservar la disponibilidad del servicio.