Subvenciones España (BDNS) — API de ayudas públicas en JSON

Busca convocatorias de subvenciones y ayudas públicas de España —estatales, autonómicas, locales y de otros organismos— directamente en la Base de Datos Nacional de Subvenciones (BDNS/SNPSAP) del Ministerio de Hacienda, a través de su API oficial abierta: más de 647.000 convocatorias registradas.

Sin scraping ni intermediarios. Cada ejecución consulta la fuente primaria en vivo y devuelve JSON limpio y normalizado: plazos de solicitud, presupuesto, tipos de beneficiario, sectores económicos, regiones, fondos europeos y enlaces a las bases reguladoras.

En una frase: convierte el buscador de infosubvenciones.es en datos estructurados que puedes automatizar, filtrar, exportar o conectar a una IA.

---

¿Qué es la BDNS?

La Base de Datos Nacional de Subvenciones es el registro oficial donde todas las administraciones públicas españolas están obligadas a publicar sus convocatorias de ayudas y subvenciones. Incluye:

• Estatal — ministerios y organismos del Gobierno de España.
• Autonómica — las 17 comunidades autónomas y las ciudades autónomas.
• Local — ayuntamientos, diputaciones, cabildos y consejos insulares.
• Otros organismos — universidades, cámaras de comercio, fundaciones públicas.

Es la misma fuente que alimenta el portal público infosubvenciones.es, pero consultada por API en lugar de a mano.

---

Para quién es este actor

Gestorías y asesorías

Monitoriza convocatorias nuevas y avisa a tus clientes antes que la competencia. Programa una ejecución diaria con region fijado a tu comunidad autónoma y combina soloAbiertas con soloConcurrencia para recibir únicamente lo que tus clientes pueden solicitar de verdad.

Consultoras de subvenciones

Rastrea convocatorias por sector, ámbito y ventana temporal. El campo presupuestoTotalEUR y la lista de tiposBeneficiarios permiten priorizar oportunidades sin abrir una sola ficha.

Agentes de IA y clientes MCP

Conecta el actor como herramienta MCP y pregunta en lenguaje natural: "¿qué ayudas a la digitalización hay abiertas en Asturias?". El JSON normalizado está pensado para que un modelo lo lea sin post-procesado.

Desarrolladores y equipos de datos

Datos de ayudas públicas en JSON estable, con API, webhooks e integraciones incluidas. Sin gestionar reintentos, paginación ni el formato de fechas de la administración.

---

Cómo buscar subvenciones paso a paso

1. Elige la operación buscar (por defecto).
2. Escribe en consulta una palabra que aparezca en el título de la convocatoria: digitalizacion, comercio, autonomos, rehabilitacion.
3. Acota con ambito (por ejemplo autonomica) y con fechaDesde / fechaHasta en formato dd/MM/yyyy.
4. Activa soloAbiertas si únicamente te interesan las que aún admiten solicitudes.
5. Ejecuta y descarga el dataset en JSON, CSV, Excel o consúmelo por API.

Para la ficha íntegra de una convocatoria concreta, usa la operación detalle con su código BDNS.

---

Parámetros de entrada

Operación buscar

Parámetro	Tipo	Descripción
consulta	texto	Palabras que deben aparecer en el título. Admite varios términos separados por comas para cubrir un mismo concepto. Los acentos se normalizan automáticamente. Vacío = las más recientes.
fechaDesde	dd/MM/yyyy	Fecha mínima de registro de la convocatoria.
fechaHasta	dd/MM/yyyy	Fecha máxima de registro de la convocatoria.
ambito	enum	estatal, autonomica, local, otros o todos.
region	enum	Comunidad o ciudad autónoma destinataria de la ayuda: asturias, galicia, madrid, cataluna… Filtro nativo de la API, sin coste extra. Vía API acepta varias separadas por comas.
soloAbiertas	booleano	Solo convocatorias con plazo de solicitud abierto. Implica consultar el detalle de cada candidata.
soloConcurrencia	booleano	Descarta las de concesión directa (convenios, subvenciones nominativas), que ya tienen beneficiario y nadie puede solicitar. Son la mayoría de lo publicado.
incluirDetalle	booleano	Añade presupuesto, plazos, beneficiarios, sectores y regiones a cada resultado.
maxResultados	1–200	Número máximo de convocatorias a devolver. Por defecto 20.

