API Documentation

curl "https://bandiup.it/api/bandi?limit=5"

https://bandiup.it/api

{
  "success": true,
  "data": [
    {
      "id": "eu-HORIZON-2025-001",
      "titolo": "Horizon Europe - Cluster 4 Digital",
      "descrizione": "Bando per progetti di ricerca...",
      "descrizioneBreve": "Bando Horizon Europe...",
      "fonte": "eu",
      "fonteNome": "Commissione Europea",
      "fonteUrl": "https://ec.europa.eu",
      "categoria": "ricerca",
      "importoMin": 500000,
      "importoMax": 3000000,
      "dataApertura": "2025-01-15",
      "dataScadenza": "2026-06-30",
      "stato": "aperto",
      "destinatari": ["Universita", "Enti di ricerca", "PMI"],
      "regione": null,
      "tipoAgevolazione": "fondo_perduto",
      "certificazioni": ["durc", "dnsh"],
      "tags": ["horizon", "ricerca", "digitale"],
      "urlBando": "https://ec.europa.eu/...",
      "ultimoAggiornamento": "2026-03-27T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "totale": 1309,
    "pagine": 66
  },
  "fonti": [
    "Commissione Europea",
    "TED - Tenders Electronic Daily",
    "Ministeri e Agenzie Nazionali",
    "Incentivi.gov.it",
    "Regioni Italiane",
    "MePA / Consip"
  ],
  "ultimoAggiornamento": "2026-03-27T10:00:00.000Z"
}

curl "https://bandiup.it/api/bandi/eu-HORIZON-2025-001"

{
  "success": true,
  "data": {
    "id": "eu-HORIZON-2025-001",
    "titolo": "Horizon Europe - Cluster 4 Digital",
    "descrizione": "...",
    ...tutti i campi del bando
  }
}

# Ultime notizie PNRR
curl "https://bandiup.it/api/notizie?fonte=pnrr&limit=10"

# Notizie regionali della Lombardia
curl "https://bandiup.it/api/notizie?fonte=regionale&regione=Lombardia"

# Cerca "digitalizzazione"
curl "https://bandiup.it/api/notizie?q=digitalizzazione"

{
  "success": true,
  "data": [
    {
      "id": "news-pnrr-horizon-europe-001",
      "titolo": "PNRR: nuovi fondi per la digitalizzazione delle PMI",
      "descrizione": "Il MIMIT ha stanziato 500 milioni...",
      "descrizioneBreve": "Il MIMIT ha stanziato 500 milioni...",
      "fonte": "pnrr",
      "fonteNome": "PNRR - Amministrazioni",
      "fonteUrl": "https://www.italiadomani.gov.it",
      "categoria": "digitalizzazione",
      "dataPubblicazione": "2026-03-25",
      "tags": ["PNRR", "digitale", "PMI", "finanziamento", "MIMIT"],
      "url": "https://www.italiadomani.gov.it/...",
      "regione": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "totale": 256,
    "pagine": 13
  },
  "fonti": ["MIMIT", "PNRR - Amministrazioni", ...]
}

curl "https://bandiup.it/api/stats"

{
  "success": true,
  "data": {
    "bandi": {
      "totale": 1309,
      "perFonte": {
        "eu": 434,
        "nazionale": 804,
        "regionale": 18,
        "pnrr": 53
      },
      "perStato": {
        "aperto": 1135,
        "in_scadenza": 87,
        "prossimo": 75
      },
      "perCategoria": {
        "digitalizzazione": 120,
        "pmi": 340,
        "innovazione": 89,
        ...
      }
    },
    "notizie": {
      "totale": 256
    },
    "fonti": ["Commissione Europea", "TED", ...],
    "ultimoAggiornamento": "2026-03-27T10:00:00.000Z"
  }
}

curl -X POST "https://bandiup.it/api/contatti" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Mario Rossi",
    "email": "mario@esempio.it",
    "oggetto": "Richiesta informazioni API",
    "messaggio": "Vorrei sapere di più sulle API..."
  }'

{
  "success": true,
  "message": "Messaggio ricevuto. Ti risponderemo il prima possibile."
}

// Tutti i bandi europei aperti
const response = await fetch(
  "https://bandiup.it/api/bandi?fonte=eu&stato=aperto"
);
const { data, pagination } = await response.json();

console.log(`Trovati ${pagination.totale} bandi EU aperti`);

for (const bando of data) {
  console.log(`- ${bando.titolo}`);
  console.log(`  Scadenza: ${bando.dataScadenza}`);
  console.log(`  Importo: ${bando.importoMax}€`);
  console.log(`  Link: ${bando.urlBando}`);
}

import requests

# Bandi per startup con importo max 50K
response = requests.get(
    "https://bandiup.it/api/bandi",
    params={
        "categoria": "startup",
        "importoMax": 50000,
        "stato": "aperto",
        "limit": 100
    }
)
data = response.json()

print(f"Trovati {data['pagination']['totale']} bandi")

for bando in data["data"]:
    print(f"- {bando['titolo']}")
    print(f"  Fonte: {bando['fonteNome']}")
    print(f"  Scadenza: {bando.get('dataScadenza', 'N/D')}")
    print()

# Esporta in CSV
import csv
with open("bandi_startup.csv", "w", newline="") as f:
    writer = csv.writer(f)
    writer.writerow(["Titolo", "Fonte", "Scadenza", "Importo Max", "URL"])
    for b in data["data"]:
        writer.writerow([
            b["titolo"],
            b["fonteNome"],
            b.get("dataScadenza", ""),
            b.get("importoMax", ""),
            b["urlBando"]
        ])

Modulo: HTTP - Make a request
  URL: https://bandiup.it/api/bandi
  Method: GET
  Query string:
    fonte = nazionale
    stato = aperto
    limit = 50

Modulo successivo: Iterator
  Array: {{body.data}}

Modulo successivo: Google Sheets - Add a Row
  Valori:
    Titolo: {{item.titolo}}
    Fonte: {{item.fonteNome}}
    Scadenza: {{item.dataScadenza}}
    URL: {{item.urlBando}}

Trigger: Schedule by Zapier
  Frequenza: Ogni giorno

Action 1: Webhooks by Zapier (GET)
  URL: https://bandiup.it/api/bandi?stato=in_scadenza&limit=5

Action 2: Filter by Zapier
  Condizione: pagination__totale > 0

Action 3: Gmail - Send Email
  To: tuaemail@esempio.com
  Subject: Bandi in scadenza ({{pagination__totale}})
  Body: {{data}}

Trigger: Ricorrenza
  Frequenza: Giorno
  Intervallo: 1

Azione: HTTP
  Metodo: GET
  URI: https://bandiup.it/api/bandi?stato=aperto&categoria=pmi&limit=20

Azione: Parse JSON
  Contenuto: @body('HTTP')
  Schema: (incolla la risposta di esempio)

Azione: Applica a ogni elemento -> @body('Parse_JSON')?['data']
  Azione interna: Invia un messaggio di posta elettronica (V2)
    A: tuaemail@outlook.com
    Oggetto: Nuovo bando - @items('Applica_a_ogni_elemento')?['titolo']
    Corpo: @items('Applica_a_ogni_elemento')?['descrizioneBreve']

function importaBandi() {
  const url = "https://bandiup.it/api/bandi?stato=aperto&limit=200";
  const response = UrlFetchApp.fetch(url);
  const json = JSON.parse(response.getContentText());

  const sheet = SpreadsheetApp.getActiveSpreadsheet()
    .getSheetByName("Bandi") || SpreadsheetApp.getActiveSpreadsheet()
    .insertSheet("Bandi");

  // Header
  sheet.clear();
  sheet.appendRow([
    "Titolo", "Fonte", "Categoria", "Stato",
    "Scadenza", "Importo Max", "Regione", "URL"
  ]);

  // Dati
  for (const b of json.data) {
    sheet.appendRow([
      b.titolo,
      b.fonteNome,
      b.categoria,
      b.stato,
      b.dataScadenza || "",
      b.importoMax || "",
      b.regione || "",
      b.urlBando
    ]);
  }

  Logger.log("Importati " + json.data.length + " bandi");
}

// Imposta un trigger per eseguirlo ogni giorno:
// Edit > Current project's triggers > Add Trigger
// Function: importaBandi, Time-driven: Day timer

# Tutti i bandi aperti, salva in file JSON
curl -s "https://bandiup.it/api/bandi?stato=aperto&limit=200" \
  | python3 -m json.tool > bandi_aperti.json

# Solo i titoli dei bandi EU
curl -s "https://bandiup.it/api/bandi?fonte=eu" \
  | python3 -c "
import json, sys
data = json.load(sys.stdin)
for b in data['data']:
    print(f"- {b['titolo']} (scade: {b.get('dataScadenza', 'N/D')})")"

# Statistiche rapide
curl -s "https://bandiup.it/api/stats" | python3 -m json.tool

# Controlla se ci sono bandi in scadenza (utile per cron jobs)
BANDI=$(curl -s "https://bandiup.it/api/bandi?stato=in_scadenza" \
  | python3 -c "import json,sys; print(json.load(sys.stdin)['pagination']['totale'])")
if [ "$BANDI" -gt 0 ]; then
  echo "⚠️  $BANDI bandi in scadenza!"
fi