Spain Grants Scraper (BDNS) — Subvenciones y Ayudas

Scrape Spanish public grants and subsidies — subvenciones y ayudas públicas — from the BDNS (Base de Datos Nacional de Subvenciones), the official national register run by Spain's Ministry of Finance (IGAE), also known as SNPSAP. This BDNS scraper returns open grant calls with budget, CNAE sector, NUTS region and deadlines, plus awarded grants with the beneficiary's tax ID and the amount received.

Extrae convocatorias de subvenciones y concesiones ya otorgadas de la Base de Datos Nacional de Subvenciones (BDNS / SNPSAP), el registro oficial donde por ley se publica toda subvención pública española: estatal, autonómica y local. Convocatorias de ayudas públicas con presupuesto, plazo y bases reguladoras, y concesiones de subvenciones por NIF de beneficiario.

Spain Grants Scraper (BDNS): what it does · Qué hace este scraper de subvenciones

La BDNS es el registro donde la Ley 38/2003 obliga a publicar toda subvención pública española. Este actor la lee por su API oficial y la devuelve ya estructurada: presupuestos como números, sectores con código CNAE, ámbitos con código NUTS, beneficiarios con el NIF/CIF ya separado de la razón social. No es un buscador web: es la fuente primaria en JSON.

Two modes: convocatorias answers "which grants can my company apply for this month?", and concesiones answers "who received public money, from whom, and how much?".

Subvenciones data extracted: grant calls and awards · Qué datos extrae

Modo convocatorias — grant calls · Convocatorias abiertas

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

Campo / Field	Qué es / What it is
codigoBDNS	Identificador oficial de la convocatoria · Official call ID
titulo / tituloLenguaCooficial	Título en castellano y en lengua cooficial · Title, incl. co-official language
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) · Total budget in EUR
tipoConvocatoria	Concurrencia competitiva, concesión directa… · Award procedure
instrumentos, tiposBeneficiarios	Tipo de ayuda y a quién va dirigida · Aid instrument and eligible beneficiaries
sectores, sectoresCnae	Sectores económicos con código CNAE · Economic sectors
regiones	Ámbito territorial con código NUTS · Territorial scope
fechaInicioSolicitud, fechaFinSolicitud, abierta	Plazo de solicitud y si sigue abierta · Application window
descripcionBasesReguladoras, urlBasesReguladoras	Bases reguladoras y su enlace oficial · Regulatory basis
documentos[]	PDFs oficiales de la convocatoria, con URL de descarga · Official PDFs
financiadoMrr, fondos, ayudaEstado	Fondos europeos / Plan de Recuperación / ayuda de Estado · EU funds, MRR, state aid
urlFicha, urlApi	Enlace a la ficha pública y al registro de origen · Official record links

Modo concesiones — awarded grants · Concesiones por beneficiario

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

Campo / Field	Qué es / What it is
nif, razonSocial	Beneficiario ya separado en NIF/CIF y denominación · Tax ID and legal name
tipoBeneficiario	juridica / fisica / desconocido · Beneficiary type
importe, ayudaEquivalente	Cuantía concedida en euros, como número · Amount awarded
fechaConcesion	Fecha de la concesión · Award date
codigoBDNSConvocatoria, tituloConvocatoria	Convocatoria de la que procede · Source grant call
administracion, organoNivel1/2/3	Órgano concedente · Awarding body
urlBasesReguladoras	Bases reguladoras (BOE, boletín autonómico…) · Regulatory basis

BDNS scraper input: modes, filters and daily runs · Parámetros de entrada

Parámetro / Field	Tipo / Type	Por defecto / Default	Descripción / Notes
mode	convocatorias | concesiones	convocatorias	Qué se extrae · What to scrape
keywords	lista de textos	[]	Una búsqueda por término, sobre el título. Vacío = sin filtro · One search per term (title match)
soloAbiertas	booleano	true	Solo convocatorias con plazo abierto (solo modo convocatorias) · Open calls only
fechaDesde	fecha AAAA-MM-DD	—	Solo registros a partir de esa fecha. Es la forma de hacer ejecuciones incrementales diarias · Use it for incremental daily runs
maxItems	entero	200	Tope de ítems; el actor para limpiamente al alcanzarlo · Hard cap
includePersonalData	booleano	false	Ver protección de datos, más abajo · See GDPR section

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

