# ws ## List of all teams with WebSocket ID mapping 🟩 `GET` `https://api.soccerfootball.info/v1/teams/ws/` This endpoint returns a paginated list of teams with the dual ID mapping system for the **MAIN\_REALTIME** WebSocket channel.\ Each field (id, name, country) is an object containing two values:\ \&#xNAN;**`ws_realtime`**: the value used exclusively in **MAIN\_REALTIME** channel messages\ \&#xNAN;**`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 teams between MAIN\_REALTIME events and the rest of the API.\ You can search by name or look up a specific team 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. {% hint style="warning" %} **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. {% endhint %} #### 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 team name (partial match) | | search | string | Search by REST team name (partial match) | | find\_id | string | Find by REST team ID (exact match) | | find\_ws\_id | string | Find by WebSocket team 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`** | {% tabs %} {% tab title="200 Success response" %} {% tabs %} {% tab title="JSON" %} ```javascript { "status":200, "errors":[], "pagination":[ { "page":1,// current page "per_page":100, // items per page "items":1250 // total items number } ], "result":[ { "id":{ "ws_realtime":"a1b2c3d4e5f6a7b8", // WebSocket team ID "rest_releated":"5fda5faf06aa325e" // REST API team ID }, "name":{ "ws_realtime":"FC Internazionale Milano", // name from WebSocket data source "rest_releated":"Inter Milan" // name from REST API }, "country":{ "ws_realtime":null, // country from WebSocket data source (may be null) "rest_releated":"IT" // country from REST API } }, ... ] } ``` {% endtab %} {% tab title="CSV" %} ``` page_1_perPage_100_items_1250;id_ws_realtime;id_rest_releated;name_ws_realtime;name_rest_releated;country_ws_realtime;country_rest_releated ;a1b2c3d4e5f6a7b8;5fda5faf06aa325e;"FC Internazionale Milano";"Inter Milan";;"IT" ... ``` {% endtab %} {% endtabs %} {% endtab %} {% endtabs %} {% file src="/files/XJTQH8tCM5ZJYoj0jBag" %} ## Example of code for direct API {% tabs %} {% tab title="PHP" %} ```php $url = 'https://api.soccerfootball.info/v1/teams/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; } ``` {% endtab %} {% tab title="Javascript" %} ```python fetch("https://api.soccerfootball.info/v1/teams/ws/?t=TOKEN", { "method": "GET" }) .then(response => { console.log(response); }) .catch(err => { console.error(err); }); ``` {% endtab %} {% tab title="NodeJS" %} ```javascript const request = require('request'); const options = { method: 'GET', url: 'https://api.soccerfootball.info/v1/teams/ws/?t=TOKEN' }; request(options, function (error, response, body) { if (error) throw new Error(error); console.log(body); }); ``` {% endtab %} {% tab title="Phyton" %} ```python import requests url = "https://api.soccerfootball.info/v1/teams/ws/?t=TOKEN" response = requests.get(url).json() print(response) ``` {% endtab %} {% tab title="cURL" %} ```bash curl --request GET \ --url 'https://api.soccerfootball.info/v1/teams/ws/?t=TOKEN' ``` {% endtab %} {% tab title="GO" %} ```go package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://api.soccerfootball.info/v1/teams/ws/?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)) } ``` {% endtab %} {% endtabs %} ## Example of code for RapidAPI {% tabs %} {% tab title="PHP" %} ```php $url = 'https://soccer-football-info.p.rapidapi.com/teams/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; } ``` {% endtab %} {% tab title="Javascript" %} ```javascript fetch("https://soccer-football-info.p.rapidapi.com/teams/ws/", { "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); }); ``` {% endtab %} {% tab title="NodeJS" %} ```javascript const request = require('request'); const options = { method: 'GET', url: "https://soccer-football-info.p.rapidapi.com/teams/ws/", 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); }); ``` {% endtab %} {% tab title="Phyton" %} ```python import requests url = "https://soccer-football-info.p.rapidapi.com/teams/ws/" headers = { "X-RapidAPI-Key": "TOKEN", "X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com" } response = requests.request("GET", url, headers=headers) print(response.text) ``` {% endtab %} {% tab title="cURL" %} ```bash curl --request GET \ --url https://soccer-football-info.p.rapidapi.com/teams/ws/ \ --header 'X-RapidAPI-Host: soccer-football-info.p.rapidapi.com' \ --header 'X-RapidAPI-Key: TOKEN' ``` {% endtab %} {% tab title="GO" %} ```go package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://soccer-football-info.p.rapidapi.com/teams/ws/" 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)) } ``` {% endtab %} {% endtabs %} More example of code on [rapidAPI](https://rapidapi.com/soccerfootball-info-soccerfootball-info-default/api/soccer-football-) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://info.soccerfootball.info/v1/teams/ws.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.