list

List of all countries ⬜ 🟨 🟦 🟩

GET https://api.soccerfootball.info/v1/countries/list/

This endpoint returns with all countries and the relented entries. You can use this call to get country code and use it in another endpoints. The possible format of this call is json or csv (MS office compatible) Format CSV is in MS excel compatible mode (double click open without import!)

Query Parameters

Name	Type	Description
t	string	Your API Token DIRECT API ONLY
f	string	Format response can be "json" or "csv" (default "json")

Headers

Name	Type	Description
X-RapidAPI-Key	string	Your API token RAPIDAPI ONLY
X-RapidAPI-Host	string	soccerfootballinfo.rapidapi.com RAPIDAPI ONLY

200 Success response

JSON

{
   "status":200,
   "errors":[],
   "pagination":[],
   "result":[
      {
         "code":"AF",  // unique country code
         "name":"Afghanistan",
         "timezones":[
            "UTC+04:30"
         ],
         "championships":0, 
         "managers":2,
         "players":13,
         "referees":0,
         "stadiums": 0,
         "teams":4
      },
		...
   ]
}

CSV

code;name;timezones;championships;managers;players;referees;stadiums;teams
AD;Andorra;UTC+01:00;5;32;35;1;7;41
...

478KB

How to see API call details

image

Example of code for direct API

PHP

$url = 'https://api.soccerfootball.info/v1/countries/list/?t=TOKEN';

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_PROXY => null,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_CUSTOMREQUEST => "GET"
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if (!$err) {
  $result = json_decode($response);
  print_r($result);
} else {
	echo "cURL Error:" . $err;
}

Javascript

fetch("https://api.soccerfootball.info/v1/countries/list/?t=TOKEN", {
	"method": "GET"
})
.then(response => {
	console.log(response);
})
.catch(err => {
	console.error(err);
});

NodeJS

const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.soccerfootball.info/v1/countries/list/?t=TOKEN'
};

request(options, function (error, response, body) {
	if (error) throw new Error(error);

	console.log(body);
});

Phyton

import requests

url = "https://api.soccerfootball.info/v1/countries/list/?t=TOKEN"

response = requests.get(url).json()

print(response)

cURL

curl --request GET \
	--url 'https://api.soccerfootball.info/v1/countries/list/?t=TOKEN'

GO

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://api.soccerfootball.info/v1/countries/list/?t=TOKEN"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Example of code for RapidAPI

PHP

$url = 'https://soccer-football-info.p.rapidapi.com/countries/list/';

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => $url,
    CURLOPT_PROXY => null,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
		"X-RapidAPI-Host: soccer-football-info.p.rapidapi.com",
		"X-RapidAPI-Key: TOKEN"
	],
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if (!$err) {
  $result = json_decode($response);
  print_r($result);
} else {
	echo "cURL Error:" . $err;
}

Javascript

fetch("https://soccer-football-info.p.rapidapi.com/countries/list/", {
	"method": "GET",
	"headers": {
		"X-RapidAPI-Key": "TOKEN",
		"X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
	}
})
.then(response => {
	console.log(response);
})
.catch(err => {
	console.error(err);
});

NodeJS

const request = require('request');

const options = {
  method: 'GET',
  url: "https://soccer-football-info.p.rapidapi.com/countries/list/",
  headers: {
   "X-RapidAPI-Key": "TOKEN",
	 "X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
   useQueryString: true
  }
};

request(options, function (error, response, body) {
	if (error) throw new Error(error);

	console.log(body);
});

Phyton

import requests

url = "https://soccer-football-info.p.rapidapi.com/countries/list/"

headers = {
    "X-RapidAPI-Key": "TOKEN",
	  "X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

cURL

curl --request GET \
	--url https://soccer-football-info.p.rapidapi.com/countries/list/ \
	--header 'X-RapidAPI-Host: soccer-football-info.p.rapidapi.com' \
	--header 'X-RapidAPI-Key: TOKEN'

GO

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://soccer-football-info.p.rapidapi.com/countries/list/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-RapidAPI-Key", "TOKEN")
	req.Header.Add("X-RapidAPI-Host", "soccer-football-info.p.rapidapi.com")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

More example of code on rapidAPI