A new API version 3 BETA

December 2, 2019


We are very happy to announce the new version of the API: v3. We have completely re-written the API and moved to the AWS Amazon infrastructure which allows for a better scalability and significantly reduces performance issues. The new version is now available for testing and should be fully accessible for the next season. The data structure is mostly the same, but the performance should be much more stable and reliable.

The current version 2 will be further supported, however, it is scheduled to be deprecated by the end of 2020.
To have access to the new Beta version 3, go to your account area and request an API Key. You will be able to use the new API with the same membership level you have in version 2. However, the available requests quote is separate for each API version.
You also have the possibility to check the interactive documentation on our website.
We are very excited about rolling the new API version and would be happy to receive your feedback.

Football-API Team

2018 FIFA World Cup

November 13, 2017


2018 FIFA Worldcup logo


This is a custom plan for API of the 2018 FIFA World Cup in Russia. The plan includes live coverage of games, commentaries, standings of the groups and fixtures. This plan costs 100$ and is a non-recurrent one billing purchase.

Once purchased, you will have access to international friendlies as well as the UEFA champions league and UEFA europa league. This purchase is money-back-guaranteed till 20.06.2018 in case you are not satisfied with the data or the API.

Important: Please note that checking out will replace your current plan. If you are a current member, please contact us to add the competition to your plan.

API v2.0 is live!

March 29, 2016

Hello everyone,

We are excited to announce that, as promised, API v2.0 is now ready to be used for production. We have conducted a thorough testing and fixed a number of bugs. The performance is significantly superior to API v1.0 and the amount of data is much larger. For new clients after this post, the APIKey generated will work for both the old and the new API. For old clients, please get in touch with us to have a new APIKey and access to the API v2.0. However, please note that access to the API v2.0 provides by default 1000 requests per hour without IP address restrictions.

Moving to the new API should be done within the next 6 months. The old API v1.0 will be deprecated by the end of September. Therefore, we urge you to migrate and adjust your codes to the new API.

Although we have run a lot of tests, bugs can not be excluded. Kindly report to us if you observe any bugs or have suggestions/improvements.

Please do not hesitate to contact our team through the support page.

API v2.0 beta new features

January 15, 2016

Hello everyone,

A few days ago we have announced the new v2.0 API. It is still Beta but we received a lot of your emails expressing satisfaction with the new product. We have done a couple of updates and new features based on your feedback (Thanks Corey!):

1- You can now filter matches by multiple competition id’s. Simply provide the competition ids separated by commas.

2- You can now filter matches by team ids as well. Also here you can provide multiple teams ids to retrieve only matches where these teams are playing.

These two changes will save you many requests and should also relieve the load on our servers since you don’t need to do unnecessary requests.

We hope you enjoy the new features!


API v2.0 Beta Ready for Testing

January 9, 2016

Faster, nicer, more data!
We have been working hard to polish our v2.0 API. We have released it for beta testing last year but now we have completely re-written it from scratch. The new API provides match faster responses and better organization of the data. We have improved our current endpoints, add a few more and improved the servers infrastructure. Although the work is not 100% done, we would like to share with you now our beta testing version before it goes public for production and replace our current API.
The new API has a much more comprehensive documentation and testing tools. It provides better error codes and we removed some of the clutter in the old API. Here is a list of the most important changes and features:

  • Faster response time.
  • Better error handling with clear codes and messages.
  • “today” and “fixtures” endpoints are merged in “matches” endpoint. By default, it returns live matches which is faster than returning all matches of the day.
  • Fixtures of the whole season instead of fixtures for the upcoming 7 days only.
  • New endpoint “team” returning team profile.
  • New endpoint “player” returning player profile.
  • CORS support
  • A better organization of the commentaries endpoint. Solving many issues with the data presentation.

The new API is planned to be in the Beta phase till the end of March. Afterwards, it will replace the current API. The current API will still work in a transition phase of 9 months.

We are very excited about having the new API in production. Please feel free to tinker with the documentation on this link:


It gives access similar to the data in the Premium football package. However, please remember that this API is still in beta testing phase and not suitable for production purposes. Please feel free to contact us if you have any idea to improve the service or notice a bug in the v2.0.

Update (11.01.2016): If you would like to have your own API key to test the new API from your server, contact us here!

Happy coding,

Football-API Team

Service is Live!

April 1, 2014

Hello all, we are so excited to announce that football-api.com is now live! The feed is working and we have done our best to verify that it is working properly. We will keep on testing and improving. Please enjoy the fast feeds and do not hesitate to get back to us for any questions.