はじめに
いよいよワールドカップが開幕しますね！応援している国や、注目している選手の所属チームのスタッツを自分でこねくり回したくなったことはありませんか？
今回は、サッカーデータの宝庫である海外の有料・無料API「API-FOOTBALL」を使って、世界中のサッカーチーム情報をPythonでサクッと取得する方法を解説します。W杯直前のデータ分析アプリ作成や、Bot開発の参考にしてください！
api-footballの公式URLはこちらから👇
api-footballで出来ること
- 試合日程・結果： 過去の試合結果はもちろん、今後数ヶ月先までの全リーグの試合スケジュールを取得できます
- リーグごとのチームの正式名称、創立年、スタジアムのキャパシティ、チームのロゴ画像のURLなどが手に入ります
- ワールドカップ出場国の詳細などを取得できます
api-footballのメリット
- クレジットカード不要でAPIキーを利用することができる
- チームのロゴURLまで取得できるのでフロントエンドで表示することができる
使い方
pythonでのコード例
url = "https://v3.football.api-sports.io/leagues"
payload={}
headers = {
'x-apisports-key': 'YOUR_API_KEY_HERE',
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
現在行われてる試合の情報の取得
import requests
# URLの最後を「fixtures」にして、パラメータに「live=all」を指定
url = "https://v3.football.api-sports.io/fixtures?live=all"
headers = {
'x-apisports-key': 'あなたのAPIキー',
}
response = requests.request("GET", url, headers=headers)
print(response.text)
特定のリーグのチームを取得
import requests
# URLの最後を「teams」にして、リーグIDとシーズンを指定
url = "https://v3.football.api-sports.io/teams?league=39&season=2025"
payload = {}
headers = {
'x-apisports-key': 'あなたのAPIキー', # ここをご自身のキーに書き換えてください
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
主要リーグのリーグID一覧
| 国 / 大会 | リーグ・大会名 | リーグID (league) |
|---|---|---|
| 🏴 イングランド | プレミアリーグ (Premier League) | 39 |
| 🇪🇸 スペイン | ラ・リーガ (La Liga) | 140 |
| 🇮🇹 イタリア | セリエA (Serie A) | 135 |
| 🇩🇪 ドイツ | ブンデスリーガ (Bundesliga) | 78 |
| 🇫🇷 フランス | リーグ・アン (Ligue 1) | 61 |
| 🇯🇵 日本 | J1リーグ (J1 League) | 98 |
| 🇪🇺 欧州カップ戦 | UEFAチャンピオンズリーグ (UCL) | 2 |
| 🏳️ 国際大会 | ワールドカップ (World Cup) | 1 |
APIキー取得方法(クレカ不要)
-
アカウント登録はまず行います。Googleログインおすすめです
-
次にクイックアクセスからfootballを選びます
-
footballの欄からLiveDemoのページを選択するとAPIキーを見ることができます(デフォルトでAPIキーは作成されています)
終わりに
実は無料枠での利用だと今年2026年のワールドカップのデータが取得できないです💦
ナショナルチームのデータ取得なども行えるので、もし今年のワールドカップのチームデータを取得したい場合には公式ドキュメントから国IDなどを見つけることをお勧めします！