Football API Documentation
Welcome to our football API documentation homepage. You can use your API credentials to access any of the endpoints that you need. Through them you can obtain data for 400+ domestic and international competitions.
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 more. 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
Authentication
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 you explore the documentation you will see all football API
endpoints with your API key and secret filled in. You can just copy them and use them. Being logged in
makes your life much easier and testing and developing much 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.
Just because the game is over does not mean that you or your visitors and users are not interested into it. That is why, added to our football api a history endpoint from where you can get information about matches played in the past. This complements the fixtures and live-scores to span our product from the past into the future. Read more...
Who is on first place and who is going to win the league 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. Read more...
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. Read more...
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 support by our football api though this api endpoint. Use only the countries marked with is_real: 1
Read more...
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.
Read more...
Before we started providing federations, we used to put them as fake countries is_real: 0
. Not 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.
Read more...
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 everywehn in the data.
Read more...
JSON, XML, CSV are the data formats that our football api supports. They are available for all api endpoints. You can easily switch the type of the response format by changing the extension of the api URL that you are using. We highly recommend JSON as it is the smalles, and easiest structured data format that we support. Read more...
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. Read more...
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 practicing using your api key and secret, and also use the correct REST HTTP method. For all of our enpoints you should use GET. POST is not supported. Read more...
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 team namings in Russian, Arabic, and Farsi. More data and languages are regularly added. Read more...
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. Read more...