Operación detalle

Parámetro	Tipo	Descripción
numeroConvocatoria	texto	Código BDNS de la convocatoria, ej. 915898. Se obtiene del campo codigoBDNS de una búsqueda previa.

---

Datos que devuelve cada convocatoria

Siempre:

Campo	Descripción
codigoBDNS	Identificador oficial de la convocatoria.
titulo	Denominación de la convocatoria.
tituloCooficial	Título en lengua cooficial, si existe.
fechaRegistro	Fecha de alta en la BDNS (ISO yyyy-MM-dd).
administracion.ambito	ESTATAL, AUTONOMICA, LOCAL u OTROS.
administracion.organo	Administración convocante.
administracion.subOrgano	Consejería, concejalía o departamento.
financiadoMRR	Si está financiada por el Plan de Recuperación (fondos Next Generation).
urlFicha	Enlace directo a la ficha pública en infosubvenciones.es.

Con incluirDetalle o soloAbiertas activados, además:

Campo	Descripción
detalle.estadoPlazo	abierto, proximamente, cerrado o sin_plazo. Calculado a partir de las fechas, no leído del flag de la BDNS.
detalle.abierto	Atajo booleano: true solo si estadoPlazo es abierto.
detalle.abiertoSegunBDNS	El flag original de la API, conservado por transparencia. Es poco fiable (ver Límites conocidos).
detalle.plazoSolicitud	inicio, fin y las notas literales de plazo publicadas.
detalle.presupuestoTotalEUR	Dotación total de la convocatoria en euros.
detalle.tipoConvocatoria	Régimen: concurrencia competitiva, concesión directa, etc.
detalle.finalidad	Área de política de gasto.
detalle.instrumentos	Subvención, préstamo, garantía, ventaja fiscal…
detalle.tiposBeneficiarios	PYME, personas físicas, entidades sin ánimo de lucro…
detalle.sectores	Sectores económicos (CNAE) a los que se dirige.
detalle.regiones	Ámbito geográfico en códigos NUTS.
detalle.fondosEuropeos	FEDER, FSE+, FEADER, MRR…
detalle.urlBasesReguladoras	Enlace a las bases reguladoras.
detalle.sedeElectronica	Sede donde se tramita la solicitud.
detalle.numeroDocumentos	Número de documentos anexos publicados.

---

Ejemplo de salida

{
    "codigoBDNS": "916969",
    "titulo": "Convocatoria de subvenciones destinadas a la mejora de la competitividad, innovación y digitalización del pequeño y mediano comercio",
    "fechaRegistro": "2026-07-02",
    "administracion": {
        "ambito": "AUTONOMICA",
        "organo": "PRINCIPADO DE ASTURIAS",
        "subOrgano": "CONSEJERÍA DE CIENCIA, EMPRESAS, FORMACIÓN Y EMPLEO"
    },
    "financiadoMRR": false,
    "urlFicha": "https://www.infosubvenciones.es/bdnstrans/GE/es/convocatoria/916969",
    "detalle": {
        "estadoPlazo": "abierto",
        "abierto": true,
        "abiertoSegunBDNS": false,
        "plazoSolicitud": { "inicio": "2026-07-10", "fin": "2026-09-10", "notaInicio": null, "notaFin": null },
        "presupuestoTotalEUR": 500000,
        "tipoConvocatoria": "Concurrencia competitiva - canónica",
        "tiposBeneficiarios": ["PYME Y PERSONAS FÍSICAS QUE DESARROLLAN ACTIVIDAD ECONÓMICA"],
        "sectores": ["COMERCIO AL POR MENOR"],
        "regiones": ["ES12 - PRINCIPADO DE ASTURIAS"]
    }
}

