リーグ戦

試合を取得する

GEThttps://api.football-data-api.com/league-matches?key=YOURKEY&season_id=1

以下のURLにアクセスしてサンプルレスポンスを取得。
https://api.football-data-api.com/league-matches?key=example&season_id=2012

このエンドポイントは、選択したリーグIDの全試合スケジュールを返します。レスポンスは、各試合の詳細を含むJSON配列になります。デフォルトでは、ページごとに300試合が返されます。返される試合の数を増やすには、&max_per_page=X（例：&max_per_page=500）を設定します。

クエリパラメータ

名前

タイプ

説明

page

整数(integer)

例：'&page=2'。ページネーション。デフォルトでは、各ページには最大で500試合が表示されます。次の500試合を表示する場合は、&page=2 または &page=3 などを追加します。

max_per_page

整数(integer)

例：'&max_per_page=500'。ページごとに返される試合数を増やします。最大1000まで増やせます。

max_time

整数(integer)

UNIXタイムスタンプ。特定の時間までのリーグおよびチームの統計をAPIに返す場合は、この番号を設定します。例：&max_time=1537984169 と入力すると、APIは2018年9月26日時点の統計を返します。

key*

文字列(String)

APIキー

season_id*

整数(integer)

取得したいリーグシーズンのID

200すべてのリーグの取得に成功

隠す ↑

コピーする

表示↓

クエリとパラメータ

APIキーを 'example' として使用することで、イングランドプレミアリーグ2018/2019シーズン（ID：1625）を使用してエンドポイントをテストできます。

変数名

説明

試合のID。リーグマッチエンドポイントから試合のIDを取得してください。

homeID

ホームチームID

awayID

アウェイチームID

season

リーグのシーズン

status

試合の状態（'完了', '中断', '中止', '未完了'）

roundID

シーズン内の試合のラウンドID

game_week

シーズン内の試合のゲームウィーク

homeGoals

ホームチームのゴールのタイミング。配列

awayGoals

アウェイチームのゴールのタイミング。配列

homeGoalCount

ホームチームのゴール数

awayGoalCount

アウェイチームのゴール数

totalGoalCount

試合全体のゴール数

team_a_corners

ホームチームのコーナーキック数

team_b_corners

アウェイチームのコーナーキック数

team_a_offsides

オフサイド数 - ホームチーム

team_b_offsides

オフサイド数 - アウェイチーム

team_a_yellow_cards

イエローカード枚数 - ホームチーム

team_b_yellow_cards

イエローカード枚数 - アウェイチーム

team_a_red_cards

レッドカード枚数 - ホームチーム

team_b_red_cards

レッドカード枚数 - アウェイチーム

team_a_shotsOnTarget

枠内シュート数 - ホームチーム

team_b_shotsOnTarget

枠内シュート数 - アウェイチーム

team_a_shotsOffTarget

枠外シュート数 - ホームチーム

team_b_shotsOffTarget

枠外シュート数 - アウェイチーム

team_a_shots

シュート数 - ホームチーム

team_b_shots

シュート数 - アウェイチーム

team_a_fouls

ファウル数 - ホームチーム

team_b_fouls

ファウル数 - ホームチーム

team_a_possession

ポゼッション率 - ホームチーム

team_b_possession

ポゼッション率 - アウェイチーム

refereeID

この試合の審判ID

coach_a_ID

ホームチームの監督ID

coach_b_ID

アウェイチームの監督ID

stadium_name

スタジアム名

stadium_location

スタジアム所在地

team_a_cards_num

ホームチームのカード枚数

team_b_cards_num

アウェイチームのカード枚数

odds_ft_1

フルタイムでのホームチーム勝利のオッズ

odds_ft_x

フルタイムでの引き分けのオッズ

odds_ft_2

フルタイムでのアウェイチーム勝利のオッズ

odds_ft_over05 - odds_ft_over45

オーバー0.5〜4.5ゴールのオッズ

odds_ft_under05 - odds_ft_under45

アンダー0.5〜4.5ゴールのオッズ

odds_btts_yes / no

BTTS（両チーム得点）Yes/Noのオッズ

odds_team_a_cs_yes / a_cs_no / b_cs_yes / b_cs_no

ホームおよびアウェイチームのクリーンシートYes/Noのオッズ

overallGoalCount

1試合の総得点数

ht_goals_team_a

前半終了時のホームチームの得点数

ht_goals_team_b

前半終了時のアウェイチームの得点数

HTGoalCount

前半終了時の総得点数

date_unix

試合開始のUNIXタイムスタンプ

winningTeam

勝利したチームのID。引き分けの場合は-1

no_home_away

この試合にホームまたはアウェイの区別がない場合は1に設定

btts_potential

両チームのBTTSのプレマッチ統計。両チーム間の平均。

o15_potential - o45_potential

両チームの試合前オーバー1.5 - 4.5統計。両チームの平均

o05HT_potential - o15HT_potential

両チームの試合前前半オーバー0.5 - 1.5統計。両チームの平均

corners_potential

両チームの試合前平均コーナーキック数

offsides_potential

両チームの試合前平均オフサイド数

cards_potential

両チームの試合前平均カード数

avg_potential

両チームの試合前平均総得点数

corners_o85_potential - corners_o105_potential

両チームの試合前オーバーXコーナー

u15_potential - u45_potential

両チームの試合前アンダー1.5 - 4.5統計。両チームの平均

home_ppg

現在のホームチーム1試合平均勝ち点数

away_ppg

現在のアウェイチーム1試合平均勝ち点数

pre_match_home_ppg

試合前のホームチーム1試合平均勝ち点数

pre_match_away_ppg

試合前のアウェイチーム1試合勝ち点数

competition_id

リーグのシーズンID

over05 - over55

試合がオーバーXゴールで終了した場合はtrueに設定

btts

試合がBTTSで終了した場合はtrueに設定

前へリーグ統計次へリーグのチーム