À propos de l'API football SportAPI
SportAPI est une API football pour les développeurs qui ont besoin de données de match structurées sans assembler plusieurs sources. C'est un service REST JSON qui couvre le football uniquement : calendrier, scores en direct, classements, équipes, joueurs, événements du match, compositions et statistiques de match. Il convient aux applications de scores en direct, jeux de fantasy, sites de clubs, bots et tableaux de bord analytiques.
Les données retournées par l'API football
L'API de données football est organisée en calendrier, ligues, équipes, joueurs et classements. Chaque endpoint est une requête GET simple qui retourne du JSON, donc il s'analyse dans n'importe quel langage. Un objet calendrier contient l'identifiant du match, la date et l'heure, le statut (Scheduled, LIVE, HT, FT, AET, PENS), la minute actuelle, les équipes à domicile et à l'extérieur, les scores et la phase de la compétition. Parce que chaque état de match utilise les mêmes champs, votre interface n'a pas besoin de cas spéciaux. La référence des endpoints liste chaque paramètre.
Scores en direct et événements du match
Une API de scores en direct n'est utile que si elle est fraîche. SportAPI actualise les scores en direct toutes les minutes pendant les matchs. Les buts, les passes décisives, les cartons jaunes et rouges et les changements sont stockés en tant qu'événements du match avec le joueur, le côté de l'équipe et la minute. Les compositions, les passes décisives, les cartons et les statistiques des joueurs sont ajoutés environ une heure après le coup de sifflet final.
Si vous ne voulez pas faire de polling, connectez-vous à l'endpoint WebSocket à wss://sportapi.ai/ws?key=YOUR_API_KEY. Il pousse les mises à jour de score vers votre client, généralement 30 à 60 secondes après un but. Vous pouvez également consulter les mêmes données sur la page des scores en direct.
Calendrier, classements et API statistiques football
L'API football de calendrier retourne tous les matchs d'une date donnée, et les endpoints de match unique vous donnent les événements, les compositions et les statistiques. L'API football de classement retourne le tableau complet : position, matchs joués, gagnés, nuls, perdus, buts marqués et encaissés, différence de buts, points et forme récente. Chaque classement de ligue sur ce site est construit à partir des mêmes données.
L'API statistiques football donne les statistiques d'équipe par match : tirs, tirs cadrés, tirs non cadrés, fautes, passes, précision des passes, tacles, réussite aux tacles, arrêts et cartons jaunes. Les fiches joueurs ajoutent les minutes jouées, les buts, les passes décisives, les tirs, les occasions créées et les tacles. Les meilleurs buteurs, les meilleures passes et les plus de cartons sont disponibles pour chaque ligue, ainsi que l'historique des confrontations directes pour n'importe quelle paire d'équipes.
Couverture de l'API football
L'API couvre 117 ligues et coupes dans 41 pays et régions, avec plus de 4 800 équipes, 32 000 matchs, 25 000 joueurs et 100 000 événements de match. La couverture inclut la Premier League, La Liga, Serie A, Bundesliga, Ligue 1, Eredivisie, la Ligue des Champions, la Ligue Europa et la Ligue Conférence, les ligues des nations UEFA et Concacaf, la MLS, la Liga MX, la Serie A brésilienne, la Saudi Pro League et la J1 League. Les divisions inférieures anglaises, les coupes nationales, les compétitions féminines et les matchs d'équipes nationales sont également inclus. Consultez la page de couverture pour la liste complète.
Des données détaillées dépendent de la source. Les compositions, les passes décisives, les cartons et les statistiques des joueurs existent pour les compétitions couvertes en détail par notre source de données. Pour certaines compétitions mineures, vous obtenez uniquement le score, le statut et les buts.
Commencez en trois étapes
Premièrement, créez un compte gratuit sur la page d'inscription avec votre email ou Google et générez une clé sous My Access. Les clés commencent par sk_live_. Deuxièmement, envoyez la clé dans l'en-tête X-Api-Key. Troisièmement, appelez un endpoint :
curl "https://sportapi.ai/api/fixtures/date/2026-10-08" \
-H "X-Api-Key: YOUR_API_KEY"La démo en direct vous permet d'essayer les endpoints avec votre clé avant d'écrire du code. Gardez la clé sur votre serveur, pas dans le code du navigateur.
Offre gratuite et offres payantes
L'offre gratuite de l'API football permet 2 000 requêtes par jour (14 000 par mois) avec une clé. Starter est à $10/mois pour 10 000 requêtes quotidiennes, Pro à $25 pour 50 000 requêtes et trois clés, Business à $50 pour 200 000 requêtes et dix clés. Tous les plans incluent tous les endpoints et ligues. La limite s'applique par clé et se réinitialise à 00:00 UTC. Chaque appel compte comme une requête, même en erreur, et l'API répond HTTP 429 une fois la limite atteinte. Comparez les options sur la page tarifaire.
Au cours des 30 derniers jours, le temps de réponse médian était d'environ 22 ms, et la plupart des requêtes ont été traitées en moins de 100 ms.
Ce que l'API football ne fait pas
SportAPI ne fournit pas de cotes de paris, d'expected goals (xG), de pourcentages de possession ou de photos de joueurs, et elle couvre uniquement le football. Il n'y a pas encore de SDK officiels ni de webhooks, et aucune garantie de disponibilité. Si votre produit a besoin de ces fonctionnalités, prévoyez d'ajouter une autre source. Pour les scores, le calendrier, le classement, les événements et les statistiques de match de base, il s'agit d'une base complète et simple.