DataSportsGroup API - American Football

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

v3 GET /american_football/get_tables

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

Request URL

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

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 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

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

area_id

unique identifier for an area

form

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

live

indicates if there is a live game for the team

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

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

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

values❯

tables values of the team (american football)

conference

conference records like w-l-t (win-loss-tied)

division

division records like w-l-t (win-loss-tied)

home

win-loss record for home matches

matches_lost

value for total lost matches

matches_tied

value for total tied matches

matches_won

value for total won matches

percentage

win percentage (win/loss)

points_against

value for total points against

points_for

value for total points made

road

win-loss record for away matches

streak

losing/winning streaks in format like W5, L3 etc

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

Response Example

200 Success