【サッカー付き必見】footaball-data.orgが提供するサッカーAPI

に公開

対象読者・こんな人におすすめ

  • リーグ問わずサッカーが好きなエンジニア
  • サッカー関連の個人開発をしたいエンジニア

football-data.org

Purpose of the project
football-data.org provides football data and statistics (live scores, fixtures, tables, squads, lineups/subs, etc.) in a machine-readable way.
I won't announce how awesome football-data is, you're welcome to find out by yourself (or not). Access to the top competitions is and will be free forever as this was the initial purpose to setup the project.
However if you need more competitions, in-depth data there are several paid plans available to serve your needs. If you need historical data, more requests or something out of the box just drop me a line, I'm glad to help.

プロジェクトの目的
football-data.orgはサッカーのデータやリアルタイムのスコア、試合、順位、スカッド、フォーメーションなどの統計を機械が読み取れる方式で提供します。
football-data.orgがどれほどすごいか私は宣伝しません。あなた自身で見つけてください
主要リーグ/大会へのアクセスは永遠に無料です。これはこのプロジェクトの最初の目的でした。
しかし、さらなるリーグ/大会、詳細なデータが必要な場合はいくつかのプランがあります。
過去のデータや要望があるときは連絡してください。喜んで助けます。

このような目的で作成されたfootball-data.orgはDaniel Freitagさんが2011年に作成した、サッカーのデータを扱う外部APIです。
上記にあるように、基本的に主要なリーグの情報については無料で取得することができます。
実際に私が大好きなTottenham Hotspurの情報も取得することができました。


主要なものは基本無料で取得することができるのでここでは詳細の説明はしませんが、料金としてはいくつか種類があり、課金すればかなりのデータを取得することができそうです。

実際に使用してみた

https://www.football-data.org/client/register
まずはここから登録をしてAPIキーを取得します
送られてきたメールのURLを開くことでAPIキーを取得できます(赤く隠されているところにあなたのAPIキーがでます)

https://www.football-data.org/documentation/quickstart
これを使用してデータを取得しましょう!
documentationページに例がいくつか載っているので実際にデータを取得してみました。
こちらをターミナルで実行することでプレミアリーグのチーム一覧をJSONで取得することができます

 curl -X GET \
    https://api.football-data.org/v4/competitions/PL/teams \
    -H 'X-Auth-Token: APIキー'

こちらからは任意のチームの詳細な情報を取得できます

 curl -X GET \
    https://api.football-data.org/v4/teams/{id} \
    -H 'X-Auth-Token: APIキー'

これらを組み合わせて実装することでチーム一覧からクリックしたチームの選手情報を見るページを実装することができます。

ここではプレミアリーグを例としましたが、5大リーグは全てアクセスできるので好きなチームの情報を取得してみましょう

メリット

実際にfootball-data.orgを使用して良かったところをいくつか挙げます

  • 基本的に無料で使うことができる
    • これが一番大きいと思います。従量課金制でもないので無意識のうちにお金を使い込むこともないは良いです(私は他のAPIでやらかしました)
  • 無料で最新のデータを取得することができる
    • サッカーのAPIはいくつかありますが、無料の場合最新シーズンのデータを取得できないことが多いです
  • 無料で主要5大リーグのデータを取得することができる
    • こちらも同じくで、他のAPIでは無料で主要5大リーグのデータにアクセスできないということが多いです

デメリット

しかしいくつかデメリットがあることも理解しておく必要もあるでしょう。

  • 1分間で10リクエストしかできない
    • 大規模なアプリを制作するには向いていないです。何かしらのプランに加入することで解決することはできるでしょう
  • このプロジェクトは副業に過ぎない
    • small side businessと明言されている通り、サポート体制には期待できないと考えています

無料では選手の得点数などを取得することができない、ポジションの分け方が少し不自然に感じるなど実際に使用してみて違和感を感じる部分がいくつかありますが、副業に過ぎないことも考えると目を瞑る方が良い気がします

まとめ

football-data.orgは基本無料主要5大リーグ最新データにアクセスすることができる外部APIでした。
個人開発でサッカー関連のアプリケーションを作りたいと考えている方には是非とも使っていただきたいです。

サッカーとプログラミングの両方が好きな方なら、まずは無料で試してみることをおすすめします。あなたの好きなチームのデータを使って、何か面白いアプリケーションを作ってみてはいかがでしょうか。きっと新しい発見や楽しみが見つかるはずです。

Discussion