TheStatsAPI

TheStatsAPIとは？

TheStatsAPIは、開発者向けサッカー統計APIで、試合データ、選手・チーム統計、日程/結果、ベッティングオッズへのプログラムアクセスを提供します。構造化されたサッカー データ を、ドキュメント化されたエンドポイントからクリーンでページネーションされたJSONとして配信するアプリケーションを駆動するよう設計されています。

APIはデフォルトで80競技をカバー（リクエストで最大1,196競技可能）し、履歴データ（10年間のカバレッジとして記載）と利用可能なライブデータを備えています。例えば、試合中オッズや試合統計です。

主な機能

• 試合日程と結果: カバーされた競技のフィクスチャリストと履歴結果を取得。
• 選手・チーム統計: シーズン・キャリア選手統計（例: ゴール、アシスト、出場、プレー時間、カード、シュート）とチーム関連統計にアクセス。
• ライブ・確定試合統計: シュート、期待ゴール（xG）、ポゼッション、パス、分単位イベントを含む試合統計エンドポイントを使用。
• オッズ（プレマッチ・ライブ）: プレマッチオッズを取得し、サポートされたフィクスチャではlive_odds_availableがtrueのライブエンドポイントで試合中オッズを取得。
• 高度な分析: xG、非PK xG（npxG）、xAなどの期待ゴール指標と関連メトリクス、詳細な試合分析を取得。
• 競技範囲と構造化データ: 競技・シーズンをクエリ（matches the competition detail’s current_season_idで現シーズン選択）、5カテゴリ（Competitions, Teams, Matches, Players, Odds）の19エンドポイントからJSONレスポンスを取得。

TheStatsAPIの使い方

1. 無料トライアルを開始し、インタラクティブデモでエンドポイントをテスト（ドキュメントにサンプルリクエストと「Run API Call」ワークフローを表示）。
2. APIキーを取得し、Authorization: Bearer YOUR_API_KEYヘッダーでリクエストを認証。
3. ドキュメント化されたベースルート /api/football/* を使用（例: 競技リストや試合統計）。
4. 必要なリソース（競技、シーズン、試合、選手、オッズ）をリクエストし、エンドポイントが返すページネーションパラメータに従う。

サイトに表示された例コール:

• GET /api/football/matches/mt_010249745/stats にBearerトークン付き。

ユースケース

• ファンタジーサッカーアプリ: 選手シーズン/キャリア統計と試合ごとのスコアリングでスコアリング・選手選択機能を作成。
• 試合当日スコアボード: ライブデータ対応フィクスチャでリアルタイムオッズとライブ試合統計（ステータス・イベント駆動更新含む）を表示。
• ベッティング分析・バックテスト: 過去プレマッチオッズデータを履歴試合結果・xGメトリクスと併用し、モデル・分析を支援。
• チーム・選手パフォーマンスレポート: シーズン・キャリア集計（ゴール、アシスト、プレー時間、カード、シュート）と試合・イベントコンテキストでダッシュボード生成。
• 編集・スポーツデータ製品: 構造化フィクスチャ/結果とxG、npxGなどの分析フィールドで記事やフィードを強化。

FAQ

TheStatsAPIはライブデータと確定データを返しますか？

APIはライブ・確定試合統計（シュート、xG、ポゼッション、パス、カード、ゴール、分単位イベント）を提供し、live_odds_availableがtrueの試合向けライブ試合オッズエンドポイントも含みます。

利用可能な競技数は？

サイトではデフォルト80競技、リクエストで最大1,196競技と記載。

エンドポイントの返却形式は？

ドキュメントでクリーンでページネーションされたJSONと記載。

どのようなデータをクエリできますか？

サイトで競技、チーム、試合、選手、オッズのエンドポイント・カテゴリをリスト、日程/結果、選手シーズン統計、プレマッチ/ライブオッズを含む。

リクエストの認証方法は？

デモのリクエストはAuthorization Bearerトークンヘッダーを使用: Authorization: Bearer YOUR_API_KEY。

代替案

• サッカーAPI付きスポーツデータアグリゲータ: 同カテゴリの代替は通常JSONで試合統計・選手/フィクスチャデータを提供するが、カバレッジ範囲やライブオッズ/試合中フィードの可用性が異なる可能性。
• スポーツコネクタ付き汎用分析/データプラットフォーム: 可視化やパイプラインが容易だが、同等の試合レベルイベント・xGフィールド抽出に追加ステップが必要。
• ベッティング特化オッズAPI: 主にオッズ（プレマッチ/試合中）が必要なら、オッズ優先APIがアクセスを簡素化するが、試合/イベント・xG分析の幅が狭い可能性。
• ブックメーカーオッズなしオープンサッカー データソース: チーム/選手/試合でオッズ不要なら適合するが、xGやベッティングオッズには別ソースが必要。