DataSportsGroup API - Basketball

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

v3 GET /basketball/get_tables

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

Request URL

https://dsg-api.com/clients/{client_name}/basketball/get_tables?type={type}&id={id}&client={client_name}&authkey={client_authkey}

Parameters

authkey

string Required

client authentification key

client

string Required

unique client ID

conference

string

if set to value "yes" it will show conference standings

date

string

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

ftype

string

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

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

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)

conference❯

basic details about the conference

conference_id

unique identifier for a conference

conference_name

name of the conference

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 the table entry (basketball,nba2k)

area_id

unique identifier for an area

form

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

games_behind

number of matches behind leading team

home

win-loss record for home matches

live

indicates if there is a live game for the team

matches_lost

value for total lost matches

matches_total

value for total played matches

matches_won

value for total won matches

next_match_id

match_id of the upcoming match 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

percentage

win percentage (win/loss)

points_against

value for total runs against

points_for

value for total runs scored

position

position value

prev_season

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

road

win-loss record for away matches

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

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

Response Example

200 Success