Comment créer un tableau de bord football personnel avec des API gratuites et Google Sheets
Créez votre propre suivi de scores en direct dès aujourd'hui
La plupart des applications de scores encombrent votre flux avec des ligues que vous ne regardez jamais, cachent les équipes qui vous intéressent sous des onglets, et envoient des notifications pour chaque but dans un tournoi que vous avez ignoré. Vous ne pouvez pas filtrer le bruit sans payer un abonnement premium qui affiche encore des publicités. Un Google Sheet alimenté par une API gratuite inverse ce modèle. Vous décidez exactement quels clubs apparaissent (par exemple, Arsenal, Bayern Munich et Boca Juniors) et rien d'autre. Les données se rafraîchissent quand vous ouvrez la feuille ou selon une minuterie que vous définissez, pas quand un serveur push en décide. Pas de bannières, pas de pixels de suivi, pas de compte requis au-delà de la clé API. Les offres gratuites d'API-Football et de Football-Data.org permettent des centaines d'appels par jour, amplement suffisant pour une liste de matchs personnelle. La feuille réside dans Drive, donc elle s'ouvre sur votre téléphone, votre ordinateur portable ou via un lien familial partagé sans tracas de synchronisation. Vous possédez la mise en page, les couleurs et la logique ; rien n'est abandonné parce qu'une équipe produit a pivoté.
Il vous faut un compte Google, une quinzaine de minutes et aucune expérience en programmation. Le tutoriel couvre trois options d'API gratuites : API-Football via RapidAPI, Football-Data.org et API-Football en direct. Chacune propose un niveau gratuit d'environ 100 requêtes par jour, amplement suffisant pour suivre une poignée de clubs. Seules des formules de base de Google Sheets apparaissent : IMPORTJSON pour récupérer les données, QUERY et FILTER pour les structurer, donc vous n'ouvrez jamais l'éditeur Apps Script. Si vous savez écrire =SOMME(A1:A10), vous pouvez créer ce tableau de bord. La feuille reste dans votre Drive, se met à jour selon votre planning et vous suit sur n'importe quel appareil où vous êtes connecté. Pas de carte de crédit, pas de serveur, pas de fenêtre de maintenance.
Choisissez votre API et récupérez vos identifiants
Image: 4.2 - Trace the sleeve, by LaMenta3, CC BY-SA 2.0
API-Football sur RapidAPI offre le démarrage le plus rapide : un compte marketplace, 100 appels par jour et une couverture de plus de 800 ligues. Football-Data.org évite l'étape de la carte bancaire, impose un rythme modéré de 10 appels par minute et renvoie un JSON plus plat qui s'analyse proprement dans une Google Sheet. API-Football direct reprend le catalogue RapidAPI mais réside sur son propre tableau de bord, vous gérez donc les clés séparément. Une journée type de Premier League consomme environ 20 appels si vous récupérez les matchs, les scores en direct et les stats de base pour chaque rencontre. Pour une première version, Football-Data.org supprime la couche RapidAPI supplémentaire et simplifie le calcul du quota. Passez à API-Football quand vous avez besoin des compositions, des heatmaps de joueurs ou des flux xG que Football-Data.org n'expose pas.
Inscrivez-vous sur football-data.org, confirmez l'e-mail et ouvrez le tableau de bord pour copier votre X-Auth-Token. Collez cette URL dans la barre d'adresse du navigateur : https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15. Ajoutez l'en-tête X-Auth-Token: YOUR_TOKEN à l'aide d'un outil comme ModHeader ou de l'inspecteur réseau intégré. Une réponse réussie renvoie un JSON avec un objet competition et un tableau matches. Chaque entrée de match inclut utcDate, homeTeam.name, awayTeam.name et un objet score contenant fullTime.home et fullTime.away. Vérifiez les en-têtes de réponse X-RateLimit-Limit et X-RateLimit-Remaining pour confirmer le plafond de 10 requêtes par minute. Si vous obtenez un 403, le token est absent ou mal formé ; un 429 signifie que vous avez atteint la limite par minute.
Importer des données de football en direct dans Google Sheets
Google Sheets ne dispose pas d'analyseur JSON intégré, il faut donc installer une fois pour toutes un script Apps Script. Ouvrez Extensions > Apps Script, supprimez le code de départ et collez la fonction IMPORTJSON depuis le gist GitHub de Brad Jasper. Enregistrez le projet, revenez à la feuille et autorisez le script lorsque vous y êtes invité, il s'agit d'une autorisation standard, sans risque de sécurité. La signature de la fonction est =IMPORTJSON(url, query, parseOptions). Utilisez noHeaders dans parseOptions pour supprimer la ligne d'en-tête automatique. Exemple : =IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15", "/matches", "noHeaders"). Les fonctions personnalisées ne se recalculent que lorsque leurs arguments changent ou que la feuille est modifiée ; elles ne s'actualisent pas automatiquement sur une minuterie. Prévoyez la section suivante en tenant compte de cette limitation.
=IMPORTJSON(
"https://api.football-data.org/v4/competitions/PL/matches?dateFrom="&TEXT(TODAY(),"yyyy-mm-dd")&"&dateTo="&TEXT(TODAY(),"yyyy-mm-dd"), // URL with dynamic today's date
"matches[*].[utcDate,homeTeam.name,awayTeam.name,score.fullTime.home,score.fullTime.away]", // JSONPath query: extract date, home, away, home score, away score
"noHeaders" // parseOption: suppress header row
)
Enveloppez l'appel IMPORTJSON dans QUERY pour ne conserver que les matchs terminés, les trier par coup d'envoi et afficher des colonnes propres : =QUERY(IMPORTJSON(...), "SELECT Col1, Col2, Col3, Col4, Col5 WHERE Col4 IS NOT NULL ORDER BY Col1", 0). Col1 est la chaîne de date UTC, Col2 l'équipe à domicile, Col3 l'équipe à l'extérieur, Col4 le score à domicile, Col5 le score à l'extérieur. Convertissez l'UTC en heure locale avec un ARRAYFORMULA à côté des données : =ARRAYFORMULA(IF(LEN(A2:A), TEXT(A2:A+TIME(1,0,0), "ddd dd/mm HH:mm"), )). Ajustez le décalage TIME pour votre fuseau horaire. Ne faites apparaître que les clubs que vous suivez en filtrant la plage de résultats : =FILTER(B2:F, REGEXMATCH(B2:B, "Arsenal|Liverpool|Chelsea") + REGEXMATCH(C2:C, "Arsenal|Liverpool|Chelsea")). Le signe plus fait office de logique OU entre les colonnes domicile et extérieur. Ces trois formules — QUERY, ARRAYFORMULA, FILTER — transforment un dump JSON brut en une liste personnelle de matchs qui se met à jour chaque fois que la feuille se recalcule, sans déclencheur Apps Script nécessaire.
Automatiser l'actualisation et peaufiner votre tableau de bord
Les fonctions personnalisées comme IMPORTJSON ne se recalculent qu'à l'ouverture de la feuille ou lorsque leurs entrées changent, si bien que la liste des matchs reste figée jusqu'à votre intervention. La solution la plus légère est un Apps Script de cinq lignes qui écrit un horodatage dans une cellule hors du chemin (Z1 convient bien), forçant ainsi chaque formule dépendante à se réévaluer. Collez ceci dans Extensions → Apps Script :
Enregistrez, puis cliquez sur l'icône d'horloge (Déclencheurs) → Ajouter un déclencheur → choisissez triggerRefresh, piloté par l'heure, minuteur horaire, toutes les heures. Cela génère 24 appels API par jour, bien en deçà du niveau gratuit de 100 appels sur RapidAPI et du plafond de 10 par minute sur Football-Data.org. Si vous préférez ne pas maintenir de script, un rafraîchissement manuel Ctrl+R (Cmd+R sur Mac) actualise la feuille à la demande. Les deux approches comblent l'écart « temps réel » sans aucun module complémentaire payant ni automatisation complexe.
Créez un sélecteur de compétition dans la cellule A1 via Données → Validation des données → Liste à partir d'une plage, puis saisissez les six codes de compétition : PL, UCL, PD, BL1, SA, FL1. Réécrivez l'URL IMPORTJSON pour qu'elle lise cette cellule afin que le tableau de bord change de compétition instantanément :
Appliquez une mise en forme conditionnelle aux colonnes de score (supposons buts domicile en D, buts extérieur en E). Sélectionnez les lignes des matchs, choisissez Format → Mise en forme conditionnelle → La formule personnalisée est, et ajoutez trois règles :
=$D2>$E2→ remplissage vert (victoire domicile)=$D2<$E2→ remplissage rouge (victoire extérieur)=$D2=$E2→ remplissage jaune (match nul)
Les couleurs se mettent à jour automatiquement à l'arrivée des résultats. Enfin, partagez la feuille : Fichier → Partager → Toute personne disposant du lien → Lecteur. Pour un embed public, utilisez Fichier → Partager → Publier sur le web → Document entier → Lien, puis collez l'iframe où vous en avez besoin.
Maintenir votre tableau de bord football sur le long terme
Image: DIY Suitcase Table, by Stacie Stacie Stacie, CC BY-SA 2.0
Les offres gratuites changent sans préavis ; Football-Data.org a réduit son quota journalier en 2023, traitez donc la limite comme une cible mobile. Chaque réponse contient des en-têtes qui révèlent l'état en temps réel : X-RequestCounter-Reset indique quand la fenêtre se réinitialise, et X-Requests-Available affiche le solde restant. Capturez ces valeurs dans un onglet masqué nommé _quota via un appel IMPORTJSON léger pointant vers le chemin des en-têtes, par exemple :
=IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches", "headers[X-Requests-Available],headers[X-RequestCounter-Reset]")
Programmez un déclencheur quotidien pour ajouter le résultat à côté de TODAY() ; une simple mise en forme conditionnelle signale toute ligne où les appels disponibles tombent sous vingt. Si le plafond baisse à nouveau, remplacez l'URL de base par celle d'API-Football ; les points de terminaison reprennent la même structure, seul l'en-tête d'authentification change, passant de X-Auth-Token à X-RapidAPI-Key. Conservez une colonne de secours dans votre sélecteur de compétition avec les codes alternatifs (PL, UCL, PD, BL1, SA, FL1) pour que le tableau de bord survive à un changement de fournisseur par la simple modification d'une cellule.
- Vérifier les en-têtes de quota, tester un point de terminaison, confirmer l'affichage de la mise en forme conditionnelle, contrôler la mise à jour des horodatages, passer en revue la liste des équipes favorites.
- Surveiller les erreurs 429, avoir besoin de mises à jour en direct minute par minute, vouloir des statistiques joueurs, ou exiger 50+ compétitions — alors évaluer les offres payantes.
Le même schéma IMPORTJSON qui alimente votre liste de matchs ouvre la porte à un contexte plus riche sans nouveaux outils. Remplacez le point de terminaison par /competitions/PL/standings et le chemin de requête par standings[0].table[].[position,team.name,played,won,draw,lost,points] pour un classement en direct ; utilisez /competitions/PL/scorers avec scorers[].[player.name,team.name,goals] pour suivre la course au titre de meilleur buteur ; ou récupérez la forme récente d'un club unique via /teams/57/matches?limit=5&status=FINISHED (remplacez 57 par n'importe quel ID d'équipe de la référence Football-Data.org). Chaque appel renvoie un JSON plat que QUERY peut restructurer en colonnes propres, vous permettant d'afficher classements, buteurs et forme côte à côte sur une seule feuille. La documentation interactive du fournisseur sur docs.football-data.org permet de tester chaque paramètre avant de coller l'URL. Votre tableau de bord surpasse désormais toute application car il affiche exactement ce qui vous intéresse — ni plus, ni moins.