Soccer API Documentation
Welcome to our soccer api full documentation homepage. From here you can navigate through all the documented soccer api endpoints and all the additional information
Live-scores
Undisputedly, the most important feature in our soccer 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 soccer 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 soccer 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 soccer 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 soccer api. For this purpose we have the standings api endpoint. Read more...
Competitions
Competition is every football tournament, and our soccer 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 soccer api though this api endpoint. Use only the countries marked with is_real: 1 Read more...
Flags
All countries have flags. Improve the appearance of your website or mobile app by adding the country flag to the team information. Our soccer 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...
Federations
Before we started providing federations, we used to put them as fake countries is_real: 0. Not they are deprecated and our soccer 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 soccer 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 soccer 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 soccer 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 soccer 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 soccer 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 soccer 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...
Welcome to our soccer API documentation homepage.
We started as a live-score api service only, and with the time we grew to
fully support more soccer API data including: fixtures,
history scores, match events, and we are adding new features, 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 soccer API services.
We also have a section with tutorials
with step by step guidance on the process of using our soccer API.
If you cannot find something that 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 using our soccer API much faster.