Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /csgo/get_matches
Returns all matches (and related events) that belong to a season, round or match
Request URL
https://dsg-api.com/clients/{client_name}/csgo/get_matches?type={type}&id={id}&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
age
string
unique identifier for an age group
discipline_id
int
unique identifier for a discipline
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
gender
string
unique identifier for a gender (male,female)
team_id
int
use a team_id as value to filter the matches accordingly
Nodes
round_extra❯
extra round information
current_gameweek
displays the gameweek of nearest match to today
medal_round
indicates if medals are awarded in this round
status
status of the round (Scheduled,Live,Played,Postponed,Cancelled,Break)
total_gameweek
displays the total of gameweeks for this round
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}/csgo/get_matches?type={type}&id={id}&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}/csgo/get_matches?type={type}&id={id}&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}/csgo/get_matches?type={type}&id={id}&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}/csgo/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.164.3","sport":"esport_counterstrikego","lang":"en","generated_utc":"2025-08-01T15:05:07+00:00","method":{"method_id":"164","name":"get_matches"},"tour":{"tour_id":"","name":"","gender":"male","tour_type":"non-tour","tour_season":{"tour_season_id":"","title":"","name":"","logo":"","competition":{"competition_id":"1871","name":"Intel Extreme Masters","area_id":"1","area_name":"World","gender":"male","type":"club","format":"international_cup","last_updated":"2025-03-30 13:09:42","season":{"season_id":"76777","title":"2025 Cologne","start_date":"2025-07-23","end_date":"2025-08-03","original_name":"Intel Extreme Masters","logo":"","last_updated":"2025-07-21 19:18:36","discipline":{"discipline_id":"606","name":"Counter Strike 2","type":"team","gender":{"value":"mixed","age_group":"senior","round":{"round_id":"128708","name":"Play-In - Upper Bracket Round 1","start_date":"2025-07-23","start_time":"","start_date_utc":"2025-07-23","start_time_utc":"","end_date":"2025-07-23","end_time":"","end_date_utc":"2025-07-23","end_time_utc":"","type":"cup","last_updated":"2025-07-21 19:25:00","round_extra":{"current_gameweek":"","total_gameweek":""},"list":{"type":"regular","id":"","name":"","match":[{"match_id":"3813601","date":"2025-07-23","time":"10:30:00","date_utc":"2025-07-23","time_utc":"08:30:00","team_a_id":"29484","team_a_name":"TyLoo","team_a_short_name":"TyLoo","team_a_tla_name":"TYL","team_a_original_name":"TyLoo","team_a_area_id":"49","team_a_area_code":"CHN","team_a_area_name":"China PR","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/29484.png","team_b_id":"27649","team_b_name":"Virtus.pro","team_b_short_name":"Virtus.pro","team_b_tla_name":"VP","team_b_original_name":"Virtus.pro","team_b_area_id":"155","team_b_area_code":"POL","team_b_area_name":"Poland","team_b_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/1160.png","status":"Played","winner":"team_B","score_a":"0","score_b":"2","venue_type":"neutral","final_period":"csgo_p2s","last_updated":"2025-07-23 12:25:48","period_scores":{"period":[{"type":"p1s","score_a":"7","score_b":"13","period_extra":{"map_id":"4","map":"de_inferno"}},{"type":"p2s","score_a":"5","score_b":"13","period_extra":{"map_id":"7","map":"de_overpass"}}]},"broadcasters":[]},{"match_id":"3813600","date":"2025-07-23","time":"10:30:00","date_utc":"2025-07-23","time_utc":"08:30:00","team_a_id":"46003","team_a_name":"Team GamerLegion","team_a_short_name":"GamerLegion","team_a_tla_name":"TGL","team_a_original_name":"Team GamerLegion","team_a_area_id":"184","team_a_area_code":"SWE","team_a_area_name":"Sweden","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/46003.png","team_b_id":"29481","team_b_name":"compLexity","team_b_short_name":"compLexity","team_b_tla_name":"COM","team_b_original_name":"compLexity","team_b_area_id":"203","team_b_area_code":"USA","team_b_area_name":"United States","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/29481.png","status":"Played","winner":"team_A","score_a":"2","score_b":"0","venue_type":"neutral","final_period":"csgo_p1s","last_updated":"2025-07-23 15:29:03","period_scores":{"period":{"type":"p1s","score_a":"13","score_b":"10","period_extra":{"map_id":"4","map":"de_inferno"}}},"broadcasters":[]},{"match_id":"3813602","date":"2025-07-23","time":"13:00:00","date_utc":"2025-07-23","time_utc":"11:00:00","team_a_id":"27644","team_a_name":"Astralis","team_a_short_name":"Astralis","team_a_tla_name":"AST","team_a_original_name":"Astralis","team_a_area_id":"61","team_a_area_code":"DNK","team_a_area_name":"Denmark","team_a_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/727.png","team_b_id":"56799","team_b_name":"B8","team_b_short_name":"B8","team_b_tla_name":"B8","team_b_original_name":"B8","team_b_area_id":"201","team_b_area_code":"UKR","team_b_area_name":"Ukraine","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/56799.png","status":"Played","winner":"team_A","score_a":"2","score_b":"0","venue_type":"neutral","final_period":"csgo_p1s","last_updated":"2025-07-23 17:59:03","period_scores":{"period":{"type":"p1s","score_a":"16","score_b":"12","period_extra":{"map_id":"6","map":"de_mirage"}}},"broadcasters":[]},{"match_id":"3813603","date":"2025-07-23","time":"13:00:00","date_utc":"2025-07-23","time_utc":"11:00:00","team_a_id":"28925","team_a_name":"FlyQuest","team_a_short_name":"Flyquest","team_a_tla_name":"FLY","team_a_original_name":"FlyQuest","team_a_area_id":"19","team_a_area_code":"AUS","team_a_area_name":"Australia","team_a_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/1035.png","team_b_id":"38785","team_b_name":"FURIA Esports","team_b_short_name":"FURIA Esports","team_b_tla_name":"FUR","team_b_original_name":"FURIA Esports","team_b_area_id":"35","team_b_area_code":"BRA","team_b_area_name":"Brazil","team_b_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/1094.png","status":"Played","winner":"team_B","score_a":"1","score_b":"2","venue_type":"neutral","final_period":"csgo_p3s","last_updated":"2025-07-23 17:24:30","period_scores":{"period":[{"type":"p1s","score_a":"7","score_b":"13","period_extra":{"map_id":"4","map":"de_inferno"}},{"type":"p2s","score_a":"19","score_b":"17","period_extra":{"map_id":"3","map":"de_dust2"}},{"type":"p3s","score_a":"10","score_b":"13","period_extra":{"map_id":"6","map":"de_mirage"}}]},"broadcasters":[]},{"match_id":"3813605","date":"2025-07-23","time":"16:20:00","date_utc":"2025-07-23","time_utc":"14:20:00","team_a_id":"34929","team_a_name":"3DMAX","team_a_short_name":"3DMAX","team_a_tla_name":"3DM","team_a_original_name":"3DMAX","team_a_area_id":"76","team_a_area_code":"FRA","team_a_area_name":"France","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/34929.png","team_b_id":"38718","team_b_name":"MIBR","team_b_short_name":"MIBR","team_b_tla_name":"MIB","team_b_original_name":"MIBR","team_b_area_id":"35","team_b_area_code":"BRA","team_b_area_name":"Brazil","team_b_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/1102.png","status":"Played","winner":"team_A","score_a":"2","score_b":"0","venue_type":"neutral","final_period":"csgo_p1s","last_updated":"2025-07-23 21:19:02","period_scores":{"period":{"type":"p1s","score_a":"13","score_b":"5","period_extra":{"map_id":"8","map":"de_train"}}},"broadcasters":[]},{"match_id":"3813604","date":"2025-07-23","time":"17:35:00","date_utc":"2025-07-23","time_utc":"15:35:00","team_a_id":"27651","team_a_name":"FaZe Clan","team_a_short_name":"FaZe Clan","team_a_tla_name":"FAZ","team_a_original_name":"FaZe Clan","team_a_area_id":"7","team_a_area_code":"EUR","team_a_area_name":"Europe","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/27651.png","team_b_id":"29463","team_b_name":"BIG","team_b_short_name":"BIG","team_b_tla_name":"BIG","team_b_original_name":"BIG","team_b_area_id":"80","team_b_area_code":"DEU","team_b_area_name":"Germany","team_b_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/725.png","status":"Played","winner":"team_A","score_a":"2","score_b":"0","venue_type":"neutral","final_period":"csgo_p1s","last_updated":"2025-07-23 22:34:01","period_scores":{"period":[{"type":"p1s","score_a":"13","score_b":"9","period_extra":{"map_id":"4","map":"de_inferno"}},{"type":"p2s","score_a":"13","score_b":"9","period_extra":{"map_id":"146","map":"de_ancient"}}]},"broadcasters":[]},{"match_id":"3813607","date":"2025-07-23","time":"18:25:00","date_utc":"2025-07-23","time_utc":"16:25:00","team_a_id":"27646","team_a_name":"Ninjas in Pyjamas","team_a_short_name":"NiP","team_a_tla_name":"NIP","team_a_original_name":"Ninjas in Pyjamas","team_a_area_id":"184","team_a_area_code":"SWE","team_a_area_name":"Sweden","team_a_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/915.png","team_b_id":"29476","team_b_name":"Heroic","team_b_short_name":"Heroic","team_b_tla_name":"HER","team_b_original_name":"Heroic","team_b_area_id":"61","team_b_area_code":"DNK","team_b_area_name":"Denmark","team_b_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/1096.png","status":"Played","winner":"team_A","score_a":"2","score_b":"1","venue_type":"neutral","final_period":"csgo_p2s","last_updated":"2025-07-23 23:24:01","period_scores":{"period":[{"type":"p1s","score_a":"13","score_b":"9","period_extra":{"map_id":"9","map":"de_nuke"}},{"type":"p2s","score_a":"13","score_b":"9","period_extra":{"map_id":"7","map":"de_overpass"}},{"type":"p3s","score_a":"13","score_b":"9","period_extra":{"map_id":"146","map":"de_ancient"}}]},"broadcasters":[]},{"match_id":"3813606","date":"2025-07-23","time":"19:45:00","date_utc":"2025-07-23","time_utc":"17:45:00","team_a_id":"27645","team_a_name":"Team Liquid","team_a_short_name":"Team Liquid","team_a_tla_name":"TL","team_a_original_name":"Team Liquid","team_a_area_id":"203","team_a_area_code":"USA","team_a_area_name":"United States","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/47869.png","team_b_id":"45708","team_b_name":"paiN Gaming","team_b_short_name":"paiN Gaming","team_b_tla_name":"PNG","team_b_original_name":"paiN Gaming","team_b_area_id":"35","team_b_area_code":"BRA","team_b_area_name":"Brazil","team_b_logo":"https:\/\/www.dsg-images.com\/sport_entity\/200x200\/1104.png","status":"Played","winner":"team_A","score_a":"2","score_b":"0","venue_type":"neutral","final_period":"csgo_p2s","last_updated":"2025-07-23 22:20:39","period_scores":{"period":[{"type":"p1s","score_a":"13","score_b":"7","period_extra":{"map_id":"6","map":"de_mirage"}},{"type":"p2s","score_a":"13","score_b":"8","period_extra":{"map_id":"3","map":"de_dust2"}}]},"broadcasters":[]}]}}}}}}}}}}