Teams list

1. Endpoint
2. Parameters
3. Response
4. Getting Teams By Country
5. Getting Teams By Federation

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 countries or federations.

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

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

If you use the language parameter, then according to your subscription package the names of the teams, countries, and federations will get translated to the specified language. This will happen if your package supports this kind of translation and we have the names of the entities in the language chosen by you in the lang parameter.

RESPONSE

The response from the teams football API endpoint contains the data of the team as well as the general information for the country or the federation of the team. You should consult our standard response objects documentation page for more details.

{
    "success": true,
    "data": {
        "teams": [
            {
                "team": {
                    "id": 1742,
                    "name": "Albania",
                    "stadium": "Stadiumi Loro Bori\u00e7i",
                    "country_id": 115,
                    "logo": "https:\/\/cdn.live-score-api.com\/teams\/f2680adbce2edcc4bdab5588f871bd57.png"
                },
                "country": {
                    "id": 115,
                    "name": "UEFA",
                    "flag": "uefa.png",
                    "fifa_code": "",
                    "uefa_code": "",
                    "is_real": false
                },
                "federation": {
                    "id": 2,
                    "name": "UEFA"
                }
            },
            {
                "team": {
                    "id": 2680,
                    "name": "Armenia",
                    "stadium": "Vazgen Sargsyan anvan Hanrapetakan Marzadasht",
                    "country_id": 115,
                    "logo": "https:\/\/cdn.live-score-api.com\/teams\/4e0d1ec0fb84e65525fff1ae5c53154b.png"
                },
                "country": {
                    "id": 115,
                    "name": "UEFA",
                    "flag": "uefa.png",
                    "fifa_code": "",
                    "uefa_code": "",
                    "is_real": false
                },
                "federation": {
                    "id": 2,
                    "name": "UEFA"
                }
            }
        ]
    }
}

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 https://livescore-api.com/api-client/teams/listing.json?key=demo_key\&secret=demo_secret\&country_id=1

file_get_contents('https://livescore-api.com/api-client/teams/listing.json?key=demo_key&secret=demo_secret&country_id=1');

import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/teams/listing.json?key=demo_key&secret=demo_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 https://livescore-api.com/api-client/teams/listing.json?key=demo_key\&secret=demo_secret\&federation_id=1

file_get_contents('https://livescore-api.com/api-client/teams/listing.json?key=demo_key&secret=demo_secret&federation_id=1');

import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/teams/listing.json?key=demo_key&secret=demo_secret&federation_id=1')
response = urllib2.urlopen(req)
print response.read()