Football API Full Refernce Guide

Welcome to our football api full reference homepage. From here you can navigate through all the documented football api endpoints and all the additional information

Welcome to our football api reference homepage. We started as a live-score api service only, and with the time we grew to fully support more football api data including: fixtures, history scores, match events, and we are adding new featrues, competitions and teams all the time.

On the left you will find a menu with all the information that you need to start using our footbll api services. We also have a section with tutorials with step by step guidance on the process of using our api. If you could not find something tha you look for, do not hesitate to contact us at any time. Let us know what you need and we will provide it to you as fast as possible.

On the places where there are api keys and api secret used in examples you will see that the ones we use are called demo_key and demo_secret, but if you are logged in you will see your own pair. This way you will be able to copy paste code examples directly into your project. Being logged in while exploring our documentation will make your life much easier and testing and developing much faster.

Live-scores

Undisputedly, the most important feature in our football api is the live-scores endpoint. Using it you can 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. Read more...

Fixtures

Fixtures are an integral part of any football api. This api 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. Again the endpoint has multiple filters to use to limit the results. Read more...

Events

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. Read more...

History

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...

Standings

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...

Competitions

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

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...

Federations

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...

Teams

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...

Data Formats

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...

Errors

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...

Your First Request

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...

Language Support

Soccer 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...

Key and Secret

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...