DataSportsGroup API - Athletics

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

v3 GET /athletics/get_results

Returns the results of the specific round/discipline

Request URL

https://dsg-api.com/clients/{client_name}/athletics/get_results?id={season_id}&type=season&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

discipline_id

int

unique identifier for a discipline

ftype

string

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

int Required

season or round id to return

lang

string

two-character language code, defaults to 'en'

type

string Required

type is either "season" or "round"

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)

contestant❯

athletics results for the contestant

attempt_1_length

length of the 1st attempt

attempt_1_wind

strength of the wind during 1st attempt

attempt_2_length

length of the 2nd attempt

attempt_2_wind

strength of the wind during 2nd attempt

attempt_3_length

length of the 3rd attempt

attempt_3_wind

strength of the wind during 3rd attempt

attempt_4_length

length of the 4th attempt

attempt_4_wind

strength of the wind during 4th attempt

attempt_5_length

length of the 5th attempt

attempt_5_wind

strength of the wind during 5th attempt

attempt_6_length

length of the 6th attempt

attempt_6_wind

strength of the wind during 6th attempt

attempt_fixed_10_length

outcome of the 10th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_11_length

outcome of the 11th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_12_length

outcome of the 12th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_1_length

outcome of the 1st attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_2_length

outcome of the 2nd attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_3_length

outcome of the 3rd attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_4_length

outcome of the 4th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_5_length

outcome of the 5th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_6_length

outcome of the 6th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_7_length

outcome of the 7th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_8_length

outcome of the 8th attempt (- = skipped, o = succesful, x = failed)

attempt_fixed_9_length

outcome of the 9th attempt (- = skipped, o = succesful, x = failed)

bib_number

bib number of the contestant for this round

common_name

common name of the person

fail_start

number of failed starts

first_name

first name of the person

lane

number of the lane for the contestant/team

last_name

last name of the person

length

best length of the contestant

nationality_area_code

three character area code

nationality_area_id

unique identifier for an area

nationality_area_name

area name of peoples nationality

order

number of order in which the contestant competed in this round

order_final

number of order after the first cut of this round

order_last_attempt

number of order for the last attempt of the round

people_id

unique identifier for person

position

position value

reaction_time

total reaction time for this round (in seconds)

record

type of record for the contestant or team (SB,PB,WR,OR etc)

red_cards

value of the particular stat

short_name

shortened name of the person

split_time_1000m

split time at 1000m

split_time_10km

split time at 10km

split_time_1200m

split time at 1200m

split_time_15km

split time at 15km

split_time_2000m

split time at 2000m

split_time_20km

split time at 20km

split_time_25km

split time at 25km

split_time_3000m

split time at 3000m

split_time_30km

split time at 30km

split_time_35km

split time at 35km

split_time_4000m

split time at 4000m

split_time_400m

split time at 400m

split_time_40km

split time at 40km

split_time_45km

split time at 45km

split_time_5000m

split time at 5000m

split_time_5km

split time at 5km

split_time_6000m

split time at 6000m

split_time_7000m

split time at 7000m

split_time_8000m

split time at 8000m

split_time_800m

split time at 800m

split_time_9000m

split time at 9000m

split_time_half_marathon

split time at Half Marathon

status

status for this round, mainly if qualified or not (qualied = Q for example)

time

total time for this round

yellow_card

number of yellow cards received (mainly for sprints)

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❯

basic information about the discipline

discipline_id

unique identifier of the discipline

name

name of the discipline

type

type of discipline (contestant, contestant_team or team)

gender❯

details about the gender

age_group

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

value

gender type (male, female or mixed)

method❯

details about the API function

method_id

unique ID of method

name

name of method

round❯

details about the round

end_date

end date, format 'yyyy-mm-dd'

end_date_utc

end date in UTC timezone, format 'yyyy-mm-dd'

end_time

end time, format 'HH:mm:ss'

end_time_utc

end time in UTC timezone, format 'HH:mm:ss'

last_updated

When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.

name

name of round

round_id

unique identifier of round

start_date

start date, format 'yyyy-mm-dd'

start_date_utc

start date in UTC timezone, format 'yyyy-mm-dd'.

start_time

start time, format 'HH:mm:ss'

start_time_utc

start time in UTC timezone, format 'HH:mm:ss'

type

determines if the round contains a table or a cup structure (knock-out)

round_extra❯

extra round details

medal_round

indicates if medals are awarded in this round

status

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

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

team❯

result informations for the team (athletics)

bib_number

bib number of the contestant for this round

lane

lane of the contestant

position

position value

record

type of record for the contestant or team (SB,PB,WR,OR etc)

split_time_400m

split time at 400m

status

status for this round, mainly if qualified or not (qualied = Q for example)

team_area_code

three-letter acronym for the area of the team

team_area_id

unique identifier for an area

team_area_name

area name of the team

team_id

unique identifier of the team

team_name

current team name

team_short_name

short name of the team

time

time of the contestant (either time or just Q )

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

venue❯

basic details about the venue

venue_area_id

unique identifier for an area

venue_area_name

name of the area

venue_city

city where the venue is based

venue_id

unique identifier of the venue

venue_image

full path URL of venue or circuit image

venue_name

current name of the venue

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_results?id={season_id}&type=season&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_results?id={season_id}&type=season&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_results?id={season_id}&type=season&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_results?id={season_id}&type=season&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))

Response Example

200 Success