Getting List of Teams

On this page from our livescore 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.

This livescore api endpoint supports teams names in various languages to find out more about this. Read through our documentation on language support.

Here at livescore 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 out teams football data up to date. We have now exposed an api ednpoint 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 livescores, 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.

GET:


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 Endlang, and by federation we mean international football association 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 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.


NameTypeRequiredExampleDescription
country_idnumberoptional1To filter the list with teams by a country
federation_idnumberoptional13To filter the list with teams by a federation
languagestringoptionalruTo specify in which language you are interested in
sizenumberoptional100To control the number of items you want to receiver between 1 and 100. The default response size is 30.
pagenumberoptional5The 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.

NameTypeExampleDescription
idnumber2421The id of the team in our database
namestringAcademia Puerto CabelloThe name of the team
stadiumstringComplejo Deportivo SocialistaThe name of the stadium where the team usually plays their home games
countryobjectInformation about the country from which the team is (like Venezuela).
country.idnumber45The id of the country
country.namestringVenezuelaThe name of the country
country.is_realnumber0Whether it is a real country (1) or not (0). This is from before we started supporting federations as a separate type of data.
federationobjectInformation about the federation from which the team is (like UEFA).
federation.idnumber2The id of the federation
federation.namestringUEFAThe name of the federation
name_*stringThe name of the team in the provided language if you used one in your request parameters
translationsobjectAll 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
totalnumber4421Is the total number of teams that there are under the current request filters provided
pagesnumber1474the total number of pages available based on the size provided in the request or 30 items per page by default
next_pageurlThe link to the next page with results or false if there is no such page
prev_page urlThe 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.com/api-client/teams/list.json?key=demo_key\&secretdemo_secret\&country_id=1
PHP
file_get_contents('http://livescore-api.com/api-client/teams/list.json?key=demo_key&secretdemo_secret&country_id=1');
Python
import urllib2
req = urllib2.Request('http://livescore-api.com/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.com/api-client/teams/list.json?key=demo_key\&secretdemo_secret\&federation_id=1
PHP
file_get_contents('http://livescore-api.com/api-client/teams/list.json?key=demo_key&secretdemo_secret&federation_id=1');
Python
import urllib2
req = urllib2.Request('http://livescore-api.com/api-client/teams/list.json?key=demo_key&secretdemo_secret&federation_id=1')
response = urllib2.urlopen(req)
print response.read()