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

v2 GET /american_football/get_player_rankings Deprecated

Returns different kind of player rankings per season or round

Request URL

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

string Required

defines which stats to display. There is always a _avg or _cum version available (average or cumulative). Valid values are passingyards, rushingyards, receivingyards, tackles, sacks, interceptions, fieldgoals, passingtd, extrapoints

ftype

string

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

int Required

match id to return

lang

string

two-character language code, defaults to 'en'

limit

int

defines limit of the player list. By default no limit is set.

rounds

string

list of rounds (comma-seperated) to filter the rankings by those rounds.

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)

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

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

Response Example

200 Success