Football API

Sign Up Now Start my free 14 day trial now!

If you are looking for a fast and reliable football API provider, you are in the right place. Increase the time visitors and users spend on your website or mobile by providing them with the football data for 400+ different competitions in 30+ languages. International and national leagues, cups from all the major football federations around the world and their results are in your hands. Reliable, affordable and fast football API.

You can connect to our football API using any programming language or software that supports HTTP and HTTPS connections. That includes: C, C#, Go, Java, NodeJS, Objective-C, Kotlin, PHP, Python, Ruby, Swift and many more. You can also do that using software solutions like Postman, Shell, cURL, and even your favourite browser. At the bottom of our documentation pages you will find example code excerpts that you can copy/paste and start working in seconds.

If there is something more that you need you can always use the frequently asked questions page or contact us via email. We also have a video series on how to create a live score website using our football API

To get access to our football API you need an API key and secret. You can get them from your profile page, once you register or login.

If you remain logged in while exploring the documentation you will see all football API endpoints with your API key and secret filled in. You can just copy the links and use them in many cases, if you click on the link it will open in a new tab straight away. Being logged in makes your life much easier and you can test and develop a lot faster. If you are not logged in you will see the demo credentials demo_key and demo_secret. With them you cannot access our data.



Bulk Matches API Endpoints

Undisputedly, the most important feature in our football API is the live-scores endpoint. Using it you can get all the matches that are currently being played or have finished within the last 3 to 4 hours. This endpoint supports various filters to sieve through the results.
Continue reading...
Fixtures are an integral part of any football API. This endpoint allows you to get the list of all matches that are going to be played in the future. For most competitions this is for the whole current season. This endpoint also has multiple filters to use to customize the results.
Continue reading...
Just because the game is over does not mean that you or your visitors and users are not interested in it. That is why, our football API has a history endpoint from where you can get information about matches played in the past. This complements the fixtures and live-scores API endpoints to provider you data from from the past and into the future.
Continue reading...




Single Match API Endpoints

Match commentary is a popular football API feature used by the best and most popular football websites. It complements live scores and historical data with textual representation of the events on the field. With our commentary API data you will also get metadata surrounding the events happening on the pitch like people involved, teams involved, and event coordinates.
Commentary documentation...
Commentary demo...
Having live scores on your website is great, but what could make it even better are the match events. Through this football API endpoint you can get information about yellow cards, red cards, goals, goal scorers, and missed penalties to complement the live-score and history data. These types of events are just a subset of the 50+ types of events from our commentary API .
Continue reading...
Together with the match events the match statistics are yet another crucial type of data provided by our football API. In overall, you can get up to 18 different types of game statistics from the ball possession thought the throw ins and corner kicks to the attacks and dangerous attacks for both the home and away sides in the football match.
Continue reading...
Who will be the main people involved from the start of the match and who will be the ones that will have to wait on the bench for their moment. Our football API also provides you with this information...starting elevens and substitutions.
Continue reading...





Competitions API Endpoints

Having the list of the players who scored the most goals is essential. Our top goalscorers API is the answer. And an incredible added value to our football API. You will receive a list of the 15 to 20 of the top goalscorers for the competitions that are being played or that have finished recently. In addition, you will get the players' performance and their teams' efficiency in the competition.
Continue reading...
Competitions groups works closely with our football API standings endpoint. Some competitions have only one group the Premier League, some have multiple groups like the World Cup and some competitions have multiple groups during multiple stages throughout the season. This API endpoint provides you with this information.
Continue reading...
Competition is every football tournament, and our football API supports many of them. The competitions include: national leagues and cups, international leagues and cups, national teams competitions like the World Cup. This API endpoint also supports filters to find the competition you are interested in.
Continue reading...




Teams API Endpoints

Our football API supports many teams from around the globe. This API endpoint gives you access to the full list of them or just a subset based on your filtering criteria. Also, here you can find their names translated to different languages like Russian, Arabic, Farsi. The id of the team is used across other API endpoints.
Continue reading...
The H2H comparison endpoint of our football API can help you improve your website or app feeling and it is a great tool for match predictions. By using the general history of the two teams as well as the latest games between them, you can build a great tool for team comparison and match predictions. Wins, Loses, Draws in the last 6 games are available with just one API call.
Continue reading...
Sometimes instead of all the history or head to head comparison, all you need is the last several matches that a team has played. For this purpose our football API provides you with the last matches endpoint that is a derivative from the history matches API endpoint.
Continue reading...





Associations API Endpoints

Countries and Federations are the 2 main owners of our competitions. A Country is a land that is sovereign and can be found on the map of the world. We provide you with a full list of all the countries supported by our football API though this endpoint. Use only the countries marked with is_real: 1.
Continue reading...
Before we started providing federations, we used to put them as fake countries is_real: 0. Now they are deprecated and our football API provides a list with international football federations like FIFA, UEFA, CONMEBOL with their own ids, which you can use to filter competitions, matches, and teams.
Continue reading...
All countries have flags. Improve the appearance of your website or mobile app by adding the country flag to the team information. Our football API has a dedicated endpoint for getting the flags. To make use of it you need to know the team_id of the national team. You can get them from the teams endpoint.
Continue reading...




More API Stuff

Seasons change every year. In football, seasons change twice a year once at the beginning of the year like 2023 to 2024 and once in the middle of the year from 2022/2023 to 2023/2024. To be in sync with the current seasons and all the season from the past, our football API gives you the opportunity to get the full list via this endpoint.
Continue reading...
This is the pair that grants you access to our football API. Make sure that you keep them safe from people who should not know about them. If you expose them, other might use them instead of you and consume your hourly requests. If you suspect this regenerate new pairs and put them into your code.
Continue reading...
JSON is the standard data format that our football API supports. It is available for all API endpoints. We have chosen JSON as it is the smallest, and easiest structured data format that
Continue reading...
Even the best software and services produce errors from time to time. This does not exclude our football API as well. On this page you can get acquainted with the most common errors that you can see while you consume our API endpoints. Do not forget to account for the errors that happen because of network issues.
Continue reading...
To make our football API easier and faster to integrate we rely on a series of standardised response objects thus making it super easy to traverse the JSON responses returned by the API endpoints enumerated on this documentation overview.
Continue reading...
Football is the worlds most popular game. Since our football API is supporting such a global sport it needs to live up to the standards and provide information in different languages. For this purpose, we support translations in 30+ languages and more data and languages are regularly added.
Continue reading...
Every first step is a small, and usually brings a lot of value and learning. For your first step with our football API, we have provided this page where you can simply get the live-scores while you practice using your API key and secret, and also use the correct REST HTTP method. For all of our endpoints you should use GET. POST is not supported.
Continue reading...

Didn't find what you need?

Do no hesitate to contact us. We will get back to you as soon as possible.