Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
GET /soccer/get_rankings
Returns all matches (and related events) that belong to a season, round or match
Request URL
https://dsg-api.com/clients/{client_name}/soccer/get_rankings?ranking_id=1&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
cat
string
category filter, valid values are "people" and "team"
client
string Required
unique client ID
ev
string Required
defines which stats to display. full list listed in API output by calling without ev= parameter
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
object id to return
lang
string
two-character language code, defaults to 'en'
type
string Required
one of ‘season’ or ‘round’ or ‘competition’ to which the "id" refers
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
sport
sport of the API
version
version of the API
method
details about the API function
method_id
unique ID of method.
name
name of method.
people
Basic information about the person
common_name
common name of the person
count
for _cum it will be in, for _avg it will be float as data type.
count_expulsion
number of expulsions (red cards and yellow-red cards)
count_yellow
number of yellow cards
first_name
first name of the person
last_name
last name of the person
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
people_id
unique identifier for person
people_picture
full path URL of people headshot, size can be changed via the picsize parameter
position
position of the player
short_name
shortened match name of the person
team_id
unique identifier for team of the player
team_name
current team name of players club
team_short_name
short name of the team.
team_tla_name
three-letter-acronym of the players team.
stat
details about the stat
name
name of the stat
type
stat type
team
Details about the team
area_id
area_id of the country
area_name
name of area the team is located
count
for _cum it will be in, for _avg it will be float as data type.
position
position of the player
team_id
unique identifier for team of the player
team_logo
full path URL of team logo
team_name
current team name of players club
team_short_name
short name of the team.
team_tla_name
three-letter-acronym of the players team.
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/soccer/get_rankings?ranking_id=1&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}/soccer/get_rankings?ranking_id=1&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}/soccer/get_rankings?ranking_id=1&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}/soccer/get_rankings?ranking_id=1&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success