Frequently Asked Questions

Coverage, historical data, betting odds, live data, licensing, and how to test the FootyStats API.

1. Data Coverage

What data is available in the FootyStats API?

The FootyStats API provides detailed football data, including league, team, player and match statistics.

Available statistics include goals, corners, cards, shots, shots on target, possession, xG, offsides, H2H statistics, betting odds and more.

Data availability varies depending on the league and competition.

For more details, check out the data on each of the league's page on FootyStats itself.

Does every league provide the same statistics?

No. Each league has its own data coverage.

You can check the statistics available for a specific league directly on FootyStats by visiting its league page.

For example: English Premier League Statistics.

How can I check which leagues and seasons are available?

You can view the list of available leagues and seasons on our Leagues page. Go to each league's page and check the season year dropdown to see the historical coverage.

You can also use the League List API endpoint to retrieve available leagues and their unique IDs.

Can the chosen leagues be changed later, and how often?

Yes you can change your league selection at any time from your user settings.

How long after full-time are match stats usually available?

Usually within 20 minutes.

2. Historical Data

How much historical data is available?

It depends on the league. Each competition has its own historical coverage.

To check a specific league, open its page on FootyStats. For example: English Premier League. At the top left, next to the league logo, open the season menu. That menu lists every season we have for that league.

The oldest match data we hold goes back to 2007. Many leagues start later than that, so use the season menu to see the exact range for the league you need.

Can I download historical football statistics?

Yes. You can retrieve historical match, team and league statistics through the API, depending on data availability.

For more information, check our API Documentation.

3. Betting Odds

What odds are available through the API?

The FootyStats API provides odds for various markets, including:

  • 1X2 (Home Win, Draw, Away Win)
  • Over/Under Goals
  • Both Teams to Score (BTTS)
  • Clean Sheet

Additional betting markets may be available depending on the match.

Where do the odds come from?

Our betting odds are sourced from various bookmakers depending on availability.

Are pre-match odds available after a match has finished?

Yes. When pre-match odds are available for a match, we retain them after the match has finished.

4. Live Data

Does the FootyStats API provide live data?

No. The FootyStats API does not provide live or in-play data.

Our focus is on providing comprehensive football statistics and analytics rather than live scores.

Does the API provide live scores, match minutes or in-play statistics?

No. Live scores, current match minutes and in-play statistics are not available through our API, as our focus remains on football statistics and analytics.

5. Data Usage & Licensing

Can I use FootyStats API data on my website or application?

Yes. You can use FootyStats API data to build websites, applications, dashboards and analytical tools.

However, reselling or redistributing raw API data to third parties is not permitted.

Can I store API data in my own database?

Yes. You can retrieve and store API data in your own database.

Can I keep the data after cancelling my subscription?

Yes. Data retrieved during your subscription can be retained after your subscription ends.

Can I use FootyStats data with ChatGPT, AI or machine-learning models?

Yes. Once you have retrieved the data through the API, you are free to use it for your own analysis, including with ChatGPT, AI tools, machine-learning models and prediction systems.

Can I use FootyStats data to create football predictions?

Yes, it is not our responsibility how you use the data. You can use our football statistics to develop your own prediction models, algorithms and analytical tools.

Is any attribution required (e.g. "Data by FootyStats")?

No

6. API Testing & Documentation

Can I test the API before subscribing?

Yes. You can test several FootyStats API endpoints for free using the example API key.

No account is required for these test calls.

You can test the API here: Try All API Endpoints.

Where can I find the API documentation?

You can explore our complete API documentation, including available endpoints, parameters and example responses, here:

FootyStats API Documentation

/
https://cdn.footystats.org/
no