TheStatsAPI

Was ist TheStatsAPI?

TheStatsAPI ist eine Football-Statistiken-API für Entwickler, die programmgesteuerten Zugriff auf Spieldaten, Spieler- und Teamstatistiken, Spielpläne/Ergebnisse und Wettquoten bietet. Sie ist dafür konzipiert, Anwendungen mit strukturierten Football-Daten zu versorgen, die als sauberes, paginiertes JSON von dokumentierten Endpunkten geliefert werden.

Die API umfasst standardmäßig Statistiken aus 80 Wettbewerben (bis zu 1.196 Wettbewerbe auf Anfrage verfügbar) und enthält sowohl historische Daten (mit 10 Jahren Abdeckung) als auch Live-Daten, wo verfügbar, wie In-Play-Spielquoten und Spielstatistiken.

Wichtige Funktionen

• Spielpläne und Ergebnisse: Abrufen von Spielplänen und historischen Ergebnissen für abgedeckte Wettbewerbe.
• Spieler- und Teamstatistiken: Zugriff auf Saison- und Karrierenstatistiken von Spielern (z. B. Tore, Assists, Einsätze, Minuten, Karten, Schüsse) sowie teambezogene Statistiken.
• Live- und finale Spielstatistiken: Nutzen von Endpunkten für Spielstatistiken inklusive Schüsse, erwartete Tore (xG), Ballbesitz, Pässe und minutenweise Events.
• Quoten (Vorab- und Live): Abrufen von Vorabquoten und für unterstützte Spiele In-Play-Quoten über einen Live-Endpunkt, wo live_odds_available true ist.
• Erweiterte Analysen: Abrufen von erwarteten-Tore-Metriken und zugrunde liegenden Maßen wie xG, Non-Penalty-xG (npxG), xA sowie tiefergehenden Spielanalysen.
• Wettbewerbsumfang und strukturierte Daten: Abfragen von Wettbewerben und Saisons (mit Auswahl der aktuellen Saison via matches the competition detail’s current_season_id) und Abrufen von JSON-Antworten aus 19 Endpunkten in 5 Kategorien (Competitions, Teams, Matches, Players, Odds).

So nutzen Sie TheStatsAPI

1. Starten Sie eine kostenlose Testphase und testen Sie Endpunkte mit dem interaktiven Demo (Dokumentation zeigt Beispielanfragen und „Run API Call“-Workflow).
2. Erhalten Sie einen API-Schlüssel und authentifizieren Sie Anfragen mit einem Authorization: Bearer YOUR_API_KEY-Header.
3. Nutzen Sie die dokumentierten Basispfade unter /api/football/* (z. B. Wettbewerbslisten oder Spielstatistiken).
4. Fordern Sie die benötigte Ressource an (Wettbewerbe, Saisons, Spiele, Spieler, Quoten) und folgen Sie den von Endpunkten zurückgegebenen Paginierungsparametern.

Beispielaufruf auf der Seite:

• GET /api/football/matches/mt_010249745/stats mit Bearer-Token.

Anwendungsfälle

• Fantasy-Football-Apps: Erstellen von Scoring- und Spielerauswahl-Features mit Saison-/Karrierenstatistiken von Spielern und spielweisen Scoring-Eingaben.
• Spieltags-Scoreboards: Anzeigen von Echtzeitquoten und Live-Spielstatistiken (inkl. Status und ereignisgesteuerten Updates) für von Live-Daten unterstützte Spiele.
• Wettanalysen und Backtesting: Nutzen der archivierten Vorabquoten-Daten neben historischen Spielergebnissen und xG-Metriken für Modellierung und Analysen.
• Team- und Spielerleistungsberichte: Generieren von Dashboards mit Saison- und Karriereaggregaten (Tore, Assists, Minuten, Karten, Schüsse) plus Spiel- und Event-Kontext.
• Redaktionelle oder Sportdaten-Produkte: Anreichern von Artikeln oder Feeds mit strukturierten Spielplänen/Ergebnissen und Analysenfeldern wie xG und npxG.

FAQ

Liefert TheStatsAPI Live- und finale Daten?

Die API bietet Live- und finale Spielstatistiken (Schüsse, xG, Ballbesitz, Pässe, Karten, Tore und minutenweise Events) sowie einen Live-Endpunkt für Spielquoten bei Spielen, wo live_odds_available true ist.

Wie viele Wettbewerbe sind verfügbar?

Die Seite gibt 80 Wettbewerbe standardmäßig an, mit bis zu 1.196 auf Anfrage verfügbar.

In welchem Format liefern die Endpunkte Daten?

Die Dokumentation vermerkt, dass Endpunkte sauberes, paginiertes JSON zurückgeben.

Welche Datenarten kann ich abfragen?

Die Seite listet Endpunkte und Kategorien für Wettbewerbe, Teams, Spiele, Spieler und Quoten auf, inklusive Spielpläne/Ergebnisse, Saisonstatistiken von Spielern und Vorab-/Live-Quoten.

Wie authentifiziere ich Anfragen?

Anfragen im Demo verwenden einen Authorization-Bearer-Token-Header: Authorization: Bearer YOUR_API_KEY.

Alternativen

• Sportdaten-Aggregatoren mit Football-APIs: Alternativen in derselben Kategorie bieten typischerweise Spielstatistiken und Spieler-/Spielplandaten als JSON, unterscheiden sich aber im Abdeckungsumfang und der Verfügbarkeit von Live-Quoten/In-Play-Feeds.
• Allgemeine Analysen-/Datenplattformen mit Sport-Connectors: Diese bieten oft einfachere Visualisierung oder Pipelines, erfordern aber zusätzliche Schritte, um dieselben spielweisen Event- und xG-Felder zu extrahieren.
• Wettquoten-fokussierte Odds-APIs: Wenn Ihr Hauptbedarf Quoten (Vorab und/oder In-Play) sind, vereinfacht eine Odds-zuerst-API den Zugriff, bietet aber möglicherweise nicht so breite Spiel-/Event- und xG-Analysen.
• Offene Football-Datenquellen (ohne Quoten): Für Teams/Spieler/Spiele ohne Buchmacherquoten passen offene Quellen, aber Sie benötigen wahrscheinlich separate Quellen für xG und Wettquoten.