TheStatsAPI

Qu'est-ce que TheStatsAPI ?

TheStatsAPI est une API de statistiques football pour développeurs qui fournit un accès programmatique aux données de matchs, statistiques de joueurs et d'équipes, calendriers/résultats et cotes de paris. Elle est conçue pour alimenter des applications nécessitant des données football structurées, livrées sous forme de JSON propre et paginé via des endpoints documentés.

L'API couvre les statistiques de 80 compétitions par défaut (jusqu'à 1 196 compétitions disponibles sur demande) et inclut des données historiques (10 ans de couverture) et des données live lorsque disponibles, comme les cotes en direct et les statistiques de matchs.

Fonctionnalités principales

• Calendriers et résultats de matchs : Récupérez les listes de fixtures et les résultats historiques pour les compétitions couvertes.
• Statistiques de joueurs et d'équipes : Accédez aux stats de saison et de carrière des joueurs (ex. : buts, passes décisives, apparitions, minutes, cartons, tirs) et aux stats liées aux équipes.
• Statistiques de matchs live et finalisées : Utilisez les endpoints pour les stats de matchs incluant tirs, expected goals (xG), possession, passes et événements minute par minute.
• Cotes (avant-match et live) : Récupérez les cotes avant-match et, pour les fixtures supportées, les cotes en direct via un endpoint live où live_odds_available est true.
• Analyses avancées : Extrayez les métriques d'expected goals et mesures sous-jacentes, incluant xG, non-penalty xG (npxG), xA, plus des analyses de matchs approfondies.
• Portée des compétitions et données structurées : Interrogez compétitions et saisons (avec sélection de la saison actuelle via matches the competition detail’s current_season_id) et récupérez des réponses JSON de 19 endpoints répartis en 5 catégories (Competitions, Teams, Matches, Players, Odds).

Comment utiliser TheStatsAPI

1. Démarrez un essai gratuit et testez les endpoints via la démo interactive (la documentation montre des exemples de requêtes et un workflow « Run API Call »).
2. Obtenez une clé API et authentifiez les requêtes avec un en-tête Authorization: Bearer YOUR_API_KEY.
3. Utilisez les routes de base documentées sous /api/football/* (par exemple, listes de compétitions ou stats de matchs).
4. Demandez la ressource spécifique dont vous avez besoin (compétitions, saisons, matchs, joueurs, cotes) et suivez les paramètres de pagination retournés par les endpoints.

Exemple d'appel affiché sur le site :

• GET /api/football/matches/mt_010249745/stats avec un token Bearer.

Cas d'usage

• Apps fantasy football : Construisez des fonctionnalités de scoring et de sélection de joueurs en utilisant les statistiques de saison/carrière des joueurs et les inputs de scoring match par match.
• Tableaux de scores match day : Affichez cotes en temps réel et stats de matchs live (incluant statut et mises à jour événementielles) pour les fixtures supportées par les données live.
• Analyses de paris et backtesting : Utilisez les données archivées de cotes avant-match avec les résultats historiques de matchs et métriques xG pour modéliser et analyser.
• Rapports de performance d'équipes et joueurs : Générez des tableaux de bord avec agrégats de saison et carrière (buts, passes décisives, minutes, cartons, tirs) plus contexte match et événements.
• Produits éditoriaux ou de données sportives : Enrichissez articles ou flux avec fixtures/résultats structurés et champs analytiques comme xG et npxG.

FAQ

TheStatsAPI fournit-elle des données live et finalisées ?

L'API fournit des stats de matchs live et finalisées (tirs, xG, possession, passes, cartons, buts et événements minute par minute), et inclut un endpoint de cotes live pour les matchs où live_odds_available est true.

Combien de compétitions sont disponibles ?

Le site indique 80 compétitions par défaut, avec jusqu'à 1 196 disponibles sur demande.

Quel format les endpoints renvoient-ils ?

La documentation précise que les endpoints renvoient du JSON propre et paginé.

Quels types de données puis-je interroger ?

Le site liste des endpoints et catégories pour compétitions, équipes, matchs, joueurs et cotes, incluant fixtures/résultats, statistiques de saison des joueurs et cotes avant-match/live.

Comment authentifier les requêtes ?

Les requêtes de la démo utilisent un en-tête Authorization Bearer token : Authorization: Bearer YOUR_API_KEY.

Alternatives

• Agrégateurs de données sportives avec APIs football : Les alternatives de même catégorie offrent généralement stats de matchs et données joueurs/fixtures en JSON, mais diffèrent en portée de couverture et disponibilité de cotes live/in-play.
• Plateformes analytiques/générales avec connecteurs sports : Elles peuvent offrir visualisation ou pipelines plus simples, mais nécessitent souvent des étapes supplémentaires pour extraire les mêmes champs d'événements match-level et xG.
• APIs de cotes orientées paris : Si votre besoin principal est les cotes (avant-match et/ou in-play), une API cotes-first simplifie l'accès, bien qu'elle n'inclue pas autant d'analyses match/événements et xG.
• Sources de données football ouvertes (sans cotes) : Pour équipes/joueurs/matchs sans cotes de bookmakers, les sources ouvertes conviennent, mais vous aurez besoin de sources séparées pour xG et cotes de paris.