Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /cricket/get_matches_day
Returns all matches with basic data which will be played at the selected day.
Request URL
https://dsg-api.com/clients/{client_name}/cricket/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}
API Threshold
  • 10k calls per hour (2.78 calls per second)
  • This threshold applies to ALL your calls you do across the API.
  • Your number of calls get reset every hour at :00
  • If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
comp_id
int
by using a valid competition_id it will filter the todays matches
day
string Required
date to obtain matches (yyyy-mm-dd)
detailed
string
only 'yes' is valid. This parameter can be only used in connection with either &round_id= or &last_updated= .
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
lang
string
two-character language code, defaults to 'en'
last_updated
string
by using valid date time format (yyyy-mm-dd hh:mm:ss) it will display only matches updated after this timestamp. The timestampl cant be older than 6 minutes.
playing
string
only 'yes' is valid to display only current live matches
round_id
int
by using a valid round_id it will filter the todays matches
tz
string
timezone to be used for the call (use PHP timezones like America/New_York )
Nodes
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/cricket/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "{User}:{Password}");
$content = curl_exec($ch);
curl_close($ch);
?>
curl GET -u "User:Password" "https://dsg-api.com/clients/{client_name}/cricket/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}"
Imports System
Imports System.Net	
Imports System.IO
Imports System.Text

