DataSportsGroup API - Athletics

Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com

v4 GET /athletics/get_calendar

Returns all tournaments of one year

Request URL

https://dsg-api.com/clients/{client_name}/athletics/get_calendar?ts={tour_season_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

ftype

string

changes feed type from XML to json (ftype=json or ftype=json_array)

lang

string

two-character language code, defaults to 'en'

int Required

unique identifier for a whole season of the particular tour

Nodes

city❯

information about the city

city_id

unique identifier for cities

city_name

name of the city

competition❯

information about the competition

area_id

unique identifier for an area

area_name

name of the area

competition_id

unique identifier for a competition

competition_name

name of the competition

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

discipline❯

details about the discipline

age_group

defines the age group (senior,u23,u22,u21....)

discipline_id

unique identifier of the discipline

gender

determines the gender of the competition (male or female)

name

name of the discipline

type

type of discipline (contestant, contestant_team or team)

winner_id

unique ID of the winner

winner_name

common name of the tournament winner

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

season_extra❯

extra information of the season

status

status of the season (Scheduled,Live,Played,Postponed,Cancelled,Break)

surface

type of surface (grass, artificial turf, ice, sand, water, parquet, asphalt, snow, canvas, hard)

type

type of tournament at the particular tour

tour❯

details about the tour

gender

gender of the tour

name

name of the particular tour

tour_id

unique tour identifier

tour_type

defines if the tournament is part of a tour or not. If not then value "non-tour"

tour_season❯

details about a tour season

logo

full path URL of logo for particular tour_season

name

name of the tour_season

title

title of the particular tour season

tour_season_id

unique identifier of a tour season

Response Headers

200

Success

401

Unauthorized

429

Too Many Requests

Code Samples

PHP
Curl
Python
VB.NET

<?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/athletics/get_calendar?ts={tour_season_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}/athletics/get_calendar?ts={tour_season_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}/athletics/get_calendar?ts={tour_season_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}/athletics/get_calendar?ts={tour_season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success