No Subscription to this function
GET /tennis/get_peoples
Returns person informations
Request URL
https://dsg-api.com/clients/{client_name}/tennis/get_peoples?id=450133&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
player id to return
lang
string
two-character language code, defaults to 'en'
Nodes
match
Details about last matches of the particular contestant
contestant_a_common_name
common name of the contestant
contestant_a_draw_position
darw position of the contestant
contestant_a_first_name
first name of the contestant
contestant_a_id
unique identifier for the contestant
contestant_a_last_name
last name of the contestant
contestant_a_nationality
nationality of the contestant
contestant_a_seeding
seeding of the contestant
contestant_b_common_name
common name of the contestant
contestant_b_draw_position
darw position of the contestant
contestant_b_first_name
first name of the contestant
contestant_b_id
unique identifier for the contestant
contestant_b_last_name
last name of the contestant
contestant_b_nationality
nationality of the contestant
contestant_b_seeding
seeding of the contestant
date
Date of match, format 'yyyy-mm-dd' (CET)
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
score_a
full-time score of home team, including any goals in extra-time
score_b
full-time score of home team, including any goals in extra-time
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
time
start time (CET), format 'hh:mm:ss'.
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
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
country_of_birth
name of the country the person was born
date_of_birth
birth date of the person
first_name
first name of the person
gender
gender of the person ('male' or 'female')
hand
strong hand of the player
height
Height of person in centimeters
last_name
last name of the person
match_name
shortened match name of the person
nationality
current nationality of the person
people_id
unique identifier for person
place_of_birth
name of city the person was born
player_picture
full path URL of player headshot, size can be changed via the picsize parameter
weight
Weight of person in kilograms.
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}/tennis/get_peoples?id=450133&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}/tennis/get_peoples?id=450133&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/tennis/get_peoples?id=450133&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"tennis","lang":"en","method":{"method_id":"127","name":"get_peoples"},"people":{"people_id":"450133","first_name":"Roger","last_name":"Federer","match_name":"R. Federer","common_name":"Roger Federer","date_of_birth":"1981-08-08","place_of_birth":"Basel","country_of_birth":"Switzerland","nationality":"Switzerland","gender":"male","height":"185","weight":"85","hand":"Right","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/450133.png","last_matches":{"singles":{"match":[{"match_id":"35946","round_id":"33372","round_title":"Final","date":"2019-07-14","time":"15:10:00","date_utc":"2019-07-14","time_utc":"13:10:00","contestant_a_id":"449922","contestant_a_first_name":"Novak","contestant_a_last_name":"Djokovic","contestant_a_common_name":"Novak Djokovic","contestant_a_match_name":"N. Djokovic","contestant_a_nationality":"SER","contestant_a_seeding":"1","contestant_a_draw_position":"1","contestant_b_id":"450133","contestant_b_first_name":"Roger","contestant_b_last_name":"Federer","contestant_b_common_name":"Roger Federer","contestant_b_match_name":"R. Federer","contestant_b_nationality":"CHE","contestant_b_seeding":"2","contestant_b_draw_position":"127","winner":"contestant_a","status":"Played","final_period":"ten_p5s","score_a":"3","score_b":"2","last_updated":"2019-07-14 20:21:10","tournament_id":"1216","tournament_name":"Wimbledon","season_id":"19925","season_title":"2019 Mens Singles","season_name":"Wimbledon","surface":"Grass","gender":"male","type":"Grand Slam","single_double":"Singles","set":[{"num":"1","score_a":"7","score_b":"6","tie_break_score_a":"7","tie_break_score_b":"5","winner":"contestant_a"},{"num":"2","score_a":"1","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"3","score_a":"7","score_b":"6","tie_break_score_a":"7","tie_break_score_b":"4","winner":"contestant_a"},{"num":"4","score_a":"4","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"5","score_a":"13","score_b":"12","tie_break_score_a":"7","tie_break_score_b":"3","winner":""}]},{"match_id":"35945","round_id":"33371","round_title":"Semi-finals","date":"2019-07-12","time":"17:40:00","date_utc":"2019-07-12","time_utc":"15:40:00","contestant_a_id":"449826","contestant_a_first_name":"Rafael","contestant_a_last_name":"Nadal","contestant_a_common_name":"Rafael Nadal","contestant_a_match_name":"R. Nadal","contestant_a_nationality":"ESP","contestant_a_seeding":"3","contestant_a_draw_position":"96","contestant_b_id":"450133","contestant_b_first_name":"Roger","contestant_b_last_name":"Federer","contestant_b_common_name":"Roger Federer","contestant_b_match_name":"R. Federer","contestant_b_nationality":"CHE","contestant_b_seeding":"2","contestant_b_draw_position":"127","winner":"contestant_b","status":"Played","final_period":"ten_p4s","score_a":"1","score_b":"3","last_updated":"2019-07-14 20:21:08","tournament_id":"1216","tournament_name":"Wimbledon","season_id":"19925","season_title":"2019 Mens Singles","season_name":"Wimbledon","surface":"Grass","gender":"male","type":"Grand Slam","single_double":"Singles","set":[{"num":"1","score_a":"6","score_b":"7","tie_break_score_a":"3","tie_break_score_b":"7","winner":"contestant_b"},{"num":"2","score_a":"6","score_b":"1","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_a"},{"num":"3","score_a":"3","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"4","score_a":"4","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"}]},{"match_id":"35943","round_id":"33370","round_title":"Quarter-finals","date":"2019-07-10","time":"16:45:00","date_utc":"2019-07-10","time_utc":"14:45:00","contestant_a_id":"449824","contestant_a_first_name":"Kei","contestant_a_last_name":"Nishikori","contestant_a_common_name":"Kei Nishikori","contestant_a_match_name":"K. Nishikori","contestant_a_nationality":"JPN","contestant_a_seeding":"9","contestant_a_draw_position":"97","contestant_b_id":"450133","contestant_b_first_name":"Roger","contestant_b_last_name":"Federer","contestant_b_common_name":"Roger Federer","contestant_b_match_name":"R. Federer","contestant_b_nationality":"CHE","contestant_b_seeding":"2","contestant_b_draw_position":"127","winner":"contestant_b","status":"Played","final_period":"ten_p4s","score_a":"1","score_b":"3","last_updated":"2019-07-14 20:21:04","tournament_id":"1216","tournament_name":"Wimbledon","season_id":"19925","season_title":"2019 Mens Singles","season_name":"Wimbledon","surface":"Grass","gender":"male","type":"Grand Slam","single_double":"Singles","set":[{"num":"1","score_a":"6","score_b":"4","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_a"},{"num":"2","score_a":"1","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"3","score_a":"4","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"4","score_a":"4","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"}]},{"match_id":"35939","round_id":"33369","round_title":"Round of 16","date":"2019-07-08","time":"18:55:00","date_utc":"2019-07-08","time_utc":"16:55:00","contestant_a_id":"450230","contestant_a_first_name":"Matteo","contestant_a_last_name":"Berrettini","contestant_a_common_name":"Matteo Berrettini","contestant_a_match_name":"M. Berrettini","contestant_a_nationality":"ITA","contestant_a_seeding":"17","contestant_a_draw_position":"113","contestant_b_id":"450133","contestant_b_first_name":"Roger","contestant_b_last_name":"Federer","contestant_b_common_name":"Roger Federer","contestant_b_match_name":"R. Federer","contestant_b_nationality":"CHE","contestant_b_seeding":"2","contestant_b_draw_position":"127","winner":"contestant_b","status":"Played","final_period":"ten_p3s","score_a":"0","score_b":"3","last_updated":"2019-07-08 20:10:33","tournament_id":"1216","tournament_name":"Wimbledon","season_id":"19925","season_title":"2019 Mens Singles","season_name":"Wimbledon","surface":"Grass","gender":"male","type":"Grand Slam","single_double":"Singles","set":[{"num":"1","score_a":"1","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"2","score_a":"2","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"3","score_a":"2","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"}]},{"match_id":"35931","round_id":"33368","round_title":"Round of 32","date":"2019-07-06","time":"17:45:00","date_utc":"2019-07-06","time_utc":"15:45:00","contestant_a_id":"449831","contestant_a_first_name":"Lucas","contestant_a_last_name":"Pouille","contestant_a_common_name":"Lucas Pouille","contestant_a_match_name":"L. Pouille","contestant_a_nationality":"FRA","contestant_a_seeding":"27","contestant_a_draw_position":"121","contestant_b_id":"450133","contestant_b_first_name":"Roger","contestant_b_last_name":"Federer","contestant_b_common_name":"Roger Federer","contestant_b_match_name":"R. Federer","contestant_b_nationality":"CHE","contestant_b_seeding":"2","contestant_b_draw_position":"127","winner":"contestant_b","status":"Played","final_period":"ten_p3s","score_a":"0","score_b":"3","last_updated":"2019-07-06 19:52:33","tournament_id":"1216","tournament_name":"Wimbledon","season_id":"19925","season_title":"2019 Mens Singles","season_name":"Wimbledon","surface":"Grass","gender":"male","type":"Grand Slam","single_double":"Singles","set":[{"num":"1","score_a":"5","score_b":"7","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"2","score_a":"2","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"3","score_a":"6","score_b":"7","tie_break_score_a":"4","tie_break_score_b":"7","winner":"contestant_b"}]},{"match_id":"35915","round_id":"33358","round_title":"Round of 64","date":"2019-07-04","time":"15:55:00","date_utc":"2019-07-04","time_utc":"13:55:00","contestant_a_id":"453897","contestant_a_first_name":"Jay","contestant_a_last_name":"Clarke","contestant_a_common_name":"Jay Clarke","contestant_a_match_name":"J. Clarke","contestant_a_nationality":"GBR","contestant_a_seeding":"WC","contestant_a_draw_position":"125","contestant_b_id":"450133","contestant_b_first_name":"Roger","contestant_b_last_name":"Federer","contestant_b_common_name":"Roger Federer","contestant_b_match_name":"R. Federer","contestant_b_nationality":"CHE","contestant_b_seeding":"2","contestant_b_draw_position":"127","winner":"contestant_b","status":"Played","final_period":"ten_p3s","score_a":"0","score_b":"3","last_updated":"2019-07-04 17:33:10","tournament_id":"1216","tournament_name":"Wimbledon","season_id":"19925","season_title":"2019 Mens Singles","season_name":"Wimbledon","surface":"Grass","gender":"male","type":"Grand Slam","single_double":"Singles","set":[{"num":"1","score_a":"1","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"},{"num":"2","score_a":"6","score_b":"7","tie_break_score_a":"3","tie_break_score_b":"7","winner":"contestant_b"},{"num":"3","score_a":"2","score_b":"6","tie_break_score_a":"","tie_break_score_b":"","winner":"contestant_b"}]}]},"doubles":[]},"next_matches":{"singles":[],"doubles":[]}}}}