Public Module Module1
	Public Sub Main()
		Dim url As String = "https://dsg-api.com/clients/{client_name}/cricket/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}"
		Dim myReq As WebRequest = WebRequest.Create(url)
		myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
		Dim wr As WebResponse = myReq.GetResponse()
		Dim receiveStream As Stream = wr.GetResponseStream()
		Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
		Dim content As String = reader.ReadToEnd()
	End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/cricket/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.1","sport":"cricket","lang":"","method":{"method_id":"39","name":"get_matches_day"},"competition":[{"competition_id":"1079","competition_name":"Twenty20 Internationals","competition_area_id":"1","area_name":"World","season_id":"18001","season_title":"2019","cricket_type":"T20","round_id":"23871","parent_area_id":"","match":{"match_id":"1742131","date":"2019-08-08","time":"16:00:00","date_utc":"2019-08-08","time_utc":"14:00:00","team_a_id":"33580","team_a_name":"Netherlands","team_a_short_name":"Netherlands","team_a_tla_name":"NED","team_a_original_name":"Netherlands","team_a_country":"NLD","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/33580.png","team_b_id":"33583","team_b_name":"United Arab Emirates","team_b_short_name":"UAE","team_b_tla_name":"UAE","team_b_original_name":"United Arab Emirates","team_b_country":"UAE","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/33583.png","status":"Fixture","gameweek":"","winner":"yet unknown","runs_a":"","runs_b":"","wickets_a":"0","wickets_b":"0","overs_a":"0","overs_b":"0","number_days":"","result_text":"","toss_team":"","toss_decision":"","toss_text":"","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"15092","venue_name":"Sportpark Westvliet","venue_city":"Voorburg","competition_id":"1079","competition_name":"Twenty20 Internationals","season_id":"18001","round_id":"23871","last_updated":"2019-07-30 08:15:27"}},{"competition_id":"1820","competition_name":"ICC ODI Championship","competition_area_id":"1","area_name":"World","season_id":"18000","season_title":"2019","cricket_type":"ODI","round_id":"23859","parent_area_id":"","match":{"match_id":"1700493","date":"2019-08-08","time":"15:30:00","date_utc":"2019-08-08","time_utc":"13:30:00","team_a_id":"33574","team_a_name":"Windies","team_a_short_name":"Windies","team_a_tla_name":"WIN","team_a_original_name":"Windies","team_a_country":"WIN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/33574.png","team_b_id":"33577","team_b_name":"India","team_b_short_name":"India","team_b_tla_name":"IND","team_b_original_name":"India","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/33577.png","status":"Fixture","gameweek":"","winner":"yet unknown","runs_a":"","runs_b":"","wickets_a":"0","wickets_b":"0","overs_a":"0","overs_b":"0","number_days":"","result_text":"","toss_team":"","toss_decision":"","toss_text":"","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"1951","venue_name":"Providence National Stadium","venue_city":"Providence","competition_id":"1820","competition_name":"ICC ODI Championship","season_id":"18000","round_id":"23859","last_updated":"2019-07-06 09:21:34"}},{"competition_id":"2066","competition_name":"Non-ICC Test","competition_area_id":"1","area_name":"World","season_id":"20578","season_title":"2019","cricket_type":"Test","round_id":"28311","parent_area_id":"","match":{"match_id":"1700819","date":"2019-08-06","time":"15:30:00","date_utc":"2019-08-06","time_utc":"13:30:00","team_a_id":"41488","team_a_name":"Windies A","team_a_short_name":"Windies A","team_a_tla_name":"WIN","team_a_original_name":"Windies A","team_a_country":"WIN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/33574.png","team_b_id":"38306","team_b_name":"India A","team_b_short_name":"India A","team_b_tla_name":"IND","team_b_original_name":"India A","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/38306.png","status":"Stumps","gameweek":"","winner":"yet unknown","runs_a":"194","runs_b":"201","wickets_a":"10","wickets_b":"13","overs_a":"72","overs_b":"76","number_days":"","result_text":"","toss_team":"41488","toss_decision":"Field","toss_text":"Windies A won the toss and elected to bowl.","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p4s","attendance":"","venue_id":"13274","venue_name":"Brian Lara Cricket Academy","venue_city":"Gasparillo","competition_id":"2066","competition_name":"Non-ICC Test","season_id":"20578","round_id":"28311","last_updated":"2019-08-08 12:31:20"}},{"competition_id":"2165","competition_name":"Twenty20 Cup","competition_area_id":"68","area_name":"England","season_id":"20580","season_title":"2019","cricket_type":"T20","round_id":"28317","parent_area_id":"7","match":{"match_id":"1586349","date":"2019-08-08","time":"19:15:00","date_utc":"2019-08-08","time_utc":"17:15:00","team_a_id":"25831","team_a_name":"Middlesex CCC","team_a_short_name":"Middlesex","team_a_tla_name":"MID","team_a_original_name":"Middlesex Panthers","team_a_country":"ENG","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25831_1.png","team_b_id":"25827","team_b_name":"Surrey CCC","team_b_short_name":"Surrey","team_b_tla_name":"SUR","team_b_original_name":"Surrey Lions","team_b_country":"ENG","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25827_1.png","status":"Fixture","gameweek":"","winner":"yet unknown","runs_a":"","runs_b":"","wickets_a":"0","wickets_b":"0","overs_a":"0","overs_b":"0","number_days":"","result_text":"","toss_team":"","toss_decision":"","toss_text":"","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11983","venue_name":"Lord's Cricket Ground","venue_city":"London","competition_id":"2165","competition_name":"Vitality Blast","season_id":"20580","round_id":"28317","last_updated":"2019-07-15 10:42:04"}},{"competition_id":"2445","competition_name":"Kia Super League","competition_area_id":"68","area_name":"England","season_id":"23317","season_title":"2019","cricket_type":"T20","round_id":"34625","parent_area_id":"7","match":[{"match_id":"1742143","date":"2019-08-08","time":"15:30:00","date_utc":"2019-08-08","time_utc":"13:30:00","team_a_id":"42053","team_a_name":"Surrey Stars","team_a_short_name":"Surrey Stars","team_a_tla_name":"SUR","team_a_original_name":"Surrey Stars","team_a_country":"ENG","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/42053.png","team_b_id":"42050","team_b_name":"Lancashire Thunder","team_b_short_name":"Lancashire","team_b_tla_name":"LAN","team_b_original_name":"Lancashire Thunder","team_b_country":"ENG","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/42050.png","status":"Fixture","gameweek":"","winner":"yet unknown","runs_a":"","runs_b":"","wickets_a":"0","wickets_b":"0","overs_a":"0","overs_b":"0","number_days":"","result_text":"","toss_team":"","toss_decision":"","toss_text":"","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"15096","venue_name":"Woodbridge Road","venue_city":"Guildford","competition_id":"2445","competition_name":"Kia Super League","season_id":"23317","round_id":"34625","last_updated":"2019-07-31 07:21:03"},{"match_id":"1742135","date":"2019-08-08","time":"17:00:00","date_utc":"2019-08-08","time_utc":"15:00:00","team_a_id":"42051","team_a_name":"Loughborough Lightning","team_a_short_name":"Loughborough","team_a_tla_name":"LOU","team_a_original_name":"Loughborough Lightning","team_a_country":"ENG","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/42051.png","team_b_id":"42052","team_b_name":"Southern Vipers","team_b_short_name":"Southern Viper","team_b_tla_name":"SOU","team_b_original_name":"Southern Vipers","team_b_country":"ENG","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/42052.png","status":"Fixture","gameweek":"","winner":"yet unknown","runs_a":"","runs_b":"","wickets_a":"0","wickets_b":"0","overs_a":"0","overs_b":"0","number_days":"","result_text":"","toss_team":"","toss_decision":"","toss_text":"","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"15095","venue_name":"Haslegrave Ground","venue_city":"Loughborough","competition_id":"2445","competition_name":"Kia Super League","season_id":"23317","round_id":"34625","last_updated":"2019-07-31 07:21:03"}]},{"competition_id":"2424","competition_name":"Tamil Nadu Premier League","competition_area_id":"94","area_name":"India","season_id":"22617","season_title":"2019","cricket_type":"T20","round_id":"33830","parent_area_id":"2","match":{"match_id":"1701511","date":"2019-08-08","time":"15:45:00","date_utc":"2019-08-08","time_utc":"13:45:00","team_a_id":"41513","team_a_name":"iDream Karaikudi Kaalai","team_a_short_name":"Karaikudi","team_a_tla_name":"KAR","team_a_original_name":"iDream Karaikudi Kaalai","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/41513.png","team_b_id":"41514","team_b_name":"Siechem Madurai Panthers","team_b_short_name":"Madurai","team_b_tla_name":"MAD","team_b_original_name":"Siechem Madurai Panthers","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/41514.png","status":"Fixture","gameweek":"","winner":"yet unknown","runs_a":"","runs_b":"","wickets_a":"0","wickets_b":"0","overs_a":"0","overs_b":"0","number_days":"","result_text":"","toss_team":"","toss_decision":"","toss_text":"","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"14123","venue_name":"Indian Cement Company Ground","venue_city":"Tirunelveli, Tamil Nadu","competition_id":"2424","competition_name":"Saknar Cement Tamil Nadu Premier League","season_id":"22617","round_id":"33830","last_updated":"2019-07-26 13:39:42"}}]}}