TheStatsAPI

TheStatsAPI 是什麼？

TheStatsAPI 是一款專為開發者設計的足球統計 API，提供程式化存取比賽資料、球員與球隊統計、賽程/賽果，以及投注盤口。它旨在驅動需要結構化足球資料的應用程式，以乾淨、分頁的 JSON 格式從文件化端點交付。

API 預設涵蓋 80 個賽事（可依需求擴充至 1,196 個賽事），包含歷史資料（涵蓋 10 年）和可用即時資料，例如賽中盤口與比賽統計。

主要功能

• 賽程與賽果：擷取涵蓋賽事的賽程清單與歷史賽果。
• 球員與球隊統計：存取球員賽季與生涯統計（例如進球、助攻、出場、分鐘、卡片、射門）及球隊相關統計。
• 即時與完賽比賽統計：使用端點取得比賽統計，包括射門、預期進球 (xG)、控球率、傳球及逐分鐘事件。
• 盤口（賽前與即時）：擷取賽前盤口，以及支援賽事的賽中盤口（透過即時端點，當 live_odds_available 為 true 時）。
• 進階分析：擷取預期進球指標及相關底層數據，包括 xG、非點球 xG (npxG)、xA，以及更深入的比賽分析。
• 賽事範圍與結構化資料：查詢賽事與賽季（可透過 matches the competition detail’s current_season_id 選取當前賽季），並從 19 個端點（橫跨 5 類別：賽事、球隊、比賽、球員、盤口）取得 JSON 回應。

如何使用 TheStatsAPI

1. 啟用免費試用，使用互動示範測試端點（文件顯示範例請求與「執行 API 呼叫」流程）。
2. 取得 API 金鑰，使用 Authorization: Bearer YOUR_API_KEY 標頭驗證請求。
3. 使用文件化基礎路由，位於 /api/football/*（例如賽事清單或比賽統計）。
4. 請求所需特定資源（賽事、賽季、比賽、球員、盤口），並遵循端點回傳的分頁參數。

網站顯示範例呼叫：

• GET /api/football/matches/mt_010249745/stats 搭配 Bearer 權杖。

使用情境

• Fantasy football 應用：使用球員賽季/生涯統計及逐場得分輸入，建構計分與球員選拔功能。
• 比賽日計分板：顯示即時盤口與即時比賽統計（包含狀態與事件驅動更新），適用於支援即時資料的賽事。
• 投注分析與回測：搭配歷史賽果與 xG 指標，使用封存賽前盤口資料支援建模與分析。
• 球隊與球員表現報告：使用賽季與生涯彙總（進球、助攻、分鐘、卡片、射門）加上比賽與事件脈絡，產生儀表板。
• 編輯或體育資料產品：以結構化賽程/賽果及分析欄位（如 xG 與 npxG）豐富文章或饋送。

常見問題

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 與投注盤口可能需額外來源。