今天的比賽（按天分配的比賽）

獲取按日期排列的比賽列表

獲取今日比賽的列表，有或沒有統計數據

GEThttps://api.football-data-api.com/todays-matches?key=YOURKEY

範例回應 (訪問以下網址)
https://api.football-data-api.com/todays-matches?key=example

您必須在設置中選擇聯賽，才能在此顯示比賽。
返回每頁最多500場比賽。分頁功能預設啟用。添加&page=2開始分頁。

查詢參數

名稱。

類型

描述

timezone

字串

時區。即 &timezone=Europe/London。使用 TZ 時區名稱：https://en.wikipedia.org/wiki/List_of_tz_database_time_zones。如果未指定，則默認為 Etc/UTC。

date

字串

日期格式 = YYYY-MM-DD。例如 &date=2020-07-30。如果未輸入，則默認為 UTC 時區的當前日期。

key*

字串

您的 API 密鑰

200 成功檢索所有聯賽。

隱藏 ↑

複製

顯示↓

變數名稱

描述

比賽的ID

homeID

主隊ID

awayID

客隊 id.

season

聯賽的賽季年份。

status

聯賽狀態。

roundID

回合 ID.

game_week

比賽周數。

revised_game_week

修訂比賽週 -1 是預設值，意味著沒有修訂。

homeGoals

主隊的進球時間。

awayGoals

進球時間對於客隊。

homeGoalCount

主隊進球數。

awayGoalCount

Away 球隊進球數。

totalGoalCount

比賽中進了多少球。

team_a_corners

角球數對於主隊，-1 是預設值。

team_b_corners

角球數為Away球隊，-1為預設值。

totalCornerCount

比賽中的角球數量。

team_a_offsides

越位次數（Home隊）。

team_b_offsides

越位次數 (away 隊).

team_a_yellow_cards

主隊得到的黃牌。

team_b_yellow_cards

客隊黃牌數。

team_a_red_cards

主場球隊的紅牌數。

team_b_red_cards

客隊出示的紅牌。

team_a_shotsOnTarget

主隊射門命中，默認為-1。

team_b_shotsOnTarget

客隊射正次數，-1 為默認值。

team_a_shotsOffTarget

主隊射偏次數，預設為-1。

team_b_shotsOffTarget

客隊射偏次數，-1 為預設值。

team_a_shots

主隊總射門次數，默認為-2。

team_b_shots

客隊的總射門次數，-2 是預設值。

team_a_fouls

主隊犯規次數，-1 是預設值。

team_b_fouls

客隊犯規次數，-1 為預設值。

team_a_possession

控球率為主隊，-1為預設值。

team_b_possession

控球率為Away球隊，預設為-1。

refereeID

裁判的ID。

coach_a_ID

主隊教練的ID。

coach_b_ID

客隊教練的ID。

stadium_name

體育場名稱。

stadium_location

體育場位置。

team_a_cards_num

主隊收到的總黃牌數。

team_b_cards_num

總計由Away隊得到的黃牌數。

odds_ft_1

主隊在全場比賽中獲勝的賠率。

odds_ft_X

平局全場賠率。

odds_ft_2

客隊在全場比賽中獲勝的賠率。

上一個國家列表下一個聯賽統計