> For the complete documentation index, see [llms.txt](https://info.soccerfootball.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://info.soccerfootball.info/v1/matches/day-basic.md). # 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`** | {% tabs %} {% tab title="200 Success response" %} {% tabs %} {% tab title="JSON" %} ```javascript { "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" }, ... ] } ``` {% endtab %} {% tab title="CSV today" %} ``` 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/ ... ``` {% endtab %} {% tab title="CSV future" %} ``` 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/ ... ``` {% endtab %} {% tab title="CSV past" %} ``` 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" ``` {% 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/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; } ``` {% endtab %} {% tab title="Javascript" %} ```python 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); }); ``` {% endtab %} {% tab title="NodeJS" %} ```javascript 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); }); ``` {% endtab %} {% tab title="Phyton" %} ```python import requests url = "https://api.soccerfootball.info/v1/matches/day/basic/?t=TOKEN&d=DATE" response = requests.get(url).json() print(response) ``` {% endtab %} {% tab title="cURL" %} ```bash curl --request GET \ --url 'https://api.soccerfootball.info/v1/matches/day/basic/?t=TOKEN&d=DATE' ``` {% endtab %} {% tab title="GO" %} ```go 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)) } ``` {% endtab %} {% endtabs %} ## Example of code for RapidAPI {% tabs %} {% tab title="PHP" %} ```php $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; } ``` {% endtab %} {% tab title="Javascript" %} ```javascript 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); }); ``` {% endtab %} {% tab title="NodeJS" %} ```javascript 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); }); ``` {% endtab %} {% tab title="Phyton" %} ```python 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) ``` {% endtab %} {% tab title="cURL" %} ```bash 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' ``` {% endtab %} {% tab title="GO" %} ```go 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)) } ``` {% endtab %} {% endtabs %} More example of code on [rapidAPI](https://rapidapi.com/soccerfootball-info-soccerfootball-info-default/api/soccer-football-info)