live ws

View all live matches with WebSocket ID mapping 🟩

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

This endpoint returns all currently live matches with the dual ID mapping system for the MAIN_REALTIME WebSocket channel. Each ID field (match, team, championship) is an object containing two identifiers: ws_realtime: the ID used exclusively in the MAIN_REALTIME channel messages rest_releated: the ID used in standard REST API endpoints and in all other WebSocket channels (MAIN, STATS, ODDS, STATS_REALTIME, ODDS_REALTIME) This mapping allows you to bridge between MAIN_REALTIME events and the rest of the API. The parameter l must be a language code getted from languages/list endpoint. Format CSV is in MS excel compatible mode (double click open without import!)

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 "json")
l	string	Language code (default value is "en_US")

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":[
      {
         "id":{
            "ws_realtime":"a1b2c3d4e5f6a7b8", // WebSocket real-time match ID
            "rest_releated":"5ff7a0c8ceb4f157" // REST API match ID
         },
         "date":"2024-09-15 16:00:00",
         "timer":"45:00+02:10", // match timer, if in extra time: 90:00+01:00
         "est_e_time":"3", // estimated extra time, false if unknown
         "in_play":true, // if match is currently in play
         "championship":{
            "id":{
               "ws_realtime":"b2c3d4e5f6a7b8c9", // WebSocket championship ID
               "rest_releated":"5fda5fa8541c9de5" // REST API championship ID
            },
            "name":"Premier League",
            "country":"GB"
         },
         "teamA":{
            "id":{
               "ws_realtime":"c3d4e5f6a7b8c9d0", // WebSocket team ID
               "rest_releated":"5fda5fcd1aa9fae1" // REST API team ID
            },
            "name":"Manchester United",
            "score":{
               "f":"2", // final/current score
               "1h":"1", // first half score
               "2h":"1", // second half score
               "o":null, // overtime score
               "p":null // penalties score
            }
         },
         "teamB":{
            "id":{
               "ws_realtime":"d4e5f6a7b8c9d0e1",
               "rest_releated":"5fda5fcd1aa9fae2"
            },
            "name":"Liverpool",
            "score":{
               "f":"1",
               "1h":"0",
               "2h":"1",
               "o":null,
               "p":null
            }
         }
      },
      ...
   ]
}

CSV

478KB

How to see API call details

image

Open

Example of code for direct API

PHP

$url = 'https://api.soccerfootball.info/v1/live/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"
));

$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/live/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