No Subscription to this function
GET /basketball/get_peoples
Returns person informations and list of teams the person were member of.
Request URL
https://dsg-api.com/clients/{client_name}/basketball/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
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
competition
player statistics per competition
appearances
number of appearances (starting 11 + sub in)
assists
average assists made
blocks
average blocks made
blocks_against
average blocks against
competition_id
unique identifier for a competition.
competition_name
name of the competition.
comp_area_id
unique identifier for area.
comp_format
competition format to filter out leagues or cups
def_rebounds
average defensive rebounds made
efficiency
average of efficiency
field_goals_att
average field goal attempts made
field_goals_made
average field goals made
field_goals_perc
average field goals percentage
free_throws_att
average free throws attempts made
free_throws_made
average free throws made
free_throws_perc
average free throws percentage
off_rebounds
average offensive rebounds made
performance_index_rating
average of performance index rating
personal_fouls
average personal fouls made
personal_fouls_rec
average personal fouls received
plus_minus
average of plus minus
points
average points made
rebounds
average total rebounds made
starting_bench
number of appearances started from the bench
starting_five
number of starting five appearances
steals
average steals made
three_points_att
average three points attempts made
three_points_made
average three points made
three_points_perc
average three points percentage
time_played
average time played
turnovers
average turnovers made
two_points_att
average two points attempts made
two_points_made
average two points made
two_points_perc
average two points percentage
main_club_career
player statistics in all club competitions
appearances
number of appearances (starting 11 + sub in)
assists
average assists made
blocks
average blocks made
blocks_against
average blocks against
def_rebounds
average defensive rebounds made
field_goals_att
average field goal attempts made
field_goals_made
average field goals made
field_goals_perc
average field goals percentage
off_rebounds
average offensive rebounds made
personal_fouls
average personal fouls made
personal_fouls_rec
average personal fouls received
points
average points made
rebounds
average total rebounds made
starting_bench
number of appearances started from the bench
starting_five
number of starting five appearances
steals
average steals made
time_played
average time played
turnovers
average turnovers made
two_points_att
average two points attempts made
two_points_made
average two points made
two_points_perc
average two points percentage
main_national_team_career
player statistics in all national team competitions
appearances
number of appearances (starting 11 + sub in)
assists
average assists made
blocks
average blocks made
blocks_against
average blocks against
def_rebounds
average defensive rebounds made
field_goals_att
average field goal attempts made
field_goals_made
average field goals made
field_goals_perc
average field goals percentage
off_rebounds
average offensive rebounds made
personal_fouls
average personal fouls made
personal_fouls_rec
average personal fouls received
points
average points made
rebounds
average total rebounds made
starting_bench
number of appearances started from the bench
starting_five
number of starting five appearances
steals
average steals made
time_played
average time played
turnovers
average turnovers made
two_points_att
average two points attempts made
two_points_made
average two points made
two_points_perc
average two points percentage
membership
Membership handles the relation from a person to a team
active
Determines if person is still at the team ('yes') or not ('no').
end_date
End date of membership, format 'yyyy-mm-dd'.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS. CET timezone.
membership_id
Unique identifier for the membership
role
type of role ('player', 'coach' or 'assistant_coach', 'goalkeeper_coach', 'local_coach', 'scout', 'sporting director')
short_name
short name of the team.
start_date
Start date of membership, format 'yyyy-mm-dd'.
team_area
area name where team is located
team_area_id
unique identifier for an area
team_id
Unique identifier for team
team_name
current team name
type
type of the team ('club', 'national' or 'selection')
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')
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
position
position of the player
weight
Weight of person in kilograms.
season_statistic
player statistics per season
appearances
number of appearances (starting 11 + sub in)
assists
average assists made
blocks
average blocks made
blocks_against
average blocks against
competition_name
name of the competition.
comp_area_id
unique identifier for area.
comp_format
competition format to filter out leagues or cups
def_rebounds
average defensive rebounds made
efficiency
average of efficiency
field_goals_att
average field goal attempts made
field_goals_made
average field goals made
field_goals_perc
average field goals percentage
free_throws_att
average free throws attempts made
free_throws_made
average free throws made
free_throws_perc
average free throws percentage
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
off_rebounds
average offensive rebounds made
original_name
competition name during this season
performance_index_rating
average of performance index rating
personal_fouls
average personal fouls made
personal_fouls_rec
average personal fouls received
plus_minus
average of plus minus
points
average points made
rebounds
average total rebounds made
season_id
unique identifier for season
shirtnumber
shirtnumber for the particular season
starting_bench
number of appearances started from the bench
starting_five
number of starting five appearances
steals
average steals made
three_points_att
average three points attempts made
three_points_made
average three points made
three_points_perc
average three points percentage
time_played
average time played
title
title of season
turnovers
average turnovers made
two_points_att
average two points attempts made
two_points_made
average two points made
two_points_perc
average two points percentage
youth_club_career
player statistics in all youth club competitions
appearances
number of appearances (starting 11 + sub in)
assists
average assists made
blocks
average blocks made
blocks_against
average blocks against
def_rebounds
average defensive rebounds made
field_goals_att
average field goal attempts made
field_goals_made
average field goals made
field_goals_perc
average field goals percentage
off_rebounds
average offensive rebounds made
personal_fouls
average personal fouls made
personal_fouls_rec
average personal fouls received
points
average points made
rebounds
average total rebounds made
starting_bench
number of appearances started from the bench
starting_five
number of starting five appearances
steals
average steals made
time_played
average time played
turnovers
average turnovers made
two_points_att
average two points attempts made
two_points_made
average two points made
two_points_perc
average two points percentage
youth_national_team_career
player statistics in all youth national team competitions
appearances
number of appearances (starting 11 + sub in)
assists
average assists made
blocks
average blocks made
blocks_against
average blocks against
def_rebounds
average defensive rebounds made
field_goals_att
average field goal attempts made
field_goals_made
average field goals made
field_goals_perc
average field goals percentage
off_rebounds
average offensive rebounds made
personal_fouls
average personal fouls made
personal_fouls_rec
average personal fouls received
points
average points made
rebounds
average total rebounds made
starting_bench
number of appearances started from the bench
starting_five
number of starting five appearances
steals
average steals made
time_played
average time played
turnovers
average turnovers made
two_points_att
average two points attempts made
two_points_made
average two points made
two_points_perc
average two points percentage
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}/basketball/get_peoples?id={people_id}&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}/basketball/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/basketball/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"basketball","lang":"en","method":{"method_id":"47","name":"get_peoples"},"people":{"people_id":"354139","first_name":"Marcus","last_name":"Smart","match_name":"M. Smart","common_name":"Marcus Smart","date_of_birth":"1994-03-06","place_of_birth":"Flower Mound, TX","country_of_birth":"United States","nationality":"United States","gender":"male","height":"193","weight":"100","position":"Point Guard","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/354139.png","career_summary":{"main_club_career":{"appearances":"248","starting_five":"102","starting_bench":"187","time_played":"29:09","points":"9.7","assists":"4.5","rebounds":"3.5","off_rebounds":"0.9","def_rebounds":"2.6","steals":"1.6","turnovers":"2","blocks":"0.4","blocks_against":"0","personal_fouls":"2.5","personalfoulsrec":"0","field_goals_att":"8.5","field_goals_made":"3.2","field_goals_perc":"37.5","two_points_att":"4.2","two_points_made":"1.8","two_points_perc":"43.6","three_points_att":"4.3","three_points_made":"1.4","three_points_perc":"31.5","free_throws_att":"2.5","free_throws_made":"1.9","free_throws_perc":"77.1","plus_minus":"2","performance_index_rating":"0","efficiency":"0","competition":{"competition_id":"933","competition_name":"NBA","comp_area_id":"203","comp_format":"domestic_league","appearances":"248","starting_five":"102","starting_bench":"187","time_played":"29:09","points":"9.7","assists":"4.5","rebounds":"3.5","off_rebounds":"0.9","def_rebounds":"2.6","steals":"1.6","turnovers":"2","blocks":"0.4","blocks_against":"0","personal_fouls":"2.5","personal_fouls_rec":"0","field_goals_att":"8.5","field_goals_made":"3.2","field_goals_perc":"37.5","two_points_att":"4.2","two_points_made":"1.8","two_points_perc":"43.6","three_points_att":"4.3","three_points_made":"1.4","three_points_perc":"31.5","free_throws_att":"2.5","free_throws_made":"1.9","free_throws_perc":"77.1","plus_minus":"2","performance_index_rating":"0","efficiency":"0"}},"youth_club_career":[],"main_national_team_career":[],"youth_national_team_career":[]},"membership":{"membership_id":"387749","team_id":"25473","team_name":"Boston Celtics","team_area":"United States","type":"club","start_date":"2014-06-26","end_date":"","role":"player","active":"yes","last_updated":"2016-05-27 17:20:15","season_statistic":[{"season_id":"17932","title":"2018\/2019","competition_name":"NBA","original_name":"NBA","comp_area_id":"203","comp_format":"domestic_league","appearances":"82","starting_five":"60","starting_bench":"31","time_played":"27:13","points":"8.7","assists":"4","rebounds":"2.9","off_rebounds":"0.7","def_rebounds":"2.2","steals":"1.8","turnovers":"1.5","blocks":"0.3","blocks_against":"0","personal_fouls":"2.5","personal_fouls_rec":"0","field_goals_att":"7","field_goals_made":"2.9","field_goals_perc":"41.5","two_points_att":"2.7","two_points_made":"1.4","two_points_perc":"51.1","three_points_att":"4.4","three_points_made":"1.5","three_points_perc":"35.6","free_throws_att":"1.6","free_throws_made":"1.3","free_throws_perc":"80","plus_minus":"1.8","performance_index_rating":"0","efficiency":"0","last_updated":"2019-05-09 05:05:27"},{"season_id":"13544","title":"2017\/2018","competition_name":"NBA","original_name":"NBA","comp_area_id":"203","comp_format":"domestic_league","appearances":"69","starting_five":"15","starting_bench":"86","time_played":"29:53","points":"10.1","assists":"4.9","rebounds":"3.6","off_rebounds":"0.8","def_rebounds":"2.7","steals":"1.4","turnovers":"2.4","blocks":"0.5","blocks_against":"0","personal_fouls":"2.6","personal_fouls_rec":"0","field_goals_att":"9.5","field_goals_made":"3.4","field_goals_perc":"36","two_points_att":"4.9","two_points_made":"2.1","two_points_perc":"43.1","three_points_att":"4.6","three_points_made":"1.3","three_points_perc":"28.4","free_throws_att":"2.6","free_throws_made":"1.9","free_throws_perc":"73.1","plus_minus":"3.3","performance_index_rating":"0","efficiency":"0","last_updated":"2018-05-29 03:05:24"},{"season_id":"12246","title":"2016\/2017","competition_name":"NBA","original_name":"NBA","comp_area_id":"203","comp_format":"domestic_league","appearances":"97","starting_five":"27","starting_bench":"70","time_played":"30:16","points":"10.2","assists":"4.6","rebounds":"4","off_rebounds":"1","def_rebounds":"3","steals":"1.5","turnovers":"2","blocks":"0.5","blocks_against":"0","personal_fouls":"2.5","personal_fouls_rec":"0","field_goals_att":"9.1","field_goals_made":"3.3","field_goals_perc":"35.9","two_points_att":"4.9","two_points_made":"2","two_points_perc":"40.5","three_points_att":"4.2","three_points_made":"1.3","three_points_perc":"30.4","free_throws_att":"3.1","free_throws_made":"2.4","free_throws_perc":"78.3","plus_minus":"1.2","performance_index_rating":"0","efficiency":"0","last_updated":"2018-04-30 12:05:24"}]},"career_stats":{"format":{"total_career":{"appearances":"248","starting_five":"102","starting_bench":"187","time_played":"30:16","points":"9.7","assists":"4.5","rebounds":"3.5","off_rebounds":"0.9","def_rebounds":"2.6","steals":"1.6","turnovers":"2","blocks":"0.4","blocks_against":"0","personal_fouls":"2.5","personal_fouls_rec":"0","field_goals_att":"8.5","field_goals_made":"3.2","field_goals_perc":"37.5","two_points_att":"4.2","two_points_made":"1.8","two_points_perc":"43.6","three_points_att":"4.3","three_points_made":"1.4","three_points_perc":"31.5","free_throws_att":"2.5","free_throws_made":"1.9","free_throws_perc":"77.1","plus_minus":"2","performance_index_rating":"0","efficiency":"0"},"club":{"appearances":"248","starting_five":"102","starting_bench":"187","time_played":"30:16","points":"9.7","assists":"4.5","rebounds":"3.5","off_rebounds":"0.9","def_rebounds":"2.6","steals":"1.6","turnovers":"2","blocks":"0.4","blocks_against":"0","personal_fouls":"2.5","personal_fouls_rec":"0","field_goals_att":"8.5","field_goals_made":"3.2","field_goals_perc":"37.5","two_points_att":"4.2","two_points_made":"1.8","two_points_perc":"43.6","three_points_att":"4.3","three_points_made":"1.4","three_points_perc":"31.5","free_throws_att":"2.5","free_throws_made":"1.9","free_throws_perc":"77.1","plus_minus":"2","performance_index_rating":"0","efficiency":"0"}},"competitions":{"competiton":{"competition_id":"933","competition_title":"NBA","appearances":"248","starting_five":"102","starting_bench":"187","time_played":"30:16","points":"9.7","assists":"4.5","rebounds":"3.5","off_rebounds":"0.9","def_rebounds":"2.6","steals":"1.6","turnovers":"2","blocks":"0.4","blocks_against":"0","personal_fouls":"2.5","personal_fouls_rec":"0","field_goals_att":"8.5","field_goals_made":"3.2","field_goals_perc":"37.5","two_points_att":"4.2","two_points_made":"1.8","two_points_perc":"43.6","three_points_att":"4.3","three_points_made":"1.4","three_points_perc":"31.5","free_throws_att":"2.5","free_throws_made":"1.9","free_throws_perc":"77.1","plus_minus":"2","performance_index_rating":"0","efficiency":"0"}},"teams":{"team":{"team_id":"25473","team_name":"Boston Celtics","appearances":"248","starting_five":"102","starting_bench":"187","time_played":"30:16","points":"9.7","assists":"4.5","rebounds":"3.5","off_rebounds":"0.9","def_rebounds":"2.6","steals":"1.6","turnovers":"2","blocks":"0.4","blocks_against":"0","personal_fouls":"2.5","personal_fouls_rec":"0","field_goals_att":"8.5","field_goals_made":"3.2","field_goals_perc":"37.5","two_points_att":"4.2","two_points_made":"1.8","two_points_perc":"43.6","three_points_att":"4.3","three_points_made":"1.4","three_points_perc":"31.5","free_throws_att":"2.5","free_throws_made":"1.9","free_throws_perc":"77.1","plus_minus":"2","performance_index_rating":"0","efficiency":"0"}}},"last_matches":{"match":[{"match_id":"1626020","date":"2019-04-21","time":"19:00:00","date_utc":"2019-04-21","time_utc":"17:00:00","team_a_id":"25495","team_a_name":"Indiana Pacers","team_a_short_name":"Pacers","team_a_tla_name":"IND","team_a_original_name":"Indiana Pacers","team_a_country":"USA","team_b_id":"25473","team_b_name":"Boston Celtics","team_b_short_name":"Celtics","team_b_tla_name":"BOS","team_b_original_name":"Boston Celtics","team_b_country":"USA","status":"Played","gameweek":"","winner":"team_B","score_a":"106","score_b":"110","p1s_a":"23","p1s_b":"21","p2s_a":"26","p2s_b":"26","p3s_a":"23","p3s_b":"26","p4s_a":"34","p4s_b":"37","et1_a":"","et1_b":"","et2_a":"","et2_b":"","et3_a":"","et3_b":"","venue_type":"home_away","final_period":"bkb_p4s","attendance":"17923","venue_id":"5064","venue_name":"Bankers Life Fieldhouse","venue_city":"Indianapolis, IN","competition_id":"933","competition_name":"NBA","season_id":"17932","round_id":"23601","last_updated":"2019-08-05 12:10:26"},{"match_id":"1629097","date":"2019-04-28","time":"19:00:00","date_utc":"2019-04-28","time_utc":"17:00:00","team_a_id":"25496","team_a_name":"Milwaukee Bucks","team_a_short_name":"Bucks","team_a_tla_name":"MIL","team_a_original_name":"Milwaukee Bucks","team_a_country":"USA","team_b_id":"25473","team_b_name":"Boston Celtics","team_b_short_name":"Celtics","team_b_tla_name":"BOS","team_b_original_name":"Boston Celtics","team_b_country":"USA","status":"Played","gameweek":"","winner":"team_B","score_a":"90","score_b":"112","p1s_a":"17","p1s_b":"26","p2s_a":"33","p2s_b":"26","p3s_a":"21","p3s_b":"36","p4s_a":"19","p4s_b":"24","et1_a":"","et1_b":"","et2_a":"","et2_b":"","et3_a":"","et3_b":"","venue_type":"home_away","final_period":"bkb_p4s","attendance":"17561","venue_id":"12911","venue_name":"Fiserv Forum","venue_city":"Milwaukee, WI","competition_id":"933","competition_name":"NBA","season_id":"17932","round_id":"23603","last_updated":"2019-08-05 12:10:26"},{"match_id":"1629099","date":"2019-05-01","time":"02:00:00","date_utc":"2019-05-01","time_utc":"00:00:00","team_a_id":"25496","team_a_name":"Milwaukee Bucks","team_a_short_name":"Bucks","team_a_tla_name":"MIL","team_a_original_name":"Milwaukee Bucks","team_a_country":"USA","team_b_id":"25473","team_b_name":"Boston Celtics","team_b_short_name":"Celtics","team_b_tla_name":"BOS","team_b_original_name":"Boston Celtics","team_b_country":"USA","status":"Played","gameweek":"","winner":"team_A","score_a":"123","score_b":"102","p1s_a":"25","p1s_b":"30","p2s_a":"34","p2s_b":"25","p3s_a":"39","p3s_b":"18","p4s_a":"25","p4s_b":"29","et1_a":"","et1_b":"","et2_a":"","et2_b":"","et3_a":"","et3_b":"","venue_type":"home_away","final_period":"bkb_p4s","attendance":"17536","venue_id":"12911","venue_name":"Fiserv Forum","venue_city":"Milwaukee, WI","competition_id":"933","competition_name":"NBA","season_id":"17932","round_id":"23603","last_updated":"2019-08-05 12:10:26"},{"match_id":"1629101","date":"2019-05-04","time":"02:00:00","date_utc":"2019-05-04","time_utc":"00:00:00","team_a_id":"25473","team_a_name":"Boston Celtics","team_a_short_name":"Celtics","team_a_tla_name":"BOS","team_a_original_name":"Boston Celtics","team_a_country":"USA","team_b_id":"25496","team_b_name":"Milwaukee Bucks","team_b_short_name":"Bucks","team_b_tla_name":"MIL","team_b_original_name":"Milwaukee Bucks","team_b_country":"USA","status":"Played","gameweek":"","winner":"team_B","score_a":"116","score_b":"123","p1s_a":"30","p1s_b":"25","p2s_a":"26","p2s_b":"30","p3s_a":"31","p3s_b":"40","p4s_a":"29","p4s_b":"28","et1_a":"","et1_b":"","et2_a":"","et2_b":"","et3_a":"","et3_b":"","venue_type":"home_away","final_period":"bkb_p4s","attendance":"18624","venue_id":"5066","venue_name":"TD Garden","venue_city":"Boston, MA","competition_id":"933","competition_name":"NBA","season_id":"17932","round_id":"23603","last_updated":"2019-08-05 12:10:26"},{"match_id":"1629103","date":"2019-05-07","time":"01:00:00","date_utc":"2019-05-06","time_utc":"23:00:00","team_a_id":"25473","team_a_name":"Boston Celtics","team_a_short_name":"Celtics","team_a_tla_name":"BOS","team_a_original_name":"Boston Celtics","team_a_country":"USA","team_b_id":"25496","team_b_name":"Milwaukee Bucks","team_b_short_name":"Bucks","team_b_tla_name":"MIL","team_b_original_name":"Milwaukee Bucks","team_b_country":"USA","status":"Played","gameweek":"","winner":"team_B","score_a":"101","score_b":"113","p1s_a":"30","p1s_b":"22","p2s_a":"19","p2s_b":"25","p3s_a":"23","p3s_b":"33","p4s_a":"29","p4s_b":"33","et1_a":"","et1_b":"","et2_a":"","et2_b":"","et3_a":"","et3_b":"","venue_type":"home_away","final_period":"bkb_p4s","attendance":"18624","venue_id":"5066","venue_name":"TD Garden","venue_city":"Boston, MA","competition_id":"933","competition_name":"NBA","season_id":"17932","round_id":"23603","last_updated":"2019-08-05 12:10:26"},{"match_id":"1629105","date":"2019-05-09","time":"02:00:00","date_utc":"2019-05-09","time_utc":"00:00:00","team_a_id":"25496","team_a_name":"Milwaukee Bucks","team_a_short_name":"Bucks","team_a_tla_name":"MIL","team_a_original_name":"Milwaukee Bucks","team_a_country":"USA","team_b_id":"25473","team_b_name":"Boston Celtics","team_b_short_name":"Celtics","team_b_tla_name":"BOS","team_b_original_name":"Boston Celtics","team_b_country":"USA","status":"Played","gameweek":"","winner":"team_A","score_a":"116","score_b":"91","p1s_a":"22","p1s_b":"19","p2s_a":"30","p2s_b":"20","p3s_a":"28","p3s_b":"23","p4s_a":"36","p4s_b":"29","et1_a":"","et1_b":"","et2_a":"","et2_b":"","et3_a":"","et3_b":"","venue_type":"home_away","final_period":"bkb_p4s","attendance":"17701","venue_id":"12911","venue_name":"Fiserv Forum","venue_city":"Milwaukee, WI","competition_id":"933","competition_name":"NBA","season_id":"17932","round_id":"23603","last_updated":"2019-08-05 12:10:26"}]}}}}