Quickest Start

Here is the quickest way to get to your football data:

Get the Token

Go to https://www.football-data.org/client/register to get your free API Token.

Install the Gem

Add this line to your application’s Gemfile:

gem 'football-butler'

And then execute:

$ bundle install

Use the Console

Set the Token:

rails c
FootBall::Butler::Configuration.reconfigure(api_token: <YOUR_API_TOKEN>)

Get all matches of current Bundesliga season:

Football::Butler::Matches.by_competition(id: 2002)

Have Fun!