On this reference page you will see how to pull the full list of countries supported by our football API and how to read the response.
ENDPOINT
To pull the full list of countries that our football API feed supports you just need to hit the URL shown below.
Check this Football API endpoint in our postman collection. Download it now!
PARAMETERS
Right now this football API endpoint accepts just one parameter which is the federation_id. Supplying it narrows the returned countries so they only include the ones that belong to the given federation. For the complete list of federations you can head over to the federations list API endpoint documentation.
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| federation_id | number | 3 | This field narrows down the countries based on the federation they are part of. More details about federations are available on the federation list API endpoint documentation page. |
RESPONSE
The response returned by this football API endpoint carries the following details for each country entry in the list.
| Name | Type | Example | Description |
|---|---|---|---|
| federation | object | contains the id and the name of the football federation to which the country belongs. You can find more about federations here. | |
| id | number | 5 | the id of the country which you can use in sub sequential requests. |
| is_real | number | 1 | this is flag that shows whether the country is real. What does this mean is that sometimes the live-scores that we provide in order feed could be related to a real country like England. Then the is_real flag will have the value of 1. Other times we will provide football live scores for FIFA World Cup. In this case the country like South America or FIFA will have is_real value of 0 because it is not a real country. |
| leagues | url | this is a football API link to the list of all leagues that we have in this country. For example, if you follow this link for England you will see a list of the leagues for which we provide live-scores like: Premiership, Championship, FA Cup and more. You can find out more about the leagues endpoint in the leagues endpoint reference | |
| name | string | Germany | the name of the country. |
| national_team | object | this field contains the information about the national team associated with this country only if it is a real country | |
| scores | url | this is a football API link to the list of all live-scores that we have for this country right now |
{
"success": true,
"data": {
"country": [
{
"id": "82",
"name": "Africa",
"is_real": "0",
"leagues": "http:\/\/api.football-api.com\/leagues\/list.json?key=demo_key&secret=demo_secret&country=82",
"scores": "http:\/\/api.football-api.com\/scores\/live.json?key=demo_key&secret=demo_secret&country=82",
"national_team": null,
"federation": {
"id": "3",
"name": "CAF"
}
},
{
"id": "67",
"name": "Algeria",
"is_real": "1",
"leagues": "http:\/\/api.football-api.com\/leagues\/list.json?key=demo_key&secret=demo_secret&country=67",
"scores": "http:\/\/api.football-api.com\/scores\/live.json?key=demo_key&secret=demo_secret&country=67",
"national_team": {
"id": "1528",
"name": "Algeria",
"stadium": "Stade du 5 Juillet 1962",
"location": "Stade du 5 Juillet 1962"
},
"federation": {
"id": "3",
"name": "CAF"
}
},
{
"id": "65",
"name": "Argentina",
"is_real": "1",
"leagues": "http:\/\/api.football-api.com\/leagues\/list.json?key=demo_key&secret=demo_secret&country=65",
"scores": "http:\/\/api.football-api.com\/scores\/live.json?key=demo_key&secret=demo_secret&country=65",
"national_team": {
"id": "1443",
"name": "Argentina",
"stadium": "Estadio Monumental Antonio Vespucio Liberti",
"location": "Estadio Monumental Antonio Vespucio Liberti"
},
"federation": {
"id": "6",
"name": "CONMEBOL"
}
}
]
}
}Examples
The following examples show you how to use this endpoint in various programming languages. 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. cUrl:
curl -XGET https://api.football-api.com/countries/list.json?date=today&key=demo_key\\&secret=demo_secretfile_get_contents('https://api.football-api.com/countries/list.json?date=today&key=demo_key\&secret=demo_secret');import urllib2
req = urllib2.Request('https://api.football-api.com/countries/list.json?date=today&key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()