-
Now that your test call works, try an endpoint that returns real football data. An account is not required as the API calls listed below are all test keys.
-
This example uses the League Teams endpoint for the Premier League season.
-
The response includes teams, table positions, team page URLs and detailed team stats.
Open the Premier League Team Stats Endpoint
GEThttps://api.football-data-api.com/league-teams?key=example&season_id=12325&include=stats
This example returns Premier League teams with stats. In this example, season_id=12325 is the selected Premier League season which is 2024/2025 season.
Below is a shortened example of the response returned by this API call.
200 Successfully retrieved league teams.
Hide ↑
Copy
Show↓
This page only explains the basic response structure. For the full list of team fields and stats fields, see the League Teams endpoint documentation in the sidebar.
Open the League Season Stats Endpoint
GEThttps://api.football-data-api.com/league-season?key=example&season_id=12325
This example returns league and season statistics for the Premier League. In this example, season_id=12325 refers to the 2024/2025 Premier League season.
Open the League Matches Endpoint
GEThttps://api.football-data-api.com/league-matches?key=example&season_id=2012
This example returns matches from the 2024/2025 Premier League season. Here, season_id=12325 refers to that season.
Open the League Player Stats Endpoint
GEThttps://api.football-data-api.com/league-players?key=example&season_id=2012&include=stats
This example returns players from the 2024/2025 Premier League season with detailed player statistics. The stats are included because include=stats was added to the API call.
To test another API call, click any endpoint in the sidebar. Each endpoint page shows a sample URL that you can open in your browser.