# Spain Grants & Subsidies Monitor (BDNS) – Ayudas y Subvenciones (`flets_sv/subvenciones-bdns-espana`) Actor

Search open Spanish grants and subsidies from the official BDNS: deadline, budget, beneficiaries, region and legal basis. Ideal for consultants and alerts.

- **URL**: https://apify.com/flets_sv/subvenciones-bdns-espana.md
- **Developed by:** [FlEtsv](https://apify.com/flets_sv) (community)
- **Categories:** Business, Lead generation
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 grant call returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Spain Grants & Subsidies Monitor (BDNS) – Ayudas y Subvenciones

Find Spanish public grants and subsidies (ayudas y subvenciones) straight from the official BDNS database: deadline, budget, beneficiaries, region and legal basis, as clean JSON, CSV or Excel. *Versión en español más abajo.*

***

### Use cases

- Grant consultancies: build a weekly list of new calls for each client sector
- SMEs and freelancers (autónomos): get alerted to aid you can apply for
- Lead generation: contact companies that receive subsidies in a sector
- Dashboards and newsletters on public funding by region

### English

#### What does it do?

The Actor queries the official National Database of Subsidies (BDNS, Sistema Nacional de Publicidad de Subvenciones) and returns each call with its closing date, days left, total budget, call type, purpose, beneficiaries, sectors, regions, legal basis link and a direct link to the call. You can filter by keywords, administration level (State, regional, local), window of days, region text, minimum budget and open calls only.

#### Input

- `palabrasClave`: words searched in the title (default `ayudas`).
- `tipoAdministracion`: all, State, regional, local or other.
- `diasAtras`: publication window, 1 to 365 days (default 60).
- `soloAbiertas`: keep only calls with an active application period.
- `excluirConcesionDirecta`: hide nominative and direct awards (default on).
- `presupuestoMinimo`, `regionTexto`, `maxItems`.

The default input already works: press **Start** and you get results in seconds.

Example:

```json
{"palabrasClave":"ayudas","diasAtras":60,"maxItems":10}
```

#### Output

One record per result with: `codigoBDNS`, `titulo`, `organoNivel1`, `organo`, `fechaPublicacion`, `abierta`, `fechaInicioSolicitud`, `fechaFinSolicitud`, `diasRestantes`, `presupuestoTotal`, `tipoConvocatoria`, `finalidad`, `beneficiarios`, `sectores`, `regiones`, `instrumentos`, `urlBases`, `urlConvocatoria`.

#### Pricing (pay per event)

| Event | Price | Per 1,000 |
|---|---|---|
| Grant call returned (`grant-found`) | $0.003 | $3.00 |

You only pay for results returned. Set a maximum spend per run and the Actor stops when the limit is reached, keeping what it saved. The Apify FREE plan includes monthly credit to try it.

#### Integrations (Make, Zapier, Google Sheets)

- **Make**: add the Apify module "Run an Actor" (Actor `Flets_sv/subvenciones-bdns-espana`), paste the input JSON, chain "Get Dataset Items" and map the fields to Google Sheets, Slack, Airtable or your CRM.
- **Zapier**: the Apify app offers "Run Actor" and "Fetch Dataset Items". Add a Schedule trigger and send each row to Gmail, Slack or Notion.
- **Google Sheets**: enable the official Google Sheets integration in the Actor's Integrations tab to append every run to a sheet, or call `https://api.apify.com/v2/acts/Flets_sv~subvenciones-bdns-espana/run-sync-get-dataset-items?format=csv` with POST and your input from Apps Script (`UrlFetchApp`).
- **API and webhooks**: start the Actor from the REST API, use Schedules for recurring runs and add a webhook to notify your system when a run finishes.

Input to paste into Make or Zapier:

```json
{"palabrasClave":"ayudas","diasAtras":60,"maxItems":10}
```

#### FAQ

**Where does the data come from?** From the public API of the Spanish Ministry of Finance (infosubvenciones.es). Reuse is subject to its legal notice; the Actor adds no private data.

**Why are some deadlines empty?** Many calls publish their dates only inside the official gazette extract. In that case `abierta` follows the BDNS flag and `diasRestantes` is null.

**Can I get alerts?** Yes: schedule the Actor daily with `diasAtras` set to 1 and connect it to email or Slack.

***

### Español

#### ¿Qué hace?

El Actor consulta la Base de Datos Nacional de Subvenciones (BDNS) y devuelve cada convocatoria con fecha de cierre, días restantes, presupuesto, tipo, finalidad, beneficiarios, sectores, regiones, enlace a las bases y a la convocatoria. Filtra por palabras clave, nivel de administración (Estado, autonómico, local), ventana de días, región, presupuesto mínimo y solo convocatorias abiertas.

#### Input

Con la entrada por defecto (palabra «ayudas», últimos 60 días, 10 resultados, sin concesiones directas) obtienes resultados en unos segundos. Usa los mismos campos que la sección inglesa.

#### Output

Un registro por resultado con los campos de la sección inglesa.

#### Precios (pago por evento)

Grant call returned (`grant-found`): $0.003 ($3.00 por cada 1.000). Solo pagas por los resultados devueltos y puedes fijar un gasto máximo por ejecución.

#### Integraciones (Make, Zapier, Google Sheets)

- **Make**: añade el módulo de Apify «Run an Actor» (Actor `Flets_sv/subvenciones-bdns-espana`), pega el input JSON y encadena «Get Dataset Items»; después mapea los campos a Google Sheets, Slack, Airtable o tu CRM.
- **Zapier**: la app de Apify ofrece «Run Actor» y «Fetch Dataset Items». Ponle un disparador de horario y envía cada fila a Gmail, Slack o Notion.
- **Google Sheets**: en la pestaña Integrations del Actor activa la integración oficial con Google Sheets para añadir cada ejecución a una hoja, o llama desde Apps Script (`UrlFetchApp`) a `https://api.apify.com/v2/acts/Flets_sv~subvenciones-bdns-espana/run-sync-get-dataset-items?format=csv` con POST y tu input.
- **API y webhooks**: lanza el Actor por API REST, programa ejecuciones (Schedules) y avisa a tu sistema con un webhook al terminar.

Ejemplo de input para pegar en Make o Zapier:

```json
{"palabrasClave":"ayudas","diasAtras":60,"maxItems":10}
```

#### Preguntas frecuentes

**¿Sirve para asesorías?** Sí. Programa una ejecución semanal por sector y envía la hoja a tus clientes.

**¿Incluye ayudas europeas?** Solo las que se publican en la BDNS (fondos gestionados en España).

### Ejemplos de uso / Usage examples

#### Example output (real run, 2026-11-05)

First rows returned by a real run of this Actor on 2026-11-05 (shortened columns, values truncated):

| codigoBDNS | titulo | organo | fechaPublicacion | presupuestoTotal | abierta |
|---|---|---|---|---|---|
| 939897 | ORDEN de la Consejería de Agricultura, Ganadería, Pesca y... | CANARIAS > CONSEJERÍA DE AGRICULTURA, GANADERÍA, PESCA Y... | 2026-11-04 | 2685520 | False |
| 939888 | CONVOCATORIA Y APROBACIÓN DE LAS BASES REGULADORAS PARA L... | SANT JOAN D'ALACANT > AYUNTAMIENTO DE SANT JOAN D'ALACANT | 2026-11-04 | 35000 | False |
| 939878 | Convocatoria de ayudas para el otorgamiento de subvencion... | FIGUERES > AYUNTAMIENTO DE FIGUERES | 2026-11-04 | 5000 | True |

#### Copy-paste inputs

**1. New grants mentioning 'ayudas' in the last 60 days**

```json
{
  "palabrasClave": "ayudas",
  "diasAtras": 60,
  "maxItems": 50
}
```

**2. Open grants over 100k EUR in Andalusia**

```json
{
  "palabrasClave": "digitalización",
  "soloAbiertas": true,
  "presupuestoMinimo": 100000,
  "regionTexto": "Andalucía",
  "maxItems": 50
}
```

#### Call it from your code (Apify API)

```bash
curl -X POST "https://api.apify.com/v2/acts/Flets_sv~subvenciones-bdns-espana/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"palabrasClave": "ayudas", "diasAtras": 60, "maxItems": 50}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("Flets_sv/subvenciones-bdns-espana").call(run_input={"palabrasClave": "ayudas", "diasAtras": 60, "maxItems": 50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

No code? Use the Apify modules for **Make** and **Zapier** (run the Actor, then fetch dataset items), or the **Google Sheets** integration in the Actor's Integrations tab to append each run to a sheet.

### Related Actors / Actores relacionados

Public tenders and grants family by Flets_sv / Familia de licitaciones y ayudas:

- [Spain tenders (PLACSP)](https://apify.com/flets_sv/licitaciones-placsp): Spanish national and regional public tenders.
- [EU tenders (TED)](https://apify.com/flets_sv/ted-eu-tenders): above-threshold tenders of all EU countries.
- [UK public tenders](https://apify.com/flets_sv/uk-public-tenders): Find a Tender and Contracts Finder.
- [France tenders (BOAMP)](https://apify.com/flets_sv/boamp-france-tenders): French marchés publics.
- [Australia government contracts (AusTender)](https://apify.com/flets_sv/austender-australia-contracts): federal contracts awarded.

# Actor input Schema

## `palabrasClave` (type: `string`):

Words searched in the call title, e.g. "ayudas", "pymes", "digitalización", "autónomos", "agricultura". Empty returns every call.

## `tipoAdministracion` (type: `string`):

Who publishes the call: national, regional, local or other bodies.

## `diasAtras` (type: `integer`):

Only calls registered in this window (1 to 365).

## `soloAbiertas` (type: `boolean`):

Keep only calls whose application period is still running (based on the closing date). Many calls publish no dates; those are kept out when this is on.

## `excluirConcesionDirecta` (type: `boolean`):

Hide nominative and direct-award entries (already assigned to one beneficiary). Keeps only calls you can actually apply to.

## `presupuestoMinimo` (type: `integer`):

Skip calls with a smaller total budget. 0 disables the filter.

## `regionTexto` (type: `string`):

Keep calls whose region or issuing body contains this text, e.g. "Andalucía" or "Madrid".

## `maxItems` (type: `integer`):

Maximum number of calls returned. It also caps your spend.

## Actor input object example

```json
{
  "palabrasClave": "ayudas",
  "tipoAdministracion": "todas",
  "diasAtras": 60,
  "soloAbiertas": false,
  "excluirConcesionDirecta": true,
  "presupuestoMinimo": 0,
  "regionTexto": "",
  "maxItems": 10
}
```

# Actor output Schema

## `resultados` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "palabrasClave": "ayudas",
    "diasAtras": 60,
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("flets_sv/subvenciones-bdns-espana").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "palabrasClave": "ayudas",
    "diasAtras": 60,
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("flets_sv/subvenciones-bdns-espana").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "palabrasClave": "ayudas",
  "diasAtras": 60,
  "maxItems": 10
}' |
apify call flets_sv/subvenciones-bdns-espana --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,flets_sv/subvenciones-bdns-espana"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HMqi3s0DNPUZIeDsk/builds/ZHQ0EggYYoHZAGpcl/openapi.json