Spain De Minimis & State Aid Scraper (BDNS) · Ayudas de minimis y ayudas de estado

Extrae ayudas de minimis y ayudas de estado notificadas de la Base de Datos Nacional de Subvenciones (BDNS / SNPSAP), el registro oficial del Ministerio de Hacienda (IGAE). Pensado para due diligence: cuánta ayuda pública acumulada ha recibido una empresa, bajo qué reglamento europeo y de qué organismo.

Scrapes Spanish de minimis aid and notified state aid from the official National Subsidies Database (BDNS) — every award under the EU de minimis regulation or notified as state aid, with amounts, recipients and the legal basis (regulation / SA. case number).

---

🇪🇸 Español

Qué obtienes

Modo minimis — ayudas bajo el Reglamento (UE) de minimis (el instrumento más habitual para pymes, hasta el tope que marca cada reglamento sin necesidad de notificación individual a la Comisión Europea):

Campo	Qué es
nif, razonSocial	Beneficiario ya separado en NIF/CIF y denominación
tipoBeneficiario	juridica / fisica / desconocido
importe, ayudaEquivalente	Cuantía en euros, como número
reglamento	Reglamento europeo bajo el que se concede (p. ej. REG (UE) 2023/2831 de minimis, General)
fechaConcesion	Fecha de la concesión
convocante, tituloConvocatoria	Quién concede y de qué convocatoria procede
sectorActividad	Sector económico del beneficiario

Modo ayudas_estado — ayudas notificadas a la Comisión Europea como ayuda de estado (no sujetas al límite de minimis), con el número de caso:

Campo adicional	Qué es
ayudaEstado	Número de caso ante la Comisión Europea (SA.xxxxxx)
urlAyudaEstado	Enlace al registro de ayudas de estado de la UE
objetivo	Objetivo/base jurídica de la ayuda
region, sectores	Ámbito territorial y sectores económicos

Para qué se usa

• Due diligence de M&A / crédito: cuánta ayuda pública acumulada ha recibido una empresa (NIF) y bajo qué reglamento — información que no aparece en el balance.
• Cumplimiento del límite de minimis: verificar el histórico de ayudas de minimis de un beneficiario antes de conceder una nueva.
• Inteligencia competitiva: qué empresas de tu sector reciben ayudas de estado y de qué organismo.
• Investigación y periodismo de datos sobre ayudas públicas.

Parámetros de entrada

Parámetro	Tipo	Por defecto	Descripción
mode	minimis | ayudas_estado	minimis	Qué registro se extrae
nifs	lista de NIF/CIF	[]	Ver más abajo — filtro en cliente
keywords	lista de textos	[]	Una búsqueda por término, sobre el título de la convocatoria de origen
fechaDesde	fecha AAAA-MM-DD	—	Solo concesiones desde esa fecha
maxItems	entero	200	Tope de ítems
maxPaginasEscaneadas	entero	50	Solo con nifs sin keywords — ver más abajo
includePersonalData	booleano	false	Ver protección de datos, más abajo

Ejemplo — histórico de ayudas de un beneficiario concreto:

{
  "mode": "minimis",
  "nifs": ["B13347190"],
  "fechaDesde": "2025-01-01",
  "maxItems": 200
}

Búsqueda por NIF: cómo funciona de verdad

La API oficial de BDNS no permite filtrar por NIF en el servidor. Se comprobó en fase 5: pasar beneficiario=B13347190 (el NIF tal cual) devuelve HTTP 400 "El parámetro 'beneficiario' no tiene un formato correcto". El único filtro de beneficiario que funciona de verdad es beneficiario=<idPersona>, un identificador interno de la BDNS que no se puede conocer a partir del NIF sin buscarlo antes.

Por eso este actor implementa la búsqueda por nifs en cliente: recorre páginas recientes (ordenadas por fecha de concesión descendente) y descarta en local todo lo que no case con la lista de NIFs pedida. El parámetro maxPaginasEscaneadas (100 filas por página) acota ese recorrido para no escanear el pool completo — más de 4,3 millones de filas en minimis, más de 6,4 millones en ayudas de estado. Recomendación: combina nifs con fechaDesde (y opcionalmente keywords) para que el escaneo encuentre resultados rápido; si tu beneficiario tiene poca actividad reciente, sube maxPaginasEscaneadas.

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

Igual que en spain-grants-bdns: con includePersonalData: false — el valor por defecto — se excluyen los beneficiarios que son personas físicas (DNI/NIE, o NIF enmascarado por la propia fuente como ***2182**). En una muestra de 100 filas verificada en fase 5, el 32 % de minimis y el 42 % de ayudas de estado eran personas físicas enmascaradas — proporción alta, así que el filtro por defecto importa. La clasificación es fail-closed: cualquier identificador que no se pueda confirmar como persona jurídica se descarta (esto incluye algunos beneficiarios internacionales cuyo código no sigue el formato NIF español — se pierden por precaución, no por ser realmente personas físicas).

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-de-minimis-aid scrapes Spanish de minimis aid and notified state aid from the official BDNS (Base de Datos Nacional de Subvenciones), built for due diligence: how much cumulative public aid a company has received, under which EU regulation, from which body.

• minimis — aid under the EU de minimis regulation (the common instrument for SMEs, no individual notification to the European Commission required below the threshold).
• ayudas_estado — aid notified to the European Commission as state aid, including the case number (SA.xxxxxx).

NIF search: how it actually works

BDNS's official API does not support server-side filtering by tax ID. Passing the NIF as a parameter returns HTTP 400. The only working beneficiary filter uses an internal numeric ID that can't be derived from a NIF without looking it up first. This actor therefore does the nifs filter client-side: it scans recent pages (bounded by maxPaginasEscaneadas, default 50 pages × 100 rows) and drops anything that doesn't match. Combine nifs with fechaDesde (and optionally keywords) for a fast, tractable scan; raise maxPaginasEscaneadas for beneficiaries with little recent activity.

GDPR: individual beneficiaries excluded by default

Same policy as spain-grants-bdns: includePersonalData: false (default) removes every individual beneficiary. In a verified 100-row sample, 32% (minimis) and 42% (state aid) of beneficiaries were masked natural persons — a high share, so the default filter matters. Classification is fail-closed.

Input

Field	Type	Default	Notes
mode	enum	minimis	minimis or ayudas_estado
nifs	string list	[]	Client-side filter — see above
keywords	string list	[]	One search per term (grant-call title match)
fechaDesde	ISO date	—	Records from this date on
maxItems	integer	200	Hard cap
maxPaginasEscaneadas	integer	50	Only relevant for NIF search without keywords
includePersonalData	boolean	false	See GDPR section

Disclaimer

Data comes from the official BDNS/SNPSAP API operated by 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: ayudas de minimis, ayudas de estado, BDNS, due diligence, subvenciones España, state aid Spain, de minimis aid, SA case number, beneficiarios de ayudas públicas, NIF, CIF, compliance, reglamento de minimis, ayuda pública acumulada, cumulative state aid.