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
Who is on first place and who is going to win the competition or progress through the next stage of a
competition. Who is going to be relegated to the lower league or eliminated from the group stage.
This is information that you can also retrieve from our football API. For this purpose
we have the standings API endpoint.
Continue with single group standings...
or
Continue with full competition standings...
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...
Football fans love comparisons. Besides the
top goalscorers
our football API also provides a list with the most decorated players in terms
of red and yellow cards.
Continue reading...
While there are several transfer windows during the year, for big international competitions coaches must
provide a list of the players that will take part in a given competition. For example, the
UEFA EURO. Once this list is submitted it cannot be changed.
This football API provides these lists once they are finalised. You can choose between a
single team squad and all teams rosters.
Continue reading for a single team...
or Continue reading for all teams... or
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
Continue reading...
id
of the team is used across other API endpoints.
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
Continue reading...
is_real: 1.
Before we started providing federations, we used to put them as fake countries
Continue reading...
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.
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
Continue reading...
team_id of the national team. You can get them from
the teams endpoint.
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...