Come creare una dashboard calcistica personale usando API gratuite e Google Sheets
Come creare una dashboard calcistica personale con API gratuite e Google Sheets
Crea il tuo tracker di risultati live oggi
La maggior parte delle app per i risultati intasa il feed con campionati che non guardi mai, nasconde le squadre che ti interessano sotto schede e bombarda di notifiche ogni gol di tornei che hai ignorato. Non puoi filtrare il rumore senza pagare un piano premium che mostra comunque pubblicità. Un Google Sheet alimentato da un'API gratuita ribalta il modello: decidi esattamente quali club far apparire — ad esempio Arsenal, Bayern Monaco e Boca Juniors — e nient'altro. I dati si aggiornano quando apri il foglio o con un timer che imposti tu, non quando decide un server push. Niente banner, niente pixel di tracciamento, nessun account richiesto oltre alla chiave API. I piani gratuiti di API-Football e Football-Data.org offrono centinaia di chiamate al giorno, più che sufficienti per un calendario personale. Il foglio vive su Drive, quindi si apre su telefono, laptop o tramite un link condiviso in famiglia senza problemi di sincronizzazione. Controlli layout, colori e logica; nulla viene deprecato perché un team di prodotto ha cambiato direzione.
Ti serve un account Google, una quindicina di minuti e zero esperienza di programmazione. La guida copre tre opzioni API gratuite: API-Football tramite RapidAPI, Football-Data.org e API-Football diretta. Ognuna offre un piano gratuito di circa 100 richieste al giorno, più che abbastanza per seguire una manciata di club. Vengono usate solo formule base di Google Sheets: IMPORTJSON per recuperare i dati, QUERY e FILTER per modellarli, così non apri mai l'editor di Apps Script. Se sai scrivere =SOMMA(A1:A10), puoi costruire questa dashboard. Il foglio resta nel tuo Drive, si aggiorna secondo i tuoi orari e ti segue su qualsiasi dispositivo dove accedi. Niente carta di credito, niente server, niente finestre di manutenzione.
Scegli la tua API e ottieni le credenziali
Image: 4.2 - Trace the sleeve, by LaMenta3, CC BY-SA 2.0
API-Football su RapidAPI offre l'avvio più rapido: un account marketplace, 100 chiamate al giorno e copertura di oltre 800 campionati. Football-Data.org salta il passaggio della carta di credito, impone un ritmo gentile di 10 chiamate al minuto e restituisce un JSON più piatto che si analizza pulitamente in un Google Sheet. API-Football diretta rispecchia il catalogo RapidAPI ma risiede nella propria dashboard, così gestisci le chiavi separatamente. Una tipica giornata di Premier League consuma circa 20 chiamate se recuperi calendario, risultati live e statistiche base per ogni partita. Per una prima realizzazione, Football-Data.org elimina il livello extra di RapidAPI e mantiene semplice il calcolo della quota. Passa ad API-Football quando ti servono formazioni, heatmap dei giocatori o feed xG che Football-Data.org non espone.
Registrati su football-data.org, conferma l'email e apri la dashboard per copiare il tuo X-Auth-Token. Poi incolla questo URL nel browser: https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15. Aggiungi l'header X-Auth-Token: YOUR_TOKEN con ModHeader o l'ispettore di rete. Una risposta corretta restituisce un JSON contenente un oggetto competition e un array matches; ogni elemento include utcDate, homeTeam.name, awayTeam.name e un oggetto score con fullTime.home e fullTime.away. Controlla gli header X-RateLimit-Limit e X-RateLimit-Remaining per verificare il tetto di 10 richieste al minuto. Un 403 segnala token mancante o malformato; un 429 indica che hai superato il limite.
Importare dati calcistici live in Google Sheets
Google Sheets non ha un parser JSON integrato, quindi serve un'installazione una tantum di Apps Script. Apri Estensioni > Apps Script, cancella il codice iniziale e incolla la funzione IMPORTJSON dal gist GitHub di Brad Jasper. Salva il progetto, torna al foglio e autorizza lo script quando richiesto: è una normale concessione di permessi, non un rischio per la sicurezza. La sintassi della funzione è =IMPORTJSON(url, query, parseOptions). Usa noHeaders in parseOptions per evitare la riga di intestazione automatica. Esempio: =IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15", "/matches", "noHeaders"). Le funzioni personalizzate si ricalcolano solo quando cambiano gli argomenti o si modifica il foglio; non si aggiornano automaticamente con un timer. Tieni conto di questo limite nella sezione successiva.
=IMPORTJSON(
"https://api.football-data.org/v4/competitions/PL/matches?dateFrom="&TEXT(TODAY(),"yyyy-mm-dd")&"&dateTo="&TEXT(TODAY(),"yyyy-mm-dd"), // URL con la data odierna dinamica
"matches[*].[utcDate,homeTeam.name,awayTeam.name,score.fullTime.home,score.fullTime.away]", // Query JSONPath: estrae data, casa, trasferta, gol casa, gol trasferta
"noHeaders" // parseOption: nasconde la riga di intestazione
)
Avvolgi la chiamata IMPORTJSON in QUERY per tenere solo le partite concluse, ordinare per orario d'inizio ed esporre colonne pulite: =QUERY(IMPORTJSON(...), "SELECT Col1, Col2, Col3, Col4, Col5 WHERE Col4 IS NOT NULL ORDER BY Col1", 0). Col1 è la stringa di data UTC, Col2 squadra di casa, Col3 squadra in trasferta, Col4 gol casa, Col5 gol trasferta. Converte UTC in ora locale con un ARRAYFORMULA accanto ai dati: =ARRAYFORMULA(SE(LUNGHEZZA(A2:A), TESTO(A2:A+ORA(1,0,0), "ggg gg/mm OO:mm"), )); adatta l'offset di ORA per il tuo fuso. Mostra solo le squadre che segui filtrando l'intervallo risultato: =FILTER(B2:F, REGEXMATCH(B2:B, "Arsenal|Liverpool|Chelsea") + REGEXMATCH(C2:C, "Arsenal|Liverpool|Chelsea")). Il segno più funge da logica OR tra le colonne casa e trasferta. Queste tre formule — QUERY, ARRAYFORMULA, FILTER — trasformano un dump JSON grezzo in una lista partite personale che si aggiorna ogni volta che il foglio si ricalcola, senza trigger Apps Script.
Automatizzare l'aggiornamento e rifinire la dashboard
Le funzioni personalizzate come IMPORTJSON si ricalcolano solo all'apertura del foglio o quando cambiano i loro input, quindi l'elenco partite diventa obsoleto finché non intervieni. La soluzione più leggera è uno script Apps Script di cinque righe che scrive un timestamp in una cella defilata (Z1 va bene), forzando ogni formula dipendente a rievalutarsi. Incolla questo in Estensioni → Apps Script:
Salva, poi clicca l'icona dell'orologio (Trigger) → Aggiungi trigger → scegli triggerRefresh, basato sul tempo, timer orario, ogni ora. Così ottieni 24 chiamate API al giorno, ben entro il livello gratuito da 100 chiamate di RapidAPI e il limite di 10 al minuto di Football-Data.org. Se preferisci zero manutenzione dello script, un aggiornamento manuale Ctrl+R (Cmd+R su Mac) rinfresca il foglio su richiesta. Entrambi gli approcci colmano il divario "live" senza un solo componente aggiuntivo a pagamento o automazione complessa.
Crea un selettore campionato nella cella A1 con Dati → Convalida dati → Elenco da un intervallo, poi inserisci i sei codici competizione: PL, UCL, PD, BL1, SA, FL1. Riscrivi l'URL di IMPORTJSON in modo che legga quella cella, così la dashboard cambia campionato all'istante:
Applica la formattazione condizionale alle colonne dei punteggi (supponi gol casa in D, gol trasferta in E). Seleziona le righe delle partite, scegli Formato → Formattazione condizionale → Formula personalizzata, e aggiungi tre regole:
=$D2>$E2→ riempimento verde (vittoria casa)=$D2<$E2→ riempimento rosso (vittoria trasferta)=$D2=$E2→ riempimento giallo (pareggio)
I colori si aggiornano automaticamente man mano che arrivano i risultati. Infine, condividi il foglio: File → Condividi → Chiunque abbia il link → Visualizzatore. Per un embed pubblico, usa File → Condividi → Pubblica sul web → Intero documento → Link, poi incolla l'iframe dove serve.
Mantenere la tua dashboard calcistica attiva a lungo termine
Image: DIY Suitcase Table, by Stacie Stacie Stacie, CC BY-SA 2.0
I piani gratuiti cambiano senza preavviso; Football-Data.org ha ridotto la quota giornaliera nel 2023, quindi considera la quota come un obiettivo mobile. Ogni risposta include header che rivelano lo stato in tempo reale: X-RequestCounter-Reset indica quando la finestra si azzera, e X-Requests-Available mostra il saldo rimanente. Cattura quei valori in un foglio nascosto chiamato _quota con una chiamata IMPORTJSON leggera puntata al percorso degli header, per esempio:
=IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches", "headers[X-Requests-Available],headers[X-RequestCounter-Reset]")
Programma un trigger giornaliero per aggiungere il risultato accanto a TODAY(); una semplice formattazione condizionale segnala le righe dove le chiamate disponibili scendono sotto venti. Se il tetto scende di nuovo, sostituisci l'URL base con API-Football; gli endpoint rispecchiano la stessa struttura, cambia solo l'header di autenticazione da X-Auth-Token a X-RapidAPI-Key. Mantieni una colonna di riserva nel selettore campionato con i codici alternativi (PL, UCL, PD, BL1, SA, FL1) così la dashboard sopravvive al cambio di provider con una sola modifica di cella.
- Verifica gli header della quota, testa un endpoint, conferma che la formattazione condizionale funzioni, controlla l'aggiornamento del timestamp, rivedi la lista delle squadre preferite.
- Monitora gli errori 429, serve aggiornamenti minuto per minuto in tempo reale, vuoi statistiche sui giocatori o ti servono 50+ campionati — allora valuta i piani a pagamento.
Lo stesso schema IMPORTJSON che alimenta la tua lista di partite apre la porta a contesti più ricchi senza nuovi strumenti. Cambia l'endpoint in /competitions/PL/standings e il percorso della query in standings[0].table[].[position,team.name,played,won,draw,lost,points] per una classifica live; usa /competitions/PL/scorers con scorers[].[player.name,team.name,goals] per seguire la corsa al capocannoniere; oppure recupera la forma recente di un singolo club tramite /teams/57/matches?limit=5&status=FINISHED (sostituisci 57 con qualsiasi ID squadra dal riferimento di Football-Data.org). Ogni chiamata restituisce JSON piatto che QUERY può ridisporre in colonne pulite, così puoi affiancare classifica, marcatori e forma in un unico foglio. La documentazione interattiva del provider su docs.football-data.org ti permette di testare ogni parametro prima di incollare l'URL. La tua dashboard ora batte qualsiasi app perché mostra esattamente ciò che ti interessa — né più né meno.