No Subscription to this function
GET /field_hockey/get_player_rankings
Returns different kind of player rankings per season or round
Request URL
https://dsg-api.com/clients/{client_name}/field_hockey/get_player_rankings?type=season&id={season_id}&ev=goals&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ev
string Required
defines which stats to display. There is always a _avg or _cum version available (average or cumulative). Valid values are behinds, goals and points.
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
round or season ID
lang
string
two-character language code, defaults to 'en'
limit
int
defines limit of the player list. By default no limit is set.
type
string Required
type is either "season" or "round"
Nodes
competition
Details about competition
area_id
unique identifier for area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
format
competition format to filter out leagues or cups
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition.
teamtype
determines the type of team/competition (male,female,male_youth,female_youth)
type
determines if a competition is between club teams (club) or national teams (international).
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.
first_name
first name of the person
last_name
last name of the person
match_name
shortened match name of the person
nationality
nationality of the person
people_id
unique identifier for person
position
position of the player
team
current team name of players club
team_id
unique identifier for team of the player
team_short_name
short name of the team.
team_tla_name
three-letter-acronym of the players team.
rounds
Details about round
current_gameweek
displays the gameweek of nearest match to today
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.
name
name of round
round_id
unique identifier of round.
start_date
start date, format 'yyyy-mm-dd'.
type
Determines if the round contains a table or a cup structure (knock-out).
season
Details about 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
Rate limit exceeded
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/field_hockey/get_player_rankings?type=season&id={season_id}&ev=goals&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}/field_hockey/get_player_rankings?type=season&id={season_id}&ev=goals&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/field_hockey/get_player_rankings?type=season&id={season_id}&ev=goals&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"field_hockey","lang":"en","method":{"method_id":"204","name":"get_player_rankings"},"competition":{"competition_id":"1958","name":"Hockey Champions Trophy","teamtype":"male","type":"international","format":"international_cup","area_id":"1","area_name":"World","last_updated":"2018-09-08 11:55:41","season":{"season_id":"16921","title":"2018 Netherlands","original_name":"Rabobank Hockey Champions Trophy","start_date":"2018-06-23","end_date":"2018-07-01","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1958.png","last_updated":"2018-06-23 00:32:00","player_rankings":{"people":[{"position":"1","people_id":"260014","first_name":"Gonzalo","last_name":"Peillat","match_name":"G. Peillat","common_name":"Gonzalo Peillat","nationality":"Argentina","count":"6","team_id":"36644","team_name":"Argentina","team_short_name":"Argentina","team_tla_name":"ARG","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260014.png"},{"position":"2","people_id":"260087","first_name":"Mirco","last_name":"Pruijser","match_name":"M. Pruijser","common_name":"Mirco Pruijser","nationality":"Netherlands","count":"5","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260087.png"},{"position":"3","people_id":"259955","first_name":"Blake","last_name":"Govers","match_name":"B. Govers","common_name":"Blake Govers","nationality":"Australia","count":"4","team_id":"36640","team_name":"Australia","team_short_name":"Australia","team_tla_name":"AUS","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259955.png"},{"position":"4","people_id":"260051","first_name":"Muhammad Aleem","last_name":"Bilal","match_name":"Muhammad Aleem Bilal","common_name":"Muhammad Aleem Bilal","nationality":"Pakistan","count":"3","team_id":"36643","team_name":"Pakistan","team_short_name":"Pakistan","team_tla_name":"PAK","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260051.png"},{"position":"5","people_id":"260033","first_name":"Harmanpreet","last_name":"Singh","match_name":"H. Singh","common_name":"Harmanpreet Singh","nationality":"India","count":"3","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260033.png"},{"position":"6","people_id":"259957","first_name":"Trent","last_name":"Mitton","match_name":"T. Mitton","common_name":"Trent Mitton","nationality":"Australia","count":"3","team_id":"36640","team_name":"Australia","team_short_name":"Australia","team_tla_name":"AUS","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259957.png"},{"position":"7","people_id":"260083","first_name":"Jeroen","last_name":"Hertzberger","match_name":"J. Hertzberger","common_name":"Jeroen Hertzberger","nationality":"Netherlands","count":"3","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260083.png"},{"position":"8","people_id":"260021","first_name":"Matías","last_name":"Paredes","match_name":"M. Paredes","common_name":"Matías Paredes","nationality":"Argentina","count":"2","team_id":"36644","team_name":"Argentina","team_short_name":"Argentina","team_tla_name":"ARG","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260021.png"},{"position":"9","people_id":"260067","first_name":"Ajaz","last_name":"Ahmad","match_name":"Ajaz Ahmad","common_name":"Ajaz Ahmad","nationality":"Pakistan","count":"2","team_id":"36643","team_name":"Pakistan","team_short_name":"Pakistan","team_tla_name":"PAK","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260067.png"},{"position":"10","people_id":"259958","first_name":"Tim","last_name":"Brand","match_name":"T. Brand","common_name":"Tim Brand","nationality":"Australia","count":"2","team_id":"36640","team_name":"Australia","team_short_name":"Australia","team_tla_name":"AUS","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259958.png"},{"position":"11","people_id":"260042","first_name":"Mandeep","last_name":"Singh","match_name":"M. Singh","common_name":"Mandeep Singh","nationality":"India","count":"2","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260042.png"},{"position":"12","people_id":"259948","first_name":"Lachlan","last_name":"Sharp","match_name":"L. Sharp","common_name":"Lachlan Sharp","nationality":"Australia","count":"2","team_id":"36640","team_name":"Australia","team_short_name":"Australia","team_tla_name":"AUS","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259948.png"},{"position":"13","people_id":"260161","first_name":"Florent","last_name":"van Aubel","match_name":"F. van Aubel","common_name":"Florent van Aubel","nationality":"Belgium","count":"2","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260161.png"},{"position":"14","people_id":"260152","first_name":"Amaury","last_name":"Keusters","match_name":"A. Keusters","common_name":"Amaury Keusters","nationality":"Belgium","count":"2","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260152.png"},{"position":"15","people_id":"260171","first_name":"Tom","last_name":"Boon","match_name":"T. Boon","common_name":"Tom Boon","nationality":"Belgium","count":"2","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260171.png"},{"position":"16","people_id":"260157","first_name":"Cédric","last_name":"Charlier","match_name":"C. Charlier","common_name":"Cédric Charlier","nationality":"Belgium","count":"2","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260157.png"},{"position":"17","people_id":"260094","first_name":"Roel","last_name":"Bovendeert","match_name":"R. Bovendeert","common_name":"Roel Bovendeert","nationality":"Netherlands","count":"2","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260094.png"},{"position":"18","people_id":"260054","first_name":"Mohammed Toseeq","last_name":"Arshad","match_name":"Toseeq Arshad","common_name":"Toseeq Arshad","nationality":"Pakistan","count":"1","team_id":"36643","team_name":"Pakistan","team_short_name":"Pakistan","team_tla_name":"PAK","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260054.png"},{"position":"19","people_id":"260059","first_name":"Ali","last_name":"Shan","match_name":"Ali Shan","common_name":"Ali Shan","nationality":"Pakistan","count":"1","team_id":"36643","team_name":"Pakistan","team_short_name":"Pakistan","team_tla_name":"PAK","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260059.png"},{"position":"20","people_id":"260052","first_name":"Mubashar","last_name":"Ali","match_name":"Mubashar Ali","common_name":"Mubashar Ali","nationality":"Pakistan","count":"1","team_id":"36643","team_name":"Pakistan","team_short_name":"Pakistan","team_tla_name":"PAK","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260052.png"},{"position":"21","people_id":"260062","first_name":"Muhammad","last_name":"Irfan Jr.","match_name":"Muhammad Irfan Jr.","common_name":"Muhammad Irfan Jr.","nationality":"Pakistan","count":"1","team_id":"36643","team_name":"Pakistan","team_short_name":"Pakistan","team_tla_name":"PAK","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260062.png"},{"position":"22","people_id":"260047","first_name":"Vivek Sagar","last_name":"Prasad","match_name":"V. Prasad","common_name":"Vivek Prasad","nationality":"India","count":"1","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":""},{"position":"23","people_id":"260035","first_name":"Varun","last_name":"Kumar","match_name":"V. Kumar","common_name":"Varun Kumar","nationality":"India","count":"1","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260035.png"},{"position":"24","people_id":"259943","first_name":"Jake","last_name":"Harvie","match_name":"J. Harvie","common_name":"Jake Harvie","nationality":"Australia","count":"1","team_id":"36640","team_name":"Australia","team_short_name":"Australia","team_tla_name":"AUS","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259943.png"},{"position":"25","people_id":"259949","first_name":"Tom","last_name":"Craig","match_name":"T. Craig","common_name":"Tom Craig","nationality":"Australia","count":"1","team_id":"36640","team_name":"Australia","team_short_name":"Australia","team_tla_name":"AUS","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259949.png"},{"position":"26","people_id":"260046","first_name":"Dilpreet","last_name":"Singh","match_name":"D. Singh","common_name":"Dilpreet Singh","nationality":"India","count":"1","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260046.png"},{"position":"27","people_id":"259954","first_name":"Jacob","last_name":"Whetton","match_name":"J. Whetton","common_name":"Jake Whetton","nationality":"Australia","count":"1","team_id":"36640","team_name":"Australia","team_short_name":"Australia","team_tla_name":"AUS","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/259954.png"},{"position":"28","people_id":"260043","first_name":"Lalit","last_name":"Upadhyay","match_name":"L. Upadhyay","common_name":"Lalit Upadhyay","nationality":"India","count":"1","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260043.png"},{"position":"29","people_id":"260038","first_name":"Manpreet","last_name":"Singh Pawar","match_name":"M. Singh","common_name":"Manpreet Singh","nationality":"India","count":"1","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260038.png"},{"position":"30","people_id":"260045","first_name":"Ramandeep","last_name":"Singh","match_name":"R. Singh","common_name":"Ramandeep Singh","nationality":"India","count":"1","team_id":"36651","team_name":"India","team_short_name":"India","team_tla_name":"IND","player_picture":""},{"position":"31","people_id":"260170","first_name":"Thomas","last_name":"Briels","match_name":"T. Briels","common_name":"Thomas Briels","nationality":"Belgium","count":"1","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260170.png"},{"position":"32","people_id":"260165","first_name":"Loïck","last_name":"Luypaert","match_name":"L. Luypaert","common_name":"Loïck Luypaert","nationality":"Belgium","count":"1","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260165.png"},{"position":"33","people_id":"260163","first_name":"John-John","last_name":"Dohmen","match_name":"J. Dohmen","common_name":"John-John Dohmen","nationality":"Belgium","count":"1","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260163.png"},{"position":"34","people_id":"260155","first_name":"Arthur","last_name":"de Sloover","match_name":"A. de Sloover","common_name":"Arthur de Sloover","nationality":"Belgium","count":"1","team_id":"36648","team_name":"Belgium","team_short_name":"Belgium","team_tla_name":"BEL","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260155.png"},{"position":"35","people_id":"260079","first_name":"Thierry","last_name":"Brinkman","match_name":"T. Brinkman","common_name":"Thierry Brinkman","nationality":"Netherlands","count":"1","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260079.png"},{"position":"36","people_id":"260081","first_name":"Thijs","last_name":"van Dam","match_name":"T. van Dam","common_name":"Thijs van Dam","nationality":"Netherlands","count":"1","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260081.png"},{"position":"37","people_id":"260090","first_name":"Valentin","last_name":"Verga","match_name":"V. Verga","common_name":"Valentin Verga","nationality":"Netherlands","count":"1","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260090.png"},{"position":"38","people_id":"260084","first_name":"Robbert","last_name":"Kemperman","match_name":"R. Kemperman","common_name":"Robbert Kemperman","nationality":"Netherlands","count":"1","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260084.png"},{"position":"39","people_id":"260075","first_name":"Severiano","last_name":"van Ass","match_name":"S. van Ass","common_name":"Seve van Ass","nationality":"Netherlands","count":"1","team_id":"36646","team_name":"Netherlands","team_short_name":"Netherlands","team_tla_name":"NED","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/260075.png"}]}}}}}