DataSportsGroup API - Sumō

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

v3 GET /sumo/get_tables

Returns the league, home & away tables per season or round.

Request URL

https://dsg-api.com/clients/{client_name}/sumo/get_tables?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

authkey

string Required

client authentification key

client

string Required

unique client ID

date

string

set a date in format yyyy-mm-dd as limit

ftype

string

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

gameweek

int

gameweek value to get table from

int Required

object id to return

lang

string

two-character language code, defaults to 'en'

live

string

only 'yes' is valid which will provide a live table

type

string Required

type is either "season" or "round"

Nodes

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

list❯

details about list type

aggregation_type

aggregation type (scores or wins)

unique identifier for a group if type = group, if type = playoff then for a playoff

last_updated

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

name

name of either a group or playoff

score_a

playoff score of team_a

score_b

playoff score of team_b

type

list type (regular, group or playoff)

winner_team_id

unique identifier for the winning team of the playoff

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)

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

table❯

details about team/contestant table entry

area_id

unique identifier for an area

common_name

common name of the person

contestant_1_common_name

common name of the contestant

contestant_1_first_name

first name of the contestant

contestant_1_id

unique identifier for the contestant

contestant_1_last_name

last name of the contestant

contestant_1_nationality_area_code

area code of contestants nationality

contestant_1_nationality_area_id

unique area_id of the contestants nationality

contestant_1_nationality_area_name

nationality of the contestant

contestant_1_short_name

short name of the contestant

contestant_2_common_name

common name of the contestant

contestant_2_first_name

first name of the contestant

contestant_2_id

unique identifier for the contestant

contestant_2_last_name

last name of the contestant

contestant_2_nationality_area_code

area code of contestants nationality

contestant_2_nationality_area_id

unique area_id of the contestants nationality

contestant_2_nationality_area_name

nationality of the contestant

contestant_2_short_name

short name of the contestant

contestant_team_id

unique identifier for the contestant team/double

first_name

first name of the person

form

performance of the last 5 matches in the particular round (W = win, D = draw, L = loss)

last_name

last name of the person

live

indicates if there is a live game for the team

nationality_area_code

three character area code

nationality_area_id

unique identifier for an area

nationality_area_name

area name of peoples nationality

next_match_id

match_id of the upcoming match in the particular round

next_opponent_contestant_name

contestant name of the next opponent in the particular round

next_opponent_contestant_team_id

contestant_team_id of the next opponent in the particular round

next_opponent_name

current team name of the next opponent in the particular round

next_opponent_team_id

team_id of the next opponent in the particular round

original_team_name

original team name during the season

people_id

unique identifier for person

position

position value

prev_season

defines last season achievements ('C','CW','P','R')

short_name

shortened name of the person

team_id

unique identifier of the team

team_logo

full path URL of team logo

team_name

current team name

zone

name of table zone

zone_id

unique identifier for a table zone

values❯

tables values of the team (badminton/tennis/table_tennis)

games_against

number of games against

games_for

number of games

game_difference

value for total game difference

matches_lost

value for total lost matches

matches_total

value for total played matches

matches_won

value for total won matches

points

value for total points gained

points_against

number of points against

points_difference

value for total points difference

points_for

number of points

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

Response Example

200 Success