Grants 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 concesiones (input { "mode": "concesiones", "keywords": [], "maxItems": 60 }; registros 1 y 2 de 60). Two real dataset items, copied verbatim from a live run:

{
  "tipoRegistro": "concesion",
  "id": 156142556,
  "codigoConcesion": "SB156142556",
  "fechaConcesion": "2026-08-21",
  "fechaAlta": "2026-08-23",
  "nif": "A13008339",
  "razonSocial": "FELIX SOLIS, S.A.",
  "tipoBeneficiario": "juridica",
  "importe": 13401.34,
  "ayudaEquivalente": 13401.34,
  "moneda": "EUR",
  "instrumento": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN",
  "tieneProyecto": false,
  "codigoBDNSConvocatoria": "667124",
  "idConvocatoria": 868684,
  "tituloConvocatoria": "Orden, de 27/12/2022, de la Consejería de Agricultura, Agua y Desarrollo Rural, por la que se precisan las bases reguladoras par",
  "tituloConvocatoriaCooficial": null,
  "administracion": "AUTONOMICA",
  "organoNivel1": "AUTONOMICA",
  "organoNivel2": "CASTILLA-LA MANCHA",
  "organoNivel3": "DIRECCIÓN GENERAL PRODUCCIÓN AGROALIMENTARIA Y COOPERATIVAS",
  "urlBasesReguladoras": "https://www.boe.es/boe/dias/2022/10/26/pdfs/BOE-A-2022-17475.pdf",
  "urlFichaConvocatoria": "https://www.infosubvenciones.es/bdnstrans/GE/es/convocatoria/667124",
  "fuente": "BDNS - Sistema Nacional de Publicidad de Subvenciones y Ayudas Publicas (IGAE)",
  "extraidoEn": "2026-08-23T15:24:53.662Z"
}

{
  "tipoRegistro": "concesion",
  "id": 156142555,
  "codigoConcesion": "SB156142555",
  "fechaConcesion": "2026-08-21",
  "fechaAlta": "2026-08-23",
  "nif": "B13347190",
  "razonSocial": "JOSE MARIA VILLASANTE, S.L.",
  "tipoBeneficiario": "juridica",
  "importe": 9600,
  "ayudaEquivalente": 9600,
  "moneda": "EUR",
  "instrumento": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN",
  "tieneProyecto": false,
  "codigoBDNSConvocatoria": "902087",
  "idConvocatoria": 1103648,
  "tituloConvocatoria": "Resolución de 24/04/2026, de la Dirección General de Empleo, por la que se publican los créditos disponibles en el ejercicio 2026 para la concesión de las subvenciones reguladas en el Decreto 103/2022, de 13 de septiembre. REG (UE) 2023/2831",
  "tituloConvocatoriaCooficial": null,
  "administracion": "AUTONOMICA",
  "organoNivel1": "AUTONOMICA",
  "organoNivel2": "CASTILLA-LA MANCHA",
  "organoNivel3": "DIRECCIÓN GENERAL DE EMPLEO",
  "urlBasesReguladoras": "https://docm.jccm.es/docm/descargarArchivo.do?ruta=2026/04/15/pdf/2026_2661.pdf&tipo=rutaDocm",
  "urlFichaConvocatoria": "https://www.infosubvenciones.es/bdnstrans/GE/es/convocatoria/902087",
  "fuente": "BDNS - Sistema Nacional de Publicidad de Subvenciones y Ayudas Publicas (IGAE)",
  "extraidoEn": "2026-08-23T15:24:53.674Z"
}

Nota: en esa ejecución, de 123 filas leídas se descartaron 63 por ser personas físicas (includePersonalData: false, el valor por defecto). In that run, 63 of 123 rows were dropped as natural persons by the default privacy filter.

Subvenciones use cases · Casos de uso

Alertas comerciales de ayudas · Grant intelligence and funding alerts

Detectar cada mañana las ayudas para empresas nuevas de tu sector (CNAE) y tu comunidad autónoma antes que la competencia, usando fechaDesde como puntero incremental.

Consultoría de subvenciones · Subsidy consultancies

Alimentar un buscador propio de convocatorias de ayudas públicas abiertas, con presupuesto, plazo, bases reguladoras y los PDFs oficiales.

Inteligencia competitiva · Competitive intelligence

Ver qué empresas de tu sector han cobrado ayudas públicas, de qué organismo y por cuánto — incluidas las financiadas con fondos europeos MRR.

