Exploring the football-data.org API in JavaScript

If you're a football enthusiast and are looking for a reliable API to get football-related data, then the football-data.org API is definitely worth exploring. This API provides access to various football-related data such as league standings, fixtures, players and more.

In this article, we will explore how to use the football-data.org API in JavaScript. We will also look at a few examples that demonstrate how to consume data from the API.

How to Get a Football-Data.org API Token

1. Register for free at https://www.football-data.org/client/register with your name and email.
2. Your API token is emailed to you and shown in your account area.
3. Send it in the X-Auth-Token header on every request.

The free tier allows 10 requests per minute and covers 12 top competitions (including the Premier League, La Liga, Serie A, Bundesliga, Ligue 1, and the Champions League) with fixtures, results, and standings. Paid tiers add more competitions, live scores, and deeper data — see https://www.football-data.org/pricing.

Use the current v4 API (https://api.football-data.org/v4); v2 still works but is deprecated.

curl https://api.football-data.org/v4/competitions/PL/standings \
  -H "X-Auth-Token: YOUR_API_TOKEN"

If you exceed the free rate limit you'll get HTTP 429 with headers telling you how long to wait, so space out calls or cache responses. The token is tied to your account — keep it server-side rather than embedding it in a public page.

Making API requests

To make HTTP requests to the football-data.org API, we can use various HTTP libraries available in JavaScript such as Axios or the built-in Fetch API.

Here is an example using Axios:

import axios from 'axios';

const API_TOKEN = 'YOUR_API_TOKEN';
const baseUrl = 'http://api.football-data.org/v2';

/**
 * Example function to get league standings.
 */
async function getLeagueStandings(leagueId) {
  const url = `${baseUrl}/competitions/${leagueId}/standings`;
  try {
    const response = await axios.get(url, {
      headers: {
        'X-Auth-Token': API_TOKEN
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

// Call the function with the league ID
getLeagueStandings(2021); // Premier League

In this example, we are making a GET request to the standings endpoint of the Premier League using Axios. We are passing our API token in the headers of the request. Once the request is successful, the data is logged to the console.

Example API calls

Here are a few more examples of how to make API requests to the football-data.org API using JavaScript.

Get all competitions

async function getAllCompetitions() {
  const url = `${baseUrl}/competitions`;
  try {
    const response = await axios.get(url, {
      headers: {
        'X-Auth-Token': API_TOKEN
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

getAllCompetitions();

In this example, we are making a GET request to the competitions endpoint to get all available competitions.

Get the details of a single competition

async function getCompetitionDetails(competitionId) {
  const url = `${baseUrl}/competitions/${competitionId}`;
  try {
    const response = await axios.get(url, {
      headers: {
        'X-Auth-Token': API_TOKEN
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

getCompetitionDetails(2021); // Premier League

In this example, we are making a GET request to the competitions endpoint to get the details of a single competition, which in our case is the Premier League.

Get fixtures of a specific team

async function getTeamFixtures(teamId) {
  const url = `${baseUrl}/teams/${teamId}/matches`;
  try {
    const response = await axios.get(url, {
      headers: {
        'X-Auth-Token': API_TOKEN
      }
    });
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

getTeamFixtures(57); // Arsenal FC

In this example, we are making a GET request to the teams endpoint to get all fixtures of a specific team, which in our case is Arsenal FC.

Conclusion

As we have seen, the football-data.org API is a powerful and useful tool for getting football-related data. Using JavaScript, we can easily consume the API by making HTTP requests to its various endpoints.

We have explored a few examples of using the API, but there are many more endpoints available to explore. Be sure to check out the API documentation for more information.