versus

Versus results between two teams ⬜ 🟨 🟦 🟩

GET https://api.soccerfootball.info/v1/teams/versus/?x=IDX&y=IDY

This endpoint returns with all matches between two teams and its results You can define two teams, one with x and another with y With parameter w you can define the time lapse "all" (from 2017 01 01), "1y" last year, "6m" last 6 months. The parameter l must be a language code getted from languages/list endpoint. Some elements such as championship and team names can be translated. Format response can be "json" or "csv" (Default "json")

Query Parameters

Name	Type	Description
t	string	Your API Token DIRECT API ONLY
f	string	Format response can be "json" or "csv" (default "csv")
x	string	ID of X TEAM
y	string	ID of Y TEAM
w	string	When get time can be "all", "1y", "6m" (default value is "6m")
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":[
      {
         "lapse":"all",
         "teamX":{
            "id":"5fda6034be4e9d6b",
            "name":"Inter"
         },
         "teamY":{
            "id":"5fda5fcad92584cd",
            "name":"Milan"
         },
         "results":{
            "teamX":5, // times of X wins
            "teamY":2, // times of Y wins
            "draw":2 // times of matces go draw
         },
         "macthes":[
            {
               "id":"5fb96897c83c9629",
               "date":"2020-10-17 16:00:00",
               "championship":{
                  "id":"5fda5fab11fbd288",
                  "name":"Italia - Serie A",
                  "s_name":"Serie A 20/21"
               },
               "teamA":{
                  "id":"5fda6034be4e9d6b",
                  "name":"Inter",
                  "score":"1"
               },
               "teamB":{
                  "id":"5fda5fcad92584cd",
                  "name":"Milan",
                  "score":"2"
               }
            },
            ...
         ]
      }
   ]
}

CSV

478KB

How to see API call details

image

Open

Example of code for direct API

PHP

$url = 'https://api.soccerfootball.info/v1/teams/versus/?t=TOKEN&x=IDX&y=IDY';

$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/teams/versus/?x=IDX&y=IDY';

$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