Spain Grants & Subsidies Scraper (BDNS) · Subvenciones y ayudas públicas de España

Extrae convocatorias de subvenciones y concesiones ya otorgadas de la Base de Datos Nacional de Subvenciones (BDNS / SNPSAP), el registro oficial del Ministerio de Hacienda (IGAE) donde por ley se publica toda subvención pública española: estatal, autonómica y local.

Scrapes Spanish public grants, subsidies and grant beneficiaries from Spain's official National Subsidies Database (BDNS) — every state, regional and municipal grant call and every awarded grant, with amounts and recipients.

---

🇪🇸 Español

Qué obtienes

Modo convocatorias — la pregunta de negocio: «¿a qué ayudas puede optar mi empresa este mes?». Un ítem por convocatoria, con la ficha oficial completa:

Campo	Qué es
codigoBDNS	Identificador oficial de la convocatoria
titulo / tituloLenguaCooficial	Título en castellano y en lengua cooficial
administracion, organoNivel1/2/3	Quién convoca, por niveles (ESTATAL / AUTONÓMICA / LOCAL → CCAA u organismo → órgano concreto)
presupuestoTotal	Dotación en euros, como número (no como texto)
tipoConvocatoria	Concurrencia competitiva, concesión directa…
instrumentos, tiposBeneficiarios	Tipo de ayuda y a quién va dirigida
sectores, sectoresCnae	Sectores económicos con código CNAE
regiones	Ámbito territorial con código NUTS
fechaInicioSolicitud, fechaFinSolicitud, abierta	Plazo de solicitud y si sigue abierta
descripcionBasesReguladoras, urlBasesReguladoras	Bases reguladoras y su enlace oficial
documentos[]	PDFs oficiales de la convocatoria, con URL de descarga
financiadoMrr, fondos, ayudaEstado	Fondos europeos / Plan de Recuperación / ayuda de Estado
urlFicha, urlApi	Enlace a la ficha pública y al registro de origen

Modo concesiones — la pregunta de negocio: «¿quién ha cobrado subvenciones y cuánto?». Un ítem por concesión:

Campo	Qué es
nif, razonSocial	Beneficiario ya separado en NIF/CIF y denominación
tipoBeneficiario	juridica / fisica / desconocido
importe, ayudaEquivalente	Cuantía concedida en euros, como número
fechaConcesion	Fecha de la concesión
codigoBDNSConvocatoria, tituloConvocatoria	Convocatoria de la que procede
administracion, organoNivel1/2/3	Órgano concedente
urlBasesReguladoras	Bases reguladoras (BOE, boletín autonómico…)

Para qué se usa

• Alertas comerciales: detectar cada mañana las ayudas nuevas de tu sector (CNAE) y tu comunidad autónoma antes que la competencia.
• Consultoría de subvenciones: alimentar un buscador propio de convocatorias abiertas con presupuesto, plazo y bases reguladoras.
• Inteligencia competitiva: ver qué empresas de tu sector han cobrado ayudas públicas, de qué organismo y por cuánto.
• Enriquecimiento de CRM: cruzar el nif de las concesiones con tu base de clientes o de leads.
• Investigación y periodismo de datos: seguimiento del gasto público en subvenciones por órgano, territorio y sector.

Parámetros de entrada

Parámetro	Tipo	Por defecto	Descripción
mode	convocatorias | concesiones	convocatorias	Qué se extrae
keywords	lista de textos	[]	Una búsqueda por término, sobre el título. Vacío = sin filtro
soloAbiertas	booleano	true	Solo convocatorias con plazo abierto (solo modo convocatorias)
fechaDesde	fecha AAAA-MM-DD	—	Solo registros a partir de esa fecha. Es la forma de hacer ejecuciones incrementales diarias
maxItems	entero	200	Tope de ítems; el actor para limpiamente al alcanzarlo
includePersonalData	booleano	false	Ver más abajo

Ejemplo:

{
  "mode": "convocatorias",
  "keywords": ["innovación", "digitalización"],
  "soloAbiertas": true,
  "fechaDesde": "2026-08-01",
  "maxItems": 200
}

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

Las concesiones de la BDNS incluyen beneficiarios que son personas físicas (la fuente publica su nombre y su DNI parcialmente enmascarado). Con includePersonalData: false — el valor por defecto — el actor los excluye por completo: el dataset contiene solo empresas, asociaciones, comunidades de propietarios y administraciones.

La clasificación usa la letra inicial del NIF según las reglas de la AEAT (dígito = DNI, X/Y/Z = NIE, K/L/M = otros supuestos de persona física, * = NIF enmascarado por la propia fuente) y es fail-closed: si un identificador no se puede clasificar con certeza, se descarta.

Si activas includePersonalData, el dataset incluirá datos personales y pasas a ser tú quien responde de su tratamiento conforme al RGPD y la LOPDGDD.

Cuánto tarda

El actor respeta un máximo de ~1 petición por segundo contra la API oficial.

• concesiones: 100 ítems por petición → ~1 s por cada 100 ítems.
• convocatorias: el listado no trae la ficha completa, así que hay una petición de detalle por convocatoria → ~1 s por ítem. Con soloAbiertas: true se descargan también las fichas de las cerradas para poder descartarlas (la API oficial no ofrece filtro de estado), así que cuenta con varias peticiones por ítem guardado.

Fuente y aviso legal

• Fuente oficial: Sistema Nacional de Publicidad de Subvenciones y Ayudas Públicas (BDNS), Intervención General de la Administración del Estado (IGAE), Ministerio de Hacienda — https://www.pap.hacienda.gob.es/bdnstrans/api/.
• Este actor solo lee datos públicos, sin login, sin cookies, sin token y sin saltarse ninguna medida técnica. No es un producto oficial ni está afiliado, respaldado ni verificado por la IGAE ni por el Ministerio de Hacienda.
• Marco: Ley 38/2003 General de Subvenciones (art. 20, publicidad) y Ley 37/2007 de reutilización de la información del sector público. La reutilización está sujeta al aviso legal del SNPSAP.
• La propia API advierte de que los datos son dinámicos y pueden corregirse o eliminarse después de la extracción: para decisiones con efectos jurídicos, consulta siempre la ficha oficial (urlFicha).
• La Administración se reserva restringir el acceso a la API «ante situaciones de manifiesto abuso». Por eso este actor limita su ritmo a ~1 req/s y se identifica con un User-Agent propio. No modifiques ese comportamiento.
• Comprueba que tu caso de uso cumple la normativa aplicable antes de redifundir los datos.

---

🇬🇧 English

What it does

spain-grants-bdns is a Spain grants scraper for the official BDNS (Base de Datos Nacional de Subvenciones), the national register where every Spanish public subsidy must legally be published.

Two modes:

• convocatorias (grant calls) — open and past grant calls / funding opportunities: awarding body, total budget in EUR, application window, eligible beneficiary types, CNAE economic sectors, NUTS regions, regulatory basis URL and official PDFs.
• concesiones (awarded grants) — grant beneficiaries: tax ID (NIF/CIF), legal name, amount awarded, award date, awarding body and source grant call.

Typical use cases

• Grant intelligence / funding alerts: daily monitoring of new Spanish public subsidies by keyword, sector and region.
• Subsidy consultancies: powering a searchable database of open calls.
• Competitive intelligence: which companies received public money, from whom, and how much.
• B2B data enrichment: matching nif (Spanish company tax ID) against your CRM.
• Data journalism and public-spending research.

Input

Field	Type	Default	Notes
mode	enum	convocatorias	convocatorias or concesiones
keywords	string list	[]	One search per term (title match)
soloAbiertas	boolean	true	Open calls only (convocatorias mode)
fechaDesde	ISO date	—	Records from this date on; use it for incremental daily runs
maxItems	integer	200	Hard cap; the actor stops cleanly
includePersonalData	boolean	false	See below

GDPR: individual beneficiaries excluded by default

Spanish grant awards include natural persons. With the default includePersonalData: false, the actor removes every individual beneficiary, keeping only companies, associations and public bodies. Classification follows Spanish tax-ID rules and is fail-closed: anything that cannot be confirmed as a legal entity is dropped. Enabling the flag means you become responsible for the personal data under GDPR.

Politeness & compliance

The actor is rate-limited to ~1 request/second, sends an identifying User-Agent that contains no personal data, retries with exponential backoff, and never bypasses any authentication or technical protection measure. It only reads openly published public-sector data.

Disclaimer

Data comes from the official BDNS/SNPSAP API operated by IGAE (Spanish Ministry of Finance). This actor is not an official product and is not affiliated with or endorsed by IGAE or the Ministry. Data is dynamic and may be corrected or removed after extraction — for legally binding decisions, always check the official record linked in urlFicha. Reuse is subject to the SNPSAP legal notice and to Spanish Law 37/2007 on the re-use of public sector information. Make sure your use case complies with applicable law before redistributing the data.

---

Palabras clave / Keywords: subvenciones, ayudas públicas, BDNS, convocatorias de subvenciones, concesiones, beneficiarios de subvenciones, SNPSAP, infosubvenciones, ayudas a empresas, subvenciones España, Spain grants, Spanish subsidies, public grants Spain, grant beneficiaries, subsidy database, government funding Spain, open data Spain, CNAE, NUTS, NIF.