Spain Grants Registries Scraper (BDNS) · Registros especiales de subvenciones

Extrae tres registros especiales de la Base de Datos Nacional de Subvenciones (BDNS / SNPSAP), el registro oficial del Ministerio de Hacienda (IGAE): grandes beneficiarios, sanciones por fraude en subvenciones y ayudas a partidos políticos.

Scrapes three special BDNS registers: top grant recipients, subsidy-fraud sanctions, and political party grants — public, official, and otherwise scattered across individual PDF reports.

---

🇪🇸 Español

Qué obtienes

grandes_beneficiarios — el ranking oficial de mayores perceptores de ayuda pública, agregado por año (un beneficiario puede tener una fila por ejercicio). Ordenado de mayor a menor ayuda total por defecto:

Campo	Qué es
nif, razonSocial	Beneficiario ya separado
ejercicio	Año del agregado
ayudaETotal	Ayuda total recibida ese año, en euros

sanciones — empresas y personas sancionadas por fraude en subvenciones (art. 58 de la Ley General de Subvenciones y similares), con la multa y el periodo de inhabilitación para recibir nuevas ayudas:

Campo	Qué es
nif, razonSocial	Sancionado
infraccion	Artículo/motivo de la sanción
importe	Importe de la subvención de origen
importeMulta	Cuantía de la multa
inicioInhabilitacion, finInhabilitacion	Periodo sin poder recibir ayudas públicas

partidos_politicos — subvenciones a partidos, federaciones y grupos municipales/autonómicos (misma forma que concesiones de spain-grants-bdns, pero acotado a este colectivo):

Campo	Qué es
nif, razonSocial	Partido o grupo
importe, ayudaEquivalente	Cuantía en euros
fechaConcesion	Fecha de la concesión
administracion, organoNivel3	Quién concede

Para qué se usa

• Screening de contraparte / due diligence: comprobar si una empresa está en el registro de sanciones antes de firmar un contrato o una operación.
• Inteligencia competitiva: quiénes son los mayores perceptores de ayuda pública en España, año a año.
• Transparencia y periodismo de datos: financiación pública de partidos políticos por administración y ejercicio.

Parámetros de entrada

Parámetro	Tipo	Por defecto	Descripción
registro	grandes_beneficiarios | sanciones | partidos_politicos	grandes_beneficiarios	Qué registro se extrae
keywords	lista de textos	[]	Ver soporte por registro más abajo
fechaDesde	fecha AAAA-MM-DD	—	Solo sanciones y partidos_politicos
maxItems	entero	200	Tope de ítems
includePersonalData	booleano	false	Ver protección de datos, más abajo

Soporte de filtros: desigual entre registros (verificado en fase 5)

La API de BDNS no ofrece los mismos filtros en los tres registros:

Registro	keywords (texto)	fechaDesde
grandes_beneficiarios	En cliente (el servidor lo ignora — verificado: totalElements no cambia)	No aplica (agregado anual, sin fecha de concesión)
sanciones	En servidor	En servidor
partidos_politicos	En servidor	En servidor

Para grandes_beneficiarios el actor recorre las páginas (ordenadas por ayudaETotal descendente) y filtra por nombre/NIF en local: puede tardar algo más si buscas un término poco frecuente.

Un aviso honesto sobre sanciones

El registro nacional de sanciones por fraude en subvenciones es muy pequeño: en la verificación de fase 5 (23-ago-2026) contenía 4 filas en total en toda España (2 empresas sancionadas, con 2 infracciones cada una). Es un dato real, no un fallo del actor — la Ley General de Subvenciones reserva esta sanción a un supuesto concreto (falsear las condiciones para obtener la subvención) y son pocos los casos que llegan a esa vía. Si tu caso de uso necesita volumen garantizado, usa grandes_beneficiarios o partidos_politicos, que tienen decenas de miles de filas.

Protección de datos: personas físicas fuera por defecto

Igual que en el resto del lote: con includePersonalData: false (el valor por defecto) se excluyen los beneficiarios/sancionados que son personas físicas. La clasificación es fail-closed: en grandes_beneficiarios esto también excluye, por precaución, a algunas entidades internacionales cuyo código no sigue el formato NIF español (se pierden aunque no sean realmente personas físicas, porque no se pueden confirmar como persona jurídica con certeza).

Fuente y aviso legal

• Fuente oficial: BDNS / SNPSAP, IGAE, Ministerio de Hacienda — https://www.pap.hacienda.gob.es/bdnstrans/api/.
• Solo lectura de datos públicos, sin login ni token, ~1 petición/segundo, User-Agent identificado. No es un producto oficial ni está afiliado con IGAE ni con el Ministerio de Hacienda.
• Marco: Ley 38/2003 General de Subvenciones y Ley 37/2007 de reutilización de la información del sector público. Reutilización sujeta al aviso legal del SNPSAP.
• Los datos son dinámicos y pueden corregirse tras la extracción.

---

🇬🇧 English

What it does

spain-grants-registries scrapes three special BDNS registers:

• grandes_beneficiarios — the official ranking of top public-aid recipients, aggregated per year, sorted by total aid descending.
• sanciones — companies/individuals sanctioned for subsidy fraud, with the fine amount and disqualification period.
• partidos_politicos — grants to political parties and municipal/ regional party groups.

Filter support differs by register (verified in phase 5)

Register	keywords	fechaDesde
grandes_beneficiarios	Client-side (server ignores it)	Not applicable (annual aggregate)
sanciones	Server-side	Server-side
partidos_politicos	Server-side	Server-side

An honest note on sanciones

The national subsidy-fraud sanctions register is very small: at verification time (2026-08-23) it held 4 rows nationwide (2 sanctioned companies). That's real data, not a bug — the underlying legal provision covers one specific fraud scenario. Use grandes_beneficiarios or partidos_politicos if you need guaranteed volume.

GDPR: individual beneficiaries excluded by default

includePersonalData: false (default) removes individual/natural-person beneficiaries, fail-closed. In grandes_beneficiarios this also drops some foreign entities whose ID doesn't follow the Spanish NIF format, since they can't be confirmed as legal entities with certainty.

Input

Field	Type	Default	Notes
registro	enum	grandes_beneficiarios	Which register
keywords	string list	[]	Server-side for sanciones/partidos_politicos, client-side for grandes_beneficiarios
fechaDesde	ISO date	—	sanciones/partidos_politicos only
maxItems	integer	200	Hard cap
includePersonalData	boolean	false	See GDPR section

Disclaimer

Data from the official BDNS/SNPSAP API (IGAE, Spanish Ministry of Finance). Not an official product, not affiliated with or endorsed by IGAE. Rate-limited to ~1 request/second with an identifying User-Agent. Reuse subject to the SNPSAP legal notice and Spanish Law 37/2007.

---

Palabras clave / Keywords: grandes beneficiarios, sanciones subvenciones, partidos políticos financiación, BDNS, due diligence, fraude en subvenciones, inhabilitación ayudas públicas, top grant recipients Spain, subsidy fraud sanctions, political party funding Spain, compliance, screening de contraparte, transparencia, datos abiertos España.