DataSportsGroup API - Multi-Sport

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

v2 GET /multisport/get_records

Returns a list of contestants

Request URL

https://dsg-api.com/clients/{client_name}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary

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

int Required

multisport_event_season_id to return

lang

string

two-character language code, defaults to 'en'

sport

string

sport to filter the output

Nodes

contestant❯

details about the record contestant

common_name

common name of the person

first_name

first name of the person

last_name

last name of the person

nationality_area_code

three character area code

nationality_area_id

unique identifier for an area

nationality_area_name

area name of peoples nationality

people_id

unique identifier for person

position

position value

short_name

shortened name of the person

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

day❯

information about the particular day

date

date format YYYY-MM-DD

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)

method❯

details about the API function

method_id

unique ID of method

name

name of method

multisport_event❯

basic informations about the multisport event

area_code

three character area code

area_id

unique identifier for an area

area_name

name of the area

gender

determines the gender of the competition (male or female)

multisport_event_id

unique identifier for multisport events

multisport_event_name

general name of the multisport events

multisport_event_season❯

basic informations about the multisport event season

end_date

end date, format 'yyyy-mm-dd'

multisport_event_season_id

unique identifier for multisport event season

multisport_event_season_name

general name of the multisport event season

start_date

start date, format 'yyyy-mm-dd'

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)

sport❯

basic information of the sport

sport

sport value

sport_name

name of the sport

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}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary");
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}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary"

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}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary"
		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}/multisport/get_records?client={client_name}&authkey={client_authkey}&id={multisport_event_season_id}&cat=summary", auth=("User", "Password"))

Response Example

200 Success