⚽
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
  • View all matches of a specific day ⬜ 🟨 🟦 🟩
  • Example of code for direct API
  • Example of code for RapidAPI

Was this helpful?

  1. API v1
  2. Matches

day basic

View all matches of a specific day ⬜ 🟨 🟦 🟩

GET https://api.soccerfootball.info/v1/matches/day/basic/?d=DATE

This endpoint returns with all matches of as specific day The parameter d must be a valid date format in ISO without separator eg. 20201225 (25 December 2020) If this entity has has_image to true, you can access/download the entity media; see te instruction inside FAQ. The parameter l must be a language code getted from languages/list endpoint. Some elements such as championship and team names can be translated. This endpoint is paginated only for present and future days with your subscribe page number, so the parameter p works only in this case. Format CSV is MS excel compatible mode (double click open without data import!)

Add bet365_url that contains bet365 url match. Please note, this is the link pointing to the match. After kickoff, the link may change but bet365 should send you back to the updated link. You have to replace .EXT with your needed extension ".com, .it etc..."

Query Parameters

Name
Type
Description

t

string

Your API Token DIRECT API ONLY

d

string

Date ISO format without separator

p

string

Page number (default value is "1")

l

string

Language code (default value is "en_US")

f

string

Format response can be "json" or "csv" (default "json")

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":[ // only if d is today or a future days
      {
         "page":1, // current page
         "per_page":100, // items per page
         "items":54 // number of items
      }
   ],
   "result":[
      {
         "id":"5fb9682ab4fbd853",
         "date":"2020-01-02 08:06:10",
         "status":"ENDED", // can be: IN_PLAY, BREAK, ENDED, CANCELLED, POSTPONE AND NOT_STARTED
         "timer":"90:00", // match timer if is in extra time there is +minute eg. 90:00+01:00
         "championship":{
            "id":"5fda5fab10354812",
            "name":"India Bangalore Super Division",
            "s_name": "India Bangalore Super Division 20" // seson name
         },
         "teamA":{
            "id":"5fda6013de647f33",
            "name":"Bangalore Dream United FC",
            "score":{
               "f":"1", // final score
               "1h":"0", // 1 half
               "2h":"1", // 2 half
               "o":null, // overtime 
               "p":null // penalties
            },
            "perf":{ // only in present and future match
                "l_5_matches" : "WLWLW", // last 5 match performance (from left to right)
                "avg_game_goals" : "2.5",
                "avg_goals_scored" : "1.5",
                "avg_goals_conceded" : "0.5",
                "o_1_5_team" : "50", // percent of over 1.5 by team in last 5 matches
                "btts" : "60", // percent of btts
                "o_0_5_game" : "100", // percent of over 0.5 by game in last 5 matches
                "o_1_5_game" : "100", // percent of over 1.5 by game in last 5 matches
                "o_2_5_game" : "100", // percent of over 2.5 by game in last 5 matches
                "o_3_5_game" : "100", // percent of over 3.5 by game in last 5 matches
                "tot_goals_scored" : "10", // total goals scored in last 5 matches
                "goals_scored_0_15": ["0","0"], // goals scored between 0 and 15 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_scored_16_30": ["1","10"], // goals scored between 16 and 30 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_scored_31_45": ["1","10"], // goals scored between 31 and end first half minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_scored_46_60": ["1","10"], // goals scored between 46 and 60 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_scored_61_75": ["5","50"], // goals scored between 61 and 75 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_scored_76_90": ["2","20"], // goals scored between 76 and end second half in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "tot_goals_conceded": "10", // total goals conceded in last 5 matches
                "goals_conceded_0_15": ["0","0"], // goals conceded between 0 and 15 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_conceded_16_30": ["1","10"], // goals conceded between 16 and 30 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_conceded_31_45": ["1","10"], // goals conceded between 31 and end first half minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_conceded_46_60": ["1","10"], // goals conceded between 46 and 60 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_conceded_61_75": ["5","50"], // goals conceded between 61 and 75 minute in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
                "goals_conceded_76_90": ["2","20"] // goals conceded between 76 and end second half in last 5 matches format [NUMBER_GOAL ; PERCENT_OF_TOTAL]
            },
            "position" : "1", // position in championship (if)
            "stats":{
               "possession":"40",
               "attacks":{
                  "n":"125", // normal
                  "d":"83", // dangerous
                  "o_s":"5" // off side
               },
               "shoots":{
                  "t":"3", // total
                  "off":"2", // off target shot
                  "on":"1", // on target shot
                  "g_a":"2" // goal attemps
               },
               "penalties":"0",
               "corners":{
                  "t":"4", // total
                  "f":"4",// final 
                  "h":"2" // 1 half
               },
               "fouls":{
                  "t":null, // total fouls
                  "y_c":"0", // yellow card
                  "y_t_r_c":null, // yellow to red card
                  "r_c":"0"  // red card
               },
               "substitutions":"2",
               "throwins":null,
               "injuries":null,
               "dominance_avg_2_5": "10.10", // average of last 2.5 minutes of dominance index
               "xG" : {
                 "kickoff" : "1.02", // Expected goal at kickoff
                 "live" : "0.88" // Current expected goal
               }
            },
            "manager":{
               "id":"5fb962e92066c1b6",
               "name":"Gama"
            }
         },
         "teamB":{
            // same as teamA
         },
         "events":[
            {
               "type":"goal", // can be: corner, goal, yellow_card, red_card, substitution, penalty_ot_score, penalty_ot_miss
               "timer":"90+1", // event time if + it's overtime or null if is in penalties
               "team":"B" // ref team A or B
            },
            ...
         ],
         "dominance_index": [
            {
                "timer":"00:00", // timer of dominance index
                "teamA":"5",
                "teamB":"5"
             },
             ...
         ],
         "referee":{ // or null
            "id":"5fb96963d60bb8bc",
            "name":"Jesus Gil Manzano"
         },
         "stadium":{
            "id":"5fb96978c6a5b482",
            "name":"Estadio dos Arcos"
         },
         "bet365_url" : "https://www.bet365.EXT/#/AC/B1/C1/D8/E128998076/F3"
      },
      ...
   ]
}
page_1_perPage_100_items_517;id;date;status;timer;championship_id;championship_name;season_name;teamA_id;teamA_name;teamB_id;teamB_name;teamA_score_f;teamB_score_f;teamA_score_1h;teamB_score_1h;teamA_score_2h;teamB_score_2h;teamA_score_o;teamB_score_o;teamA_score_p;teamB_score_p;teamA_possession;teamB_possession;teamA_attacks_n;teamB_attacks_n;teamA_attacks_d;teamB_attacks_d;teamA_off_sides;teamB_off_sides;teamA_shoots;teamB_shoots;teamA_shoots_on_target;teamB_shoots_on_target;teamA_shoots_off_target;teamB_shoots_off_target;teamA_goal_attemps;teamB_goal_attemps;teamA_penalties;teamB_penalties;teamA_corners;teamB_corners;teamA_corners_f;teamB_corners_f;teamA_corners_h;teamB_corners_h;teamA_fouls;teamB_fouls;teamA_yellow_cards;teamB_yellow_cards;teamA_yellow_t_red_cards;teamB_yellow_t_red_cards;teamA_red_cards;teamB_red_cards;teamA_substitutions;teamB_substitutions;teamA_throwins;teamB_throwins;teamA_injuries;teamB_injuries;teamA_manager_id;teamA_manager_name;teamB_manager_id;teamB_manager_name;referee_id;referee_name;stadium_id;stadium_name;teamA_kickoff_xG;teamB_kickoff_xG;teamA_xG;teamB_xG;teamA_position;teamB_position;teamA_past_perfomance;teamB_past_perfomance;teamA_avg_game_goals;teamB_avg_game_goals;teamA_avg_goals_scored;teamB_avg_goals_scored;teamA_avg_goals_conceded;teamB_avg_goals_conceded;teamA_o_1_5_team;teamB_o_1_5_team;teamA_btts;teamB_btts;teamA_o_0_5_game;teamB_o_0_5_game;teamA_o_1_5_game;teamB_o_1_5_game;teamA_o_2_5_game;teamB_o_2_5_game;teamA_o_3_5_game;teamB_o_3_5_game;teamA_t_g_scored;teamB_t_g_scored;teamA_g_scored_0_15_numb;teamB_g_scored_0_15_numb;teamA_g_scored_0_15_perc;teamB_g_scored_0_15_perc;teamA_g_scored_16_30_numb;teamB_g_scored_16_30_numb;teamA_g_scored_16_30_perc;teamB_g_scored_16_30_perc;teamA_g_scored_31_45_numb;teamB_g_scored_31_45_numb;teamA_g_scored_31_45_perc;teamB_g_scored_31_45_perc;teamA_g_scored_46_60_numb;teamB_g_scored_46_60_numb;teamA_g_scored_46_60_perc;teamB_g_scored_46_60_perc;teamA_g_scored_61_75_numb;teamB_g_scored_61_75_numb;teamA_g_scored_61_75_perc;teamB_g_scored_61_75_perc;teamA_g_scored_76_90_numb;teamB_g_scored_76_90_numb;teamA_g_scored_76_90_perc;teamB_g_scored_76_90_perc;teamA_t_g_conceded;teamB_t_g_conceded;teamA_g_conceded_0_15_numb;teamB_g_conceded_0_15_numb;teamA_g_conceded_0_15_perc;teamB_g_conceded_0_15_perc;teamA_g_conceded_16_30_numb;teamB_g_conceded_16_30_numb;teamA_g_conceded_16_30_perc;teamB_g_conceded_16_30_perc;teamA_g_conceded_31_45_numb;teamB_g_conceded_31_45_numb;teamA_g_conceded_31_45_perc;teamB_g_conceded_31_45_perc;teamA_g_conceded_46_60_numb;teamB_g_conceded_46_60_numb;teamA_g_conceded_46_60_perc;teamB_g_conceded_46_60_perc;teamA_g_conceded_61_75_numb;teamB_g_conceded_61_75_numb;teamA_g_conceded_61_75_perc;teamB_g_conceded_61_75_perc;teamA_g_conceded_76_90_numb;teamB_g_conceded_76_90_numb;teamA_g_conceded_76_90_perc;teamB_g_conceded_76_90_perc;bet365_url
;bf07533542292d17;"2024-03-15 00:00:00";ENDED;90:00;fb2bbcb1297555cd;"Bolivia Apertura";"Division Profesional 2024";26bb6623d0f875a7;Bolivar;8179e8ec29799f3;"Jorge Wilstermann";2;1;2;0;2;1;;;;;62;38;89;57;81;44;;;23;14;12;10;11;4;;;0;1;3;9;3;9;1;4;;;4;3;0;0;0;0;4;5;;;;;;;;;;;8766ffcf6e4ac00c;"Estadio Hernando Siles";0.05;0;1.20;1.67;1;2;WLWDW;LDDLL;3.8;1.8;2.2;0.6;1.6;1.2;80;0;80;60;100;80;100;60;80;40;20;0;11;3;0;3;0;33;2;1;17;11;3;1;25;11;2;0;17;0;1;2;8;22;4;2;33;22;8;6;0;5;0;45;3;1;30;9;0;1;0;9;0;1;0;9;3;0;30;0;4;3;40;27;https://www.bet365.EXT/#/AC/B1/C1/D8/E151690228/F3/I0/
...
page_1_perPage_100_items_1416;id;date;status;championship_id;championship_name;season_name;teamA_id;teamA_name;teamB_id;teamB_name;teamA_manager_id;teamA_manager_name;teamB_manager_id;teamB_manager_name;referee_id;referee_name;stadium_id;stadium_name;teamA_kickoff_xG;teamB_kickoff_xG;teamA_xG;teamB_xG;teamA_position;teamB_position;teamA_past_perfomance;teamB_past_perfomance;teamA_avg_game_goals;teamB_avg_game_goals;teamA_avg_goals_scored;teamB_avg_goals_scored;teamA_avg_goals_conceded;teamB_avg_goals_conceded;teamA_o_1_5_team;teamB_o_1_5_team;teamA_btts;teamB_btts;teamA_o_0_5_game;teamB_o_0_5_game;teamA_o_1_5_game;teamB_o_1_5_game;teamA_o_2_5_game;teamB_o_2_5_game;teamA_o_3_5_game;teamB_o_3_5_game;teamA_t_g_scored;teamB_t_g_scored;teamA_g_scored_0_15_numb;teamB_g_scored_0_15_numb;teamA_g_scored_0_15_perc;teamB_g_scored_0_15_perc;teamA_g_scored_16_30_numb;teamB_g_scored_16_30_numb;teamA_g_scored_16_30_perc;teamB_g_scored_16_30_perc;teamA_g_scored_31_45_numb;teamB_g_scored_31_45_numb;teamA_g_scored_31_45_perc;teamB_g_scored_31_45_perc;teamA_g_scored_46_60_numb;teamB_g_scored_46_60_numb;teamA_g_scored_46_60_perc;teamB_g_scored_46_60_perc;teamA_g_scored_61_75_numb;teamB_g_scored_61_75_numb;teamA_g_scored_61_75_perc;teamB_g_scored_61_75_perc;teamA_g_scored_76_90_numb;teamB_g_scored_76_90_numb;teamA_g_scored_76_90_perc;teamB_g_scored_76_90_perc;teamA_t_g_conceded;teamB_t_g_conceded;teamA_g_conceded_0_15_numb;teamB_g_conceded_0_15_numb;teamA_g_conceded_0_15_perc;teamB_g_conceded_0_15_perc;teamA_g_conceded_16_30_numb;teamB_g_conceded_16_30_numb;teamA_g_conceded_16_30_perc;teamB_g_conceded_16_30_perc;teamA_g_conceded_31_45_numb;teamB_g_conceded_31_45_numb;teamA_g_conceded_31_45_perc;teamB_g_conceded_31_45_perc;teamA_g_conceded_46_60_numb;teamB_g_conceded_46_60_numb;teamA_g_conceded_46_60_perc;teamB_g_conceded_46_60_perc;teamA_g_conceded_61_75_numb;teamB_g_conceded_61_75_numb;teamA_g_conceded_61_75_perc;teamB_g_conceded_61_75_perc;teamA_g_conceded_76_90_numb;teamB_g_conceded_76_90_numb;teamA_g_conceded_76_90_perc;teamB_g_conceded_76_90_perc;bet365_url
;9ae9ec0707dbab83;"2024-03-16 00:00:00";NOT_STARTED;fb2bbcb1297555cd;"Bolivia Apertura";"Division Profesional 2024";7458369661028f2d;Blooming;65661a5b7303295f;"Royal Pari FC";;;;;;;9757206ffae25cd5;"Estadio Ramon Tahuichi Aguilera";;;;;;;DWWDW;DLWLW;3;1.8;1.8;1;1.2;0.8;80;20;80;40;80;100;80;60;80;20;20;0;9;5;2;0;22;0;1;1;11;17;2;0;22;0;0;1;0;17;1;1;11;17;3;3;33;50;6;4;1;1;17;20;2;0;33;0;0;1;0;20;0;0;0;0;1;1;17;20;2;2;33;40;https://www.bet365.EXT/#/AC/B1/C1/D8/E151690232/F3/I0/
...
id;date;status;timer;championship_id;championship_name;season_name;teamA_id;teamA_name;teamB_id;teamB_name;teamA_score_f;teamB_score_f;teamA_score_1h;teamB_score_1h;teamA_score_2h;teamB_score_2h;teamA_score_o;teamB_score_o;teamA_score_p;teamB_score_p;teamA_possession;teamB_possession;teamA_attacks_n;teamB_attacks_n;teamA_attacks_d;teamB_attacks_d;teamA_off_sides;teamB_off_sides;teamA_shoots;teamB_shoots;teamA_shoots_on_target;teamB_shoots_on_target;teamA_shoots_off_target;teamB_shoots_off_target;teamA_goal_attemps;teamB_goal_attemps;teamA_penalties;teamB_penalties;teamA_corners;teamB_corners;teamA_corners_f;teamB_corners_f;teamA_corners_h;teamB_corners_h;teamA_fouls;teamB_fouls;teamA_yellow_cards;teamB_yellow_cards;teamA_yellow_t_red_cards;teamB_yellow_t_red_cards;teamA_red_cards;teamB_red_cards;teamA_substitutions;teamB_substitutions;teamA_throwins;teamB_throwins;teamA_injuries;teamB_injuries;teamA_manager_id;teamA_manager_name;teamB_manager_id;teamB_manager_name;referee_id;referee_name;stadium_id;stadium_name
52abd3f287466a68;"2024-03-14 00:00:00";ENDED;90:00;1b8759dd1001931d;"Nicaragua Clausura";"Primera Division 23/24";dd537f4a8e59a4d9;Diriangen;fea2ee56e1913ed;Jalapa;2;1;1;0;2;1;;;;;;;;;;;;;0;0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;d349ba43a3c85c79;"Estadio Cacique Diriangen"

Example of code for direct API

$url = 'https://api.soccerfootball.info/v1/matches/day/basic/?t=TOKEN&d=DATE';

$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/matches/day/basic/?t=TOKEN&d=DATE", {
    "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/matches/day/basic/?t=TOKEN&d=DATE'
};

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

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

url = "https://api.soccerfootball.info/v1/matches/day/basic/?t=TOKEN&d=DATE"

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

print(response)
curl --request GET \
    --url 'https://api.soccerfootball.info/v1/matches/day/basic/?t=TOKEN&d=DATE'
package main

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

func main() {

    url := "https://api.soccerfootball.info/v1/matches/day/basic/?t=TOKEN&d=DATE"

    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/matches/day/basic/?d=DATE';

$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);
$error = 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/matches/day/basic/?d=DATE", {
    "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/matches/day/basic/?d=DATE",
  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/matches/day/basic/?d=DATE"

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/matches/day/basic/?d=DATE \
    --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/matches/day/basic/?d=DATE"

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

}
PreviousMatchesNextday full

Last updated 1 year ago

Was this helpful?

More example of code on

rapidAPI
478KB
How to see API call details
image