⚽
Soccer Football Info
  • About API
  • Price & Limits
  • Coverage
  • FAQ
  • Dominance index
  • xG (Expected Goals)
  • Changelog
  • Support
  • API v1
    • Authentication
    • Errors
    • Championships
      • list
      • view
    • Countries
      • list
    • Emulation
      • Totalcorner
        • match schedule
        • match today
    • Languages
      • list
    • Live
      • live full
      • live basic
    • Managers
      • list
      • view
    • Matches
      • day basic
      • day full
      • view basic
      • view full
      • by basic
      • by full
      • odds
      • view progressive
    • Players
      • list
      • view
    • Referees
      • list
      • view
    • Stadiums
      • list
      • view
    • Teams
      • list
      • view
      • history
      • versus
    • Custom
    • Token
      • status
Powered by GitBook
On this page
  • Versus results between two teams ⬜ 🟨 🟦 🟩
  • Example of code for direct API
  • Example of code for RapidAPI

Was this helpful?

  1. API v1
  2. Teams

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

{
   "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"
               }
            },
            ...
         ]
      }
   ]
}
time_all;match_id;date_match;champipship;championship_id;season_name;teamA_name;teamA_id;teamA_score;teamB_name;teamB_id;teamB_score
;600772c53a14d889;"2021-01-26 19:45:00";"Italia - Coppa Italia";5fda5fa8d5514fc8;;Inter;5fda6034be4e9d6b;2;Milan;5fda5fcad92584cd;1
...

Example of code for direct API

$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;
}
fetch("https://api.soccerfootball.info/v1/teams/versus/?t=TOKEN&x=IDX&y=IDY", {
    "method": "GET"
})
.then(response => {
    console.log(response);
})
.catch(err => {
    console.error(err);
});
const request = require('request');

const options = {
  method: 'GET',
  url: 'https://api.soccerfootball.info/v1/teams/versus/?t=TOKEN&x=IDX&y=IDY'
};

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

    console.log(body);
});
import requests

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

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

print(response)
curl --request GET \
    --url 'https://api.soccerfootball.info/v1/teams/versus/?t=TOKEN&x=IDX&y=IDY'
package main

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

func main() {

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

    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

$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;
}
fetch("https://soccer-football-info.p.rapidapi.com/teams/versus/?x=IDX&y=IDY", {
    "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);
});
const request = require('request');

const options = {
  method: 'GET',
  url: "https://soccer-football-info.p.rapidapi.com/teams/versus/?x=IDX&y=IDY",
  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);
});
import requests

url = "https://soccer-football-info.p.rapidapi.com/teams/versus/?x=IDX&y=IDY"

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 --request GET \
    --url https://soccer-football-info.p.rapidapi.com/v1/teams/versus/?x=IDX&y=IDY \
    --header 'X-RapidAPI-Host: soccer-football-info.p.rapidapi.com' \
    --header 'X-RapidAPI-Key: TOKEN'
package main

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

func main() {

    url := "https://soccer-football-info.p.rapidapi.com/teams/versus/?x=IDX&y=IDY"

    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))

}
PrevioushistoryNextCustom

Last updated 2 years ago

Was this helpful?

More example of code on

rapidAPI
478KB
How to see API call details
image