Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /golf/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}/golf/get_rankings?ranking_id=29&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
aggr
string
value is either "sum" or "avg"
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 or ftype=json_array)
id
int Required
object id to return
lang
string
two-character language code, defaults to 'en'
rounds
string
list of rounds (comma-seperated) to filter the rankings by those rounds.
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 call
sport
sport value
version
version of the API
method❯
details about the API function
method_id
unique ID of method
name
name of method
people❯
basic people information and golf ranking values
average_points
average_points value
common_name
common name of the person
divisor_actual
actual divisor for the ranking
divisor_applied
applied divisor for the ranking
last_week_rank
rank at the last weeks ranking
nationality_area_code
three character area code
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
people_id
unique identifier for person
points_lost
number of points lost since last rankings
points_won
number of points won since last rankings
position
position value
total_points
total_points value
week
week number of the year
stat❯
details about the stat type
name
name of the stat
type
stat type
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}/golf/get_rankings?ranking_id=29&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}/golf/get_rankings?ranking_id=29&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}/golf/get_rankings?ranking_id=29&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}/golf/get_rankings?ranking_id=29&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success