Enriquecimiento de CRM · B2B data enrichment

Cruzar el nif de las concesiones con tu base de clientes o de leads.

Periodismo de datos · Data journalism and public-spending research

Seguimiento del gasto público en subvenciones por órgano, territorio y sector.

BDNS source, rate limits and run time · Fuente oficial, límites y cuánto tarda

• 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/.
• El actor respeta un máximo de ~1 petición por segundo contra la API oficial. Rate-limited to ~1 request/second.
• 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.
• El actor envía un User-Agent identificado que no contiene datos personales, reintenta con backoff exponencial y nunca salta una autenticación ni una medida técnica de protección. It only reads openly published public-sector data, and never bypasses any technical protection measure.

Related Spanish public-data Actors · Actores relacionados

Actor	Qué extrae / What it scrapes
spain-de-minimis-aid	BDNS: ayudas de minimis y ayudas de Estado por NIF, con reglamento UE y caso SA
spain-grants-registries	BDNS: grandes beneficiarios, sanciones por fraude y ayudas a partidos
spain-boe-monitor	BOE: monitor incremental por palabra clave, sección y NIF
spain-borme-companies	BORME: constituciones, nombramientos, ceses y concursos, campo a campo
spain-cadastre-bulk	Catastro: enriquecimiento masivo por referencia catastral o dirección
spain-bocm-gazette	BOCM: boletín oficial de la Comunidad de Madrid, en modo delta
spain-boja-gazette	BOJA: boletín oficial de la Junta de Andalucía, en modo delta
catalonia-tenders	Licitaciones y adjudicaciones públicas de Cataluña (PSCP)
euskadi-tenders	Anuncios de contratación pública del País Vasco
aragon-tenders	Registro de contratos públicos de Aragón (CKAN)

Is it legal? BDNS reuse, GDPR and personal data · Aviso legal y RGPD

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

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

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

• 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. This actor is not an official product and is not affiliated with or endorsed by IGAE or the Ministry.
• 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. Reuse is subject to the SNPSAP legal notice and to Spanish law on the re-use of public sector information.
• 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). For legally binding decisions, always check the official record.
• 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.

Spain grants scraper FAQ · Preguntas frecuentes

¿Cómo saco solo las convocatorias abiertas hoy?

mode: "convocatorias" con soloAbiertas: true (el valor por defecto). Ten en cuenta que, al no existir filtro de estado en la API oficial, el actor descarga también fichas de convocatorias cerradas para descartarlas.

¿Puedo ver cuánto ha cobrado una empresa concreta?

Sí, en mode: "concesiones": cada ítem trae nif y razonSocial ya separados. Para el histórico completo de ayudas de minimis y ayudas de Estado de un NIF, usa spain-de-minimis-aid.

¿Cómo hago ejecuciones diarias incrementales?

Con fechaDesde: pon la fecha de la última ejecución y solo recibirás los registros posteriores.

¿Incluye subvenciones a personas físicas? · Are individuals included?

No por defecto: se excluyen con includePersonalData: false. Si lo activas, asumes tú la responsabilidad RGPD del tratamiento.

¿Trae fondos europeos y Plan de Recuperación? · Does it flag EU funds?

Sí: los campos financiadoMrr, fondos y ayudaEstado de cada convocatoria.

¿Cubre subvenciones autonómicas y locales?

Sí. La BDNS es el registro nacional donde deben publicarse todas: estatales, autonómicas y locales. Los campos organoNivel1/2/3 dicen de qué nivel viene cada una.

¿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, concesiones es mucho más barato por ítem que convocatorias, por la petición de detalle que exige cada convocatoria.

Support and feedback · Soporte y sugerencias

¿Falta un campo, un filtro o un modo? ¿Necesitas una variante a medida (otro recorte de la BDNS, otro formato de salida, integración con tu almacén)? Abre un issue desde la pestaña Issues de esta ficha.

Missing a field, a filter or a mode? Open an issue from the Issues tab.

Palabras clave / Keywords: subvenciones España, BDNS scraper, Spain grants API, convocatorias de ayudas públicas, Spanish public subsidies data, ayudas para empresas, grant calls Spain, SNPSAP, concesiones de subvenciones por NIF, subsidy beneficiaries Spain, ayudas fondos europeos MRR, public funding Spain, infosubvenciones, CNAE, NUTS, NIF.