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_seasons
Returns all (authorized) seasons (that have been recently updated).
Request URL
https://dsg-api.com/clients/{client_name}/csgo/get_seasons?comp_id={competition_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
authkey
string Required
client authentification key
client
string Required
unique client ID
comp_id
int Required
competition id to get seasons from
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
lang
string
two-character language code, defaults to 'en'
Nodes
competition❯
details about competition
area_id
unique identifier for an area
area_name
name of the area
competition_id
unique identifier for a competition
format
competition format (domestic_league, domestic_cup, domestic_league_cup, domestic_super_cup, international_cup, international_super_cup, playoff, tournament, race, unofficial)
gender
determines the gender of the competition (male or female)
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition
type
determines if a competition is between club teams (club) or national teams (international)
datasportsgroup❯
details about the API version, sport, language and generation timestamp
generated_utc
UTC timestamp when the API output was generated
lang
language of the API call
sport
sport value
version
version of the API
method❯
details about the API function
method_id
unique ID of method
name
name of method
season❯
details about the season
end_date
end date, format 'yyyy-mm-dd'
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
logo
full path URL of logo for particular season
original_name
competition name during this season
season_id
unique identifier for season
start_date
start date, format 'yyyy-mm-dd'
title
title of season
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_seasons?comp_id={competition_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_seasons?comp_id={competition_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_seasons?comp_id={competition_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_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.163.3","sport":"esport_counterstrikego","lang":"en","generated_utc":"2025-08-01T15:05:05+00:00","method":{"method_id":"163","name":"get_seasons"},"competition":{"competition_id":"1871","name":"Intel Extreme Masters","gender":"male","type":"club","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2025-03-30 13:09:42","season":[{"season_id":"76777","title":"2025 Cologne","original_name":"Intel Extreme Masters","start_date":"2025-07-23","end_date":"2025-08-03","logo":"","last_updated":"2025-07-21 19:18:36"},{"season_id":"75725","title":"2025 Dallas","original_name":"Intel Extrem Masters","start_date":"2025-05-19","end_date":"2025-05-25","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1871_1.png","last_updated":"2025-04-20 23:54:36"},{"season_id":"75726","title":"2025 Melbourne","original_name":"Intel Extreme Masters","start_date":"2025-04-21","end_date":"2025-04-27","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1871_1.png","last_updated":"2025-04-21 00:02:16"},{"season_id":"75188","title":"Dallas 2025 Asian Closed Qualifier","original_name":"Intel Extrem Masters","start_date":"2025-02-11","end_date":"2025-02-12","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1871.png","last_updated":"2025-03-30 13:09:29"},{"season_id":"75186","title":"Dallas 2025 NA Closed Qualifier","original_name":"Intel Extrem Masters","start_date":"2025-02-11","end_date":"2025-02-13","logo":"","last_updated":"2025-02-10 23:00:26"},{"season_id":"75187","title":"Dallas 2025 SA Closed Qualifier","original_name":"Intel Extrem Masters","start_date":"2025-02-11","end_date":"2025-02-13","logo":"","last_updated":"2025-02-10 23:00:26"},{"season_id":"75185","title":"Dallas 2025 EU Closed Qualifier","original_name":"Intel Extrem Masters","start_date":"2025-02-10","end_date":"2025-02-20","logo":"","last_updated":"2025-02-12 01:00:27"},{"season_id":"75074","title":"Katowice 2025","original_name":"Intel Extreme Masters","start_date":"2025-01-29","end_date":"2025-02-09","logo":"","last_updated":"2025-01-18 17:06:12"},{"season_id":"73762","title":"2024 Rio","original_name":"Intel Extreme Masters","start_date":"2024-10-07","end_date":"2024-10-13","logo":"","last_updated":"2024-10-06 13:34:08"},{"season_id":"73390","title":"2024 Cologne","original_name":"Intel Extreme Masters","start_date":"2024-08-07","end_date":"2024-08-18","logo":"","last_updated":"2024-08-06 21:26:25"},{"season_id":"72693","title":"Dallas 2024","original_name":"Intel Extreme Masters","start_date":"2024-05-27","end_date":"2024-06-02","logo":"","last_updated":"2024-05-24 11:48:40"},{"season_id":"72361","title":"2024 Chengdu","original_name":"Intel Extreme Masters","start_date":"2024-04-08","end_date":"2024-04-14","logo":"","last_updated":"2024-04-02 10:13:46"},{"season_id":"71821","title":"2024 Katowice","original_name":"Intel Extreme Masters","start_date":"2024-01-31","end_date":"2024-02-11","logo":"","last_updated":"2024-01-31 09:39:40"},{"season_id":"70541","title":"2023 Sydney","original_name":"Intel Extreme Masters","start_date":"2023-10-16","end_date":"2023-10-22","logo":"","last_updated":"2023-10-15 13:45:06"},{"season_id":"69515","title":"Cologne 2023","original_name":"Intel Extreme Masters","start_date":"2023-07-26","end_date":"2023-08-06","logo":"","last_updated":"2023-07-24 08:12:23"},{"season_id":"68373","title":"Dallas 2023","original_name":"Intel Extreme Masters","start_date":"2023-05-29","end_date":"2023-06-04","logo":"","last_updated":"2023-05-24 09:15:37"},{"season_id":"68213","title":"Rio 2023","original_name":"Intel Extreme Masters","start_date":"2023-04-17","end_date":"2023-04-23","logo":"","last_updated":"2023-04-16 08:42:19"},{"season_id":"67811","title":"Katowice 2023","original_name":"Intel Extreme Masters","start_date":"2023-02-01","end_date":"2023-02-12","logo":"","last_updated":"2023-01-30 23:00:19"},{"season_id":"67100","title":"Rio Major 2022","original_name":"Intel Extreme Masters","start_date":"2022-10-31","end_date":"2022-11-13","logo":"","last_updated":"2022-10-21 22:23:01"},{"season_id":"66013","title":"XVII-Cologne","original_name":"Intel Extreme Masters","start_date":"2022-07-05","end_date":"2022-07-17","logo":"","last_updated":"2022-06-24 17:45:13"},{"season_id":"65416","title":"XVII - Dallas","original_name":"Intel Extreme Masters","start_date":"2022-05-30","end_date":"2022-06-05","logo":"","last_updated":"2022-05-24 19:34:24"},{"season_id":"64749","title":"XVI - Katowice","original_name":"Intel Extreme Masters","start_date":"2022-02-15","end_date":"2022-02-27","logo":"","last_updated":"2022-02-13 11:04:51"},{"season_id":"62330","title":"XVI - Winter","original_name":"Intel Extreme Masters","start_date":"2021-12-02","end_date":"2021-12-12","logo":"","last_updated":"2021-12-01 08:49:36"},{"season_id":"58687","title":"Season XVI - Fall: North America","original_name":"Intel Extreme Masters","start_date":"2021-10-05","end_date":"2021-10-11","logo":"","last_updated":"2021-10-11 16:00:04"},{"season_id":"58111","title":"Season XVI - Fall: CIS","original_name":"Intel Extreme Masters","start_date":"2021-09-29","end_date":"2021-10-28","logo":"","last_updated":"2021-10-28 06:00:06"},{"season_id":"58098","title":"Season XVI - Fall: Europe","original_name":"Intel Extreme Masters","start_date":"2021-09-29","end_date":"2021-10-31","logo":"","last_updated":"2021-10-31 23:00:03"},{"season_id":"51858","title":"XVI-Cologne 2021","original_name":"Intel Extreme Masters","start_date":"2021-07-06","end_date":"2021-07-18","logo":"","last_updated":"2021-07-05 15:24:56"},{"season_id":"50899","title":"Summer 2021","original_name":"Intel Extreme Masters XVI","start_date":"2021-06-03","end_date":"2021-06-13","logo":"","last_updated":"2021-06-01 20:58:01"},{"season_id":"48996","title":"2021 Katowice","original_name":"Intel Extreme Masters XV","start_date":"2021-02-16","end_date":"2021-05-10","logo":"","last_updated":"2021-05-10 16:00:05"},{"season_id":"47421","title":"Global Challenge","original_name":"Intel Extreme Masters XV","start_date":"2020-12-15","end_date":"2020-12-20","logo":"","last_updated":"2020-12-07 16:01:06"},{"season_id":"46852","title":"XV - Beijing Online: Europe","original_name":"Intel Extreme Masters","start_date":"2020-11-06","end_date":"2020-11-22","logo":"","last_updated":"2020-11-05 12:42:58"},{"season_id":"46854","title":"XV - Beijing Online: North America","original_name":"Intel Extreme Masters","start_date":"2020-11-06","end_date":"2020-11-22","logo":"","last_updated":"2020-11-05 13:23:34"},{"season_id":"46297","title":"XV - New York Online: CIS","original_name":"Intel Extreme Masters","start_date":"2020-10-13","end_date":"2020-10-25","logo":"","last_updated":"2020-10-05 14:06:11"},{"season_id":"46295","title":"XV - New York Online: Europe","original_name":"Intel Extreme Masters","start_date":"2020-10-06","end_date":"2020-10-11","logo":"","last_updated":"2020-10-05 14:06:11"},{"season_id":"46296","title":"XV - New York Online: North America","original_name":"Intel Extreme Masters","start_date":"2020-10-06","end_date":"2020-10-18","logo":"","last_updated":"2020-10-05 14:06:11"},{"season_id":"32212","title":"XIV - World Championship","original_name":"Intel Extreme Masters","start_date":"2020-02-24","end_date":"2020-03-01","logo":"","last_updated":"2020-06-17 10:56:49"},{"season_id":"32294","title":"XIV - Beijing","original_name":"Intel Extreme Masters","start_date":"2019-11-07","end_date":"2020-11-08","logo":"","last_updated":"2020-06-19 17:00:15"},{"season_id":"32251","title":"XIV - Chicago","original_name":"Intel Extreme Masters","start_date":"2019-07-18","end_date":"2020-07-20","logo":"","last_updated":"2020-06-19 18:00:18"},{"season_id":"32217","title":"XIV - Sydney","original_name":"Intel Extreme Masters","start_date":"2019-04-29","end_date":"2019-05-05","logo":"","last_updated":"2020-06-17 10:57:47"},{"season_id":"20861","title":"XIII - Katowice Major 2019","original_name":"Intel Extreme Masters","start_date":"2019-02-13","end_date":"2019-03-03","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1871.png","last_updated":"2019-02-07 00:08:54"},{"season_id":"19762","title":"XIII - Chicago","original_name":"Intel Extreme Masters","start_date":"2018-11-06","end_date":"2018-11-11","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1871.png","last_updated":"2018-12-16 15:10:03"},{"season_id":"16294","title":"XIII - Sydney","original_name":"Intel Extreme Masters","start_date":"2018-05-01","end_date":"2018-05-06","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1871.png","last_updated":"2018-05-21 17:36:55"}]}}}