ws

List of all championships with WebSocket ID mapping 🟩

GET https://api.soccerfootball.info/v1/championships/ws/

This endpoint returns a paginated list of championships with the dual ID mapping system for the MAIN_REALTIME WebSocket channel. Each field (id, name, country) is an object containing two values: ws_realtime: the value used exclusively in MAIN_REALTIME channel messages rest_releated: the value from the standard REST API and all other WebSocket channels (MAIN, STATS, ODDS, STATS_REALTIME, ODDS_REALTIME) This mapping allows you to match championships between MAIN_REALTIME events and the rest of the API. You can search by name or look up a specific championship by either ID type. The parameters find_id and find_ws_id are mutually exclusive. Format CSV is in MS excel compatible mode (double click open without import!) The latest data are on the last page.

MAIN_REALTIME only — This endpoint is needed only if you subscribe to the MAIN_REALTIME channel (MEGA plan 🟩). All other WebSocket channels already use REST IDs, so no mapping is required for them.

Query Parameters

Name	Type	Description
t	string	Your API Token DIRECT API ONLY
f	string	Format response can be "json" or "csv" (default is "json")
p	string	Page number (default value is 1)
search_ws	string	Search by WebSocket championship name (partial match)
search	string	Search by REST championship name (partial match)
find_id	string	Find by REST championship ID (exact match)
find_ws_id	string	Find by WebSocket championship ID (exact match)

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":[
      {
         "page":1,// current page
         "per_page":100, // items per page
         "items":542 // total items number
      }
   ],
   "result":[
      {
         "id":{
            "ws_realtime":"a1b2c3d4e5f6a7b8", // WebSocket championship ID
            "rest_releated":"5fda5fa713daf8c1" // REST API championship ID
         },
         "name":{
            "ws_realtime":"Serie A TIM", // name from WebSocket data source
            "rest_releated":"Italian Serie A" // name from REST API
         },
         "country":{
            "ws_realtime":null, // country from WebSocket data source (may be null)
            "rest_releated":"IT" // country from REST API
         }
      },
      ...
   ]
}

CSV

478KB

How to see API call details

image

Open

Example of code for direct API

PHP

$url = 'https://api.soccerfootball.info/v1/championships/ws/?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

NodeJS

Phyton

cURL

GO

Example of code for RapidAPI

PHP

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

$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

NodeJS

Phyton

cURL

GO

More example of code on rapidAPI