---

Recetas listas para copiar

Ayudas a la digitalización abiertas, cubriendo los dos nombres con que se publican

{ "operacion": "buscar", "consulta": "digitalizacion, transformacion digital", "soloAbiertas": true, "maxResultados": 50 }

Todo lo que tus clientes pueden solicitar hoy en tu comunidad

{ "operacion": "buscar", "region": "asturias", "soloAbiertas": true, "soloConcurrencia": true, "maxResultados": 100 }

Ayudas municipales al comercio local en dos comunidades

{ "operacion": "buscar", "consulta": "comercio", "ambito": "local", "region": "asturias,galicia", "soloAbiertas": true }

Todo lo publicado por comunidades autónomas este trimestre

{ "operacion": "buscar", "ambito": "autonomica", "fechaDesde": "01/07/2026", "fechaHasta": "30/09/2026", "incluirDetalle": true, "maxResultados": 200 }

Ficha completa de una convocatoria

{ "operacion": "detalle", "numeroConvocatoria": "915898" }

---

Avisos automáticos de nuevas convocatorias

El caso de uso que más rinde a una gestoría no es buscar una vez, sino enterarse la primera:

1. Configura la búsqueda que te interesa (sector, ámbito, soloAbiertas: true).
2. Programa el actor para que se ejecute cada mañana.
3. Conecta un webhook o una integración para recibir los resultados donde trabajas.

Al estar en Apify, el actor hereda sin código las integraciones de la plataforma: Slack, Gmail, Google Sheets, Airtable, Make, Zapier, webhooks HTTP y API REST. También puedes exportar cualquier ejecución a Excel, CSV, XML o JSON.

---

Usar desde una IA: Claude, Cursor y MCP

Cualquier actor de Apify puede exponerse como herramienta MCP (Model Context Protocol) a través del servidor MCP de Apify (mcp.apify.com). Añade este actor a las herramientas de tu agente y podrá consultar ayudas públicas españolas en tiempo real, sin que tengas que construir la integración.

Preguntas que un agente resuelve directamente:

• "¿Qué subvenciones a la contratación hay abiertas en Andalucía?"
• "Dame el presupuesto y el plazo de la convocatoria BDNS 915898."
• "Lista las ayudas estatales financiadas con fondos Next Generation registradas este mes."

Los nombres de campo del JSON son descriptivos y en español precisamente para que un modelo los interprete sin esquema adicional.

---

Precio

Modelo pago por evento: un cargo por arranque y un cargo por cada resultado devuelto. Una búsqueda típica de 20 convocatorias cuesta alrededor de $0,03. Consulta la pestaña Pricing del actor para las tarifas vigentes.

No necesitas claves de API ni credenciales: la API de la BDNS es pública y abierta.

---

Límites conocidos

Vale la pena saberlos antes de ejecutar:

• La búsqueda por texto es literal sobre el título. La API no hace sinónimos ni lematización: digitalizacion no encuentra por sí solo transformacion digital. Por eso consulta admite varios términos separados por comas; el actor lanza una búsqueda por cada uno y fusiona los resultados. Los acentos sí se resuelven solos.
• Buscar por raíz rinde más que por palabra completa. Al ser coincidencia de subcadena, digitaliz (766 convocatorias) supera a digitalizacion (725).
• El campo abierto de la BDNS no es fiable, y por eso no lo usamos. En un muestreo de 80 convocatorias de cuatro comunidades, 28 tenían el plazo de solicitud vigente y la API devolvía abierto: false en las 28. El actor deduce estadoPlazo comparando las fechas publicadas y conserva el flag original en abiertoSegunBDNS por si quieres auditarlo.
• La mayoría de lo publicado es de concesión directa. Convenios, subvenciones nominativas y líneas de presupuesto ya tienen beneficiario asignado: aparecen con plazo abierto pero nadie puede solicitarlas. En Asturias, 61 de 68 con plazo vigente. Usa soloConcurrencia para quitarlas.
• No hay filtro nativo por sector económico. Sí lo hay por región y por ámbito. Los sectores llegan en el detalle, así que esa criba se hace sobre los resultados.
• soloAbiertas es más lento y más caro, porque obliga a consultar la ficha de cada candidata para saber si el plazo sigue vigente. Acotar antes con region reduce mucho ese coste.
• Tope de 200 resultados por ejecución. Para volcados grandes, trocea por rangos de fechas.

---

Uso responsable y aviso legal

Los datos proceden del Sistema Nacional de Publicidad de Subvenciones y Ayudas Públicas. Su reutilización está sujeta al aviso legal del portal: la información es dinámica y puede corregirse después de su extracción, por lo que la ficha oficial siempre prevalece sobre el resultado de este actor.

El actor limita la concurrencia y aplica reintentos con espera exponencial para hacer un uso respetuoso de un servicio público gratuito.

---

Preguntas frecuentes

¿De dónde salen los datos? De la API REST oficial de la BDNS (infosubvenciones.es/bdnstrans/api), publicada por la Intervención General de la Administración del Estado. No se scrapea ninguna web.

¿Están actualizados? Cada ejecución consulta la API en vivo, así que reflejan el estado de la BDNS en ese momento. No hay caché ni copia intermedia.

¿Puedo buscar por comunidad autónoma? Sí. El parámetro region acepta las 17 comunidades y las 2 ciudades autónomas, y filtra de forma nativa en la propia consulta a la API. Ojo: filtra por el territorio destinatario de la ayuda, no por quién la convoca; para eso está ambito.

Me salen muchas ayudas que mi cliente no puede pedir. ¿Por qué? Porque la BDNS publica también las de concesión directa —convenios y subvenciones nominativas ya adjudicadas a una entidad concreta—, y en número son mayoría. Activa soloConcurrencia para quedarte solo con las que admiten solicitantes.

¿Por qué mi búsqueda con tildes no devolvía nada? Porque el índice de la BDNS está normalizado sin acentos y su API no normaliza lo que recibe: formación devolvía 0 resultados y formacion, 15.279. El actor quita los diacríticos por ti, así que puedes escribir en castellano correcto.

¿Incluye subvenciones ya concedidas? No. Este actor cubre convocatorias. Las concesiones y los beneficiarios finales son otro conjunto de datos de la BDNS.

¿Necesito cuenta de Apify o clave de API? Cuenta de Apify sí, clave de la BDNS no: es una API pública sin autenticación.

¿Puedo exportarlo a Excel o Google Sheets? Sí. Cualquier ejecución se descarga en Excel, CSV, JSON o XML, y hay integración directa con Google Sheets.

---

English summary

Spain public grants and subsidies API. Search Spain's National Subsidy Database (BDNS/SNPSAP), the official registry where every Spanish public administration —national, regional, local— must publish its grant calls. Over 647,000 records, queried through the government's open REST API. No scraping.

Returns clean JSON: application deadlines, total budget in EUR, eligible beneficiary types, economic sectors, NUTS regions, EU funding sources and links to the official terms. Two operations: buscar (search by keyword, date range and administration level) and detalle (full record by BDNS code).

Built to be used as an MCP tool by AI agents through Apify's MCP server, and to be scheduled for daily monitoring of newly opened calls.

---

Desarrollo local

npm install
npm run build
npm test              # tests con fixtures reales de la API
apify run             # ejecutar localmente con el CLI de Apify
apify push            # publicar en tu cuenta de Apify

Código fuente en TypeScript. El cliente de la BDNS (src/bdns.ts) no depende del SDK de Apify y puede reutilizarse fuera del actor.