Spain De Minimis & State Aid Scraper — BDNS by NIF

Scrape de minimis aid and notified state aid in Spain from the BDNS (Base de Datos Nacional de Subvenciones), the official register run by the Ministry of Finance (IGAE), also known as SNPSAP. Every award comes with the beneficiary's tax ID (NIF/CIF), the amount, the EU regulation it was granted under and, for notified aid, the European Commission SA case number.

Extrae ayudas de minimis y ayudas de Estado notificadas a la UE desde la Base de Datos Nacional de Subvenciones (BDNS / SNPSAP). Pensado para due diligence y para el control de acumulación de ayudas públicas: cuánta ayuda acumulada ha recibido una empresa, bajo qué reglamento europeo y de qué organismo — información que no aparece en el balance.

De minimis aid Spain: what this BDNS scraper does · Qué hace

Dos registros, dos preguntas distintas. minimis son las ayudas concedidas 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. ayudas_estado son las ayudas notificadas a la Comisión como ayuda de Estado, no sujetas al límite de minimis, con su número de caso SA.xxxxxx y el enlace al registro europeo.

Two modes: aid under the EU de minimis regulation, and aid notified to the European Commission as state aid, including the case number.

De minimis & state aid data extracted · Qué datos extrae de la BDNS

Modo minimis — ayudas de minimis · EU de minimis regulation

Modo ayudas_estado — ayudas de Estado notificadas · Notified state aid

Mismos campos, más:

De minimis scraper input: modes, NIF search and filters · Parámetros de entrada

Ejemplo — histórico de ayudas de un beneficiario concreto / aid history for one beneficiary:

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

Consulta de ayudas por NIF: cómo funciona de verdad · NIF search, honestly

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.

BDNS's official API does not support server-side filtering by tax ID; passing the NIF as a parameter returns HTTP 400. This actor therefore does the nifs filter client-side, scanning recent pages bounded by maxPaginasEscaneadas (default 50 pages × 100 rows). Combine nifs with fechaDesde for a fast, tractable scan.

De minimis output example: real items from a real run · Ejemplo de output real

Dos ítems reales del dataset, copiados tal cual de una ejecución en modo ayudas_estado (input

{ "mode": "ayudas_estado", "keywords": ["innovacion"], "maxItems": 25 }

{
  "tipoRegistro": "ayudas_estado",
  "idConcesion": 155814736,
  "codigoConcesion": "SB155814736",
  "fechaConcesion": "2026-07-30",
  "fechaAlta": "2026-07-31",
  "nif": "B53904843",
  "razonSocial": "COMELZ ESPAÑA SL",
  "tipoBeneficiario": "juridica",
  "importe": 72843.75,
  "ayudaEquivalente": 72843.75,
  "moneda": "EUR",
  "reglamento": "REG (UE) 651/2014, DE 17 DE JUNIO, de exención de notificación",
  "instrumento": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN",
  "objetivo": "ART. 29 AYUDAS DE I+D+I. AYUDAS A LA INNOVACIÓN EN MATERIA DE PROCESOS Y ORGANIZACIÓN",
  "ayudaEstado": "SA.119292",
  "urlAyudaEstado": "https://competition-cases.ec.europa.eu/cases/SA.119292",
  "sectorActividad": null,
  "sectores": "46 - Comercio al por mayor",
  "sectorProducto": null,
  "region": "ES521 - Alicante / Alacant",
  "convocante": "AUTONOMICA COMUNITAT VALENCIANA AGENCIA VALENCIANA DE LA INNOVACIÓN",
  "codigoBDNSConvocatoria": "895064",
  "idConvocatoria": 1096625,
  "tituloConvocatoria": "Asimilación de tecnologías avanzadas y su difusión en el Sistema Valenciano de Innovación REG (UE) 651/2014",
  "urlFichaConvocatoria": "https://www.infosubvenciones.es/bdnstrans/GE/es/convocatoria/895064",
  "fuente": "BDNS - Sistema Nacional de Publicidad de Subvenciones y Ayudas Publicas (IGAE)",
  "extraidoEn": "2026-08-23T17:32:25.053Z"
}

{
  "tipoRegistro": "ayudas_estado",
  "idConcesion": 155814734,
  "codigoConcesion": "SB155814734",
  "fechaConcesion": "2026-07-30",
  "fechaAlta": "2026-07-31",
  "nif": "B13967567",
  "razonSocial": "YAHI CREACIONES, S.L.",
  "tipoBeneficiario": "juridica",
  "importe": 86461.88,
  "ayudaEquivalente": 86461.88,
  "moneda": "EUR",
  "reglamento": "REG (UE) 651/2014, DE 17 DE JUNIO, de exención de notificación",
  "instrumento": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN",
  "objetivo": "ART. 29 AYUDAS DE I+D+I. AYUDAS A LA INNOVACIÓN EN MATERIA DE PROCESOS Y ORGANIZACIÓN",
  "ayudaEstado": "SA.119292",
  "urlAyudaEstado": "https://competition-cases.ec.europa.eu/cases/SA.119292",
  "sectorActividad": null,
  "sectores": "15 - Industria del cuero y productos relacionados de otros materiales",
  "sectorProducto": null,
  "region": "ES521 - Alicante / Alacant",
  "convocante": "AUTONOMICA COMUNITAT VALENCIANA AGENCIA VALENCIANA DE LA INNOVACIÓN",
  "codigoBDNSConvocatoria": "895064",
  "idConvocatoria": 1096625,
  "tituloConvocatoria": "Asimilación de tecnologías avanzadas y su difusión en el Sistema Valenciano de Innovación REG (UE) 651/2014",
  "urlFichaConvocatoria": "https://www.infosubvenciones.es/bdnstrans/GE/es/convocatoria/895064",
  "fuente": "BDNS - Sistema Nacional de Publicidad de Subvenciones y Ayudas Publicas (IGAE)",
  "extraidoEn": "2026-08-23T17:32:25.086Z"
}

De minimis & state aid use cases · Casos de uso

Due diligence de M&A y crédito · Subsidy due diligence

Cuánta ayuda pública acumulada ha recibido una empresa (por NIF) y bajo qué reglamento — información que no aparece en el balance ni en el registro mercantil.

Cumplimiento del límite de minimis · De minimis threshold compliance

Verificar el histórico de ayudas de minimis de un beneficiario antes de conceder una nueva y arriesgarse a superar el tope del reglamento.

Inteligencia competitiva · Competitive intelligence

Qué empresas de tu sector reciben ayudas de Estado, de qué organismo y bajo qué objetivo (I+D+i, formación, inversión regional…).

Investigación y periodismo de datos · Public-money research

Trazar el dinero público por reglamento europeo, región NUTS y sector económico, con el enlace al caso SA de la Comisión.

BDNS source, rate limits and coverage · Fuente oficial y límites

• 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. Rate-limited to ~1 request/second with an identifying User-Agent.
• Volumen del pool completo: más de 4,3 millones de filas en minimis y más de 6,4 millones en ayudas de Estado — de ahí que la búsqueda por NIF necesite acotarse con fechaDesde o keywords.
• Los datos son dinámicos y pueden corregirse tras la extracción.

Related Spanish public-data Actors · Actores relacionados

Is it legal? GDPR and personal data in aid records · Aviso legal y protección de datos

Personas físicas fuera por defecto · Individual beneficiaries excluded by default

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). Enabling the flag means you become responsible for the personal data under GDPR.

Fuente, licencia y aviso legal · Source, licence and disclaimer

• No es un producto oficial ni está afiliado, respaldado ni verificado por la IGAE ni por el Ministerio de Hacienda. Not an official product, not affiliated with or endorsed by IGAE.
• 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. Reuse subject to the SNPSAP legal notice and Spanish Law 37/2007.
• Los datos son dinámicos y pueden corregirse tras la extracción: para decisiones con efectos jurídicos, consulta siempre la ficha oficial.

De minimis scraper FAQ · Preguntas frecuentes

¿Puedo consultar todas las ayudas de un NIF? · Can I look up aid by tax ID?

Sí, con nifs, pero el filtro es en cliente porque la API oficial no lo soporta en servidor. Combínalo con fechaDesde (y keywords si puedes) o sube maxPaginasEscaneadas.

¿Qué diferencia hay entre minimis y ayudas_estado?

minimis son ayudas bajo el reglamento de minimis, sin notificación individual a la Comisión. ayudas_estado son ayudas notificadas, con número de caso SA.xxxxxx y enlace al expediente europeo.

¿Sirve para comprobar el límite de acumulación de minimis?

Sirve para reunir el histórico publicado en la BDNS de un beneficiario. La decisión formal sobre el tope corresponde al órgano concedente, y los datos de la fuente son dinámicos: contrasta siempre con la ficha oficial.

¿Incluye ayudas a autónomos y particulares?

Solo si activas includePersonalData. Por defecto quedan fuera todas las personas físicas, que en este registro son una proporción alta (32-42 % en la muestra medida).

¿Trae el número de caso SA de la Comisión Europea?

Sí, en modo ayudas_estado: campos ayudaEstado y urlAyudaEstado.

¿Por qué mi búsqueda por NIF no devuelve nada?

Casi siempre porque el escaneo no ha llegado hasta ese beneficiario: el pool es de millones de filas. Amplía maxPaginasEscaneadas o acota con fechaDesde y keywords.

¿Cuánto cuesta ejecutarlo? · How much does it cost?

El modelo de precio aparece en la pestaña Pricing de esta misma ficha del Store. En consumo, una búsqueda por NIF sin keywords es el escenario más caro, porque obliga a escanear páginas hasta encontrar coincidencias.

Support and feedback · Soporte y sugerencias

¿Necesitas otro corte del registro, otro filtro o una integración a medida? Abre un issue desde la pestaña Issues de esta ficha.

Need another cut of the register, another filter or a custom integration? Open an issue from the Issues tab.

Palabras clave / Keywords: ayudas de minimis, de minimis aid Spain, state aid database Spain, ayudas de Estado España, BDNS de minimis, due diligence subvenciones, EU de minimis regulation data, consulta ayudas por NIF, acumulación de ayudas públicas, SA case number aid, subsidy compliance Spain, ayudas públicas empresa.