Teams list
On this page from our live-score api documentation, we present you with the opportunity to get the list of all teams that we have. You can also filter teams by your needs like country or federation.
Here at live-score api, we already have a big database with teams, and we regularly add new teams, update the existing teams by modifying and adding information. This way, we keep our teams' football data up to date. We have now exposed a football API endpoint that allows you to benefit from it and get the list of the teams that we have as well as some additional information about them. Every team that we have in our football data is represented by an id that is used across other endpoints like those for {{{6, live-scores}}}, fixtures, and standings.
Endpoint:
In order, to get the list of all teams from our football API or to filter the teams by your needs, you can use the following api endpoint. In this example, we have used the demo api key and secret pair. If you login in, you will see all examples with your own api key and api secret.
PARAMETERS:
This api endpoint supports several parameters that help you filter the football teams based on countries or federations. Examples of countries are Russia, Italy, South Africa, and England. By federation, we mean international football associations like FIFA, CONMEBOL, CAF, and AFC. You can read more on getting to know the countries in the getting countries list documentation page. To find out how federations work in the context of our football API schema, please refer to the federations specific page.
This football API endpoint also supports languages and provides all the translations that we have for a certain team. If there is a missing translation of a team name you can always contribute to our football api and volunteer as a translator. You need to be logged in to get access to this page. To find out everything about or languages support visit our language documentation page.
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| country_id | number | optional | 1 | To filter the list with teams by a country |
| federation_id | number | optional | 13 | To filter the list with teams by a federation |
| language | string | optional | ru | To specify in which language you are interested in |
| size | number | optional | 100 | To control the number of items you want to receiver between 1 and 100. The default response size is 30. |
| page | number | optional | 5 | The consecutive number of page with results that you want to retrieve. The default page number is 1 |
If you use the language parameter a new key will be added to the response object. It will be named name_ + language. For example, if you called our football api with language=ru then the response will contain a key name_ru. Similarly, for Arabic the response data will contain the key name_ar. This additional field in the data will contain the name of the team in the respective language, if we are lacking this translation the value will be false.
Response:
The response from the teams football API endpoint contains two types of data. First, it is a general data for all the teams that we have, or match your filters, and the second is for the teams that are returned by the API on this page with results.
| Name | Type | Example | Description |
|---|---|---|---|
| id | number | 2421 | The id of the team in our database |
| name | string | Academia Puerto Cabello | The name of the team |
| stadium | string | Complejo Deportivo Socialista | The name of the stadium where the team usually plays their home games |
| country | object | Information about the country from which the team is (like Venezuela). | |
| country.id | number | 45 | The id of the country |
| country.name | string | Venezuela | The name of the country |
| country.is_real | number | 0 | Whether it is a real country (1) or not (0). This is from before we started supporting federations as a separate type of data. |
| federation | object | Information about the federation from which the team is (like UEFA). | |
| federation.id | number | 2 | The id of the federation |
| federation.name | string | UEFA | The name of the federation |
| name_* | string | The name of the team in the provided language if you used one in your request parameters | |
| translations | object | All the translations of the teams that we have in all possible languages. The language code is the key and the value is the name of the team in that language | |
| total | number | 4421 | Is the total number of teams that there are under the current request filters provided |
| pages | number | 1474 | the total number of pages available based on the size provided in the request or 30 items per page by default |
| next_page | url | The link to the next page with results or false if there is no such page | |
| prev_page | url | The link to the previous page with results or false if there is no such page |
{
"success": true,
"data": {
"teams": [
{
"id": "2421",
"name": "Academia Puerto Cabello",
"stadium": "Complejo Deportivo Socialista",
"country": {
"id": "45",
"name": "Venezuela",
"is_real": "1"
},
"federation": [],
"name_ru": "Academia Puert…",
"translations": {
"ar": "Academia Puert…",
"ru": "Academia Puert…",
"fa": "\u0622\u06a9\u0627\u062f\u0645\u06cc\u0627 \u067e\u0648\u0631\u062a\u0648 \u06a9\u0627\u0628\u06cc\u0648"
}
},
{
"id": "811",
"name": "Academica",
"stadium": "Est\u00e1dio EFAPEL",
"country": {
"id": "32",
"name": "Portugal",
"is_real": "1"
},
"federation": [],
"name_ru": false,
"translations": {
"fa": "\u0622\u06a9\u0627\u062f\u0645\u06cc\u06a9\u0627"
}
},
{
"id": "4409",
"name": "Academica Clinceni",
"stadium": "",
"country": {
"id": "36",
"name": "Romania",
"is_real": "1"
},
"federation": [],
"name_ru": false,
"translations": []
}
],
"total": "4421",
"pages": 1474,
"next_page": "https:\/\/livescore-api.com\/api-client\/teams\/list.json?key=demo_key&secret=demo_secret&v=&size=3&language=ru&page=13",
"prev_page": "https:\/\/livescore-api.com\/api-client\/teams\/list.json?key=demo_key&secret=demo_secret&v=&size=3&language=ru&page=11"
}
}Getting teams by country
Lets say that we want to get all the teams from Germany (ID: 1). The following football API link will do the job for you. In case you want to get the teams for a different country, all you need to do is to change the id of the country.
cUrl
curl -XGET http://livescore-api.api/api-client/teams/list.json?key=demo_key\&secretdemo_secret\&country_id=1file_get_contents('http://livescore-api.api/api-client/teams/list.json?key=demo_key&secretdemo_secret&country_id=1');import urllib2
req = urllib2.Request('http://livescore-api.api/api-client/teams/list.json?key=demo_key&secretdemo_secret&country_id=1')
response = urllib2.urlopen(req)
print response.read()
Getting teams by federation
In a similar fashion, if we want to get all the teams from UEFA (ID: 2). The following api link will do it. In case you want to get the teams for a different federation, all you need to do is to change the id of the federation. To see the full list with federations and their ids visit the the federations documentation page.
cUrl
curl -XGET http://livescore-api.api/api-client/teams/list.json?key=demo_key\&secretdemo_secret\&federation_id=1file_get_contents('http://livescore-api.api/api-client/teams/list.json?key=demo_key&secretdemo_secret&federation_id=1');import urllib2
req = urllib2.Request('http://livescore-api.api/api-client/teams/list.json?key=demo_key&secretdemo_secret&federation_id=1')
response = urllib2.urlopen(req)
print response.read()