No Subscription to this function
GET /basketball/get_players_abroad
Returns a list of players playing abroad of their home country
Request URL
https://dsg-api.com/clients/{client_name}/basketball/get_players_abroad?nationality=80&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
birthcountry
int
area_id in order to get players abroad for all born (not necessary nationality)
client
string Required
unique client ID
competition
int
competition_id to filter for a specific competition
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
nationality
int Required
area_id of country you want to get players abroad for
picsize
string
one of 150x150, 50x50, 30x30 or 18x18 to get correct size of player picture.
Nodes
people
Basic information about the person
common_name
common name of the person
competition_area_id
area_id of the competition
competition_area_name
area name of the particular competition
competition_id
unique identifier for a competition.
competition_name
name of the competition.
country_of_birth
name of the country the person was born
country_of_birth_area_id
unique identifier for an area
date_of_birth
birth date of the person
first_name
first name of the person
foot
Best/preferred foot of the player ('both', 'left' or 'right')
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
nationality_area_id
unique identifier for an area
people_id
unique identifier for person
player_picture
full path URL of player headshot, size can be changed via the picsize parameter
position
position of the player
short_name
short name of the team.
start_date
start date, format 'yyyy-mm-dd'.
team_area_id
area_id of the particular team
team_area_name
area name of the particular team
team_id
unique identifier for team of the player
team_name
current team name
weight
Weight of person in kilograms.
players_abroad
basic informations about the selected nationality
area_id
unique identifier for area.
area_name
contains the area name.
country_code
Three character country code
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_players_abroad?nationality=80&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_players_abroad?nationality=80&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/basketball/get_players_abroad?nationality=80&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"basketball","lang":"en","method":{"method_id":"309","name":"get_players_abroad"},"players_abroad":{"area_id":"80","area_name":"Germany","country_code":"DEU","people":[{"people_id":"441961","first_name":"Travis","last_name":"Warech","match_name":"T. Warech","common_name":"Travis Warech","date_of_birth":"1991-07-05","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"193","weight":"90","position":"Small Forward","team_id":"30382","team_name":"Hapoel Be'er Sheva","short_name":"Hap Beer Sheva","team_area_id":"99","team_area_name":"Israel","start_date":"2018-08-01","competition_id":"1076","competition_name":"Ligat Winner Sal","competition_area_id":"99","competition_area_name":"Israel","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/441961.png"},{"people_id":"424291","first_name":"Lucca","last_name":"Staiger","match_name":"L. Staiger","common_name":"Lucca Staiger","date_of_birth":"1988-06-14","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"196","weight":"93","position":"Shooting Guard","team_id":"25789","team_name":"Iberostar Tenerife","short_name":"Tenerife","team_area_id":"176","team_area_name":"Spain","start_date":"2018-08-01","competition_id":"1601","competition_name":"Liga ACB","competition_area_id":"176","competition_area_name":"Spain","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/424291.png"},{"people_id":"354402","first_name":"Tibor","last_name":"Pleiß","match_name":"T. Pleiß","common_name":"Tibor Pleiß","date_of_birth":"1989-11-02","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"216","weight":"119","position":"Center","team_id":"289","team_name":"Anadolu Efes SK","short_name":"Anadolu Efes","team_area_id":"196","team_area_name":"Turkey","start_date":"2018-08-01","competition_id":"1075","competition_name":"Basketbol Süper Ligi","competition_area_id":"196","competition_area_name":"Turkey","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/354402.png"},{"people_id":"442003","first_name":"Mahir","last_name":"Agva","match_name":"M. Agva","common_name":"Mahir Agva","date_of_birth":"1996-06-26","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"206","weight":"108","position":"Center","team_id":"296","team_name":"Darüşşafaka SK","short_name":"Darüşşafaka","team_area_id":"196","team_area_name":"Turkey","start_date":"2019-08-01","competition_id":"1075","competition_name":"Basketbol Süper Ligi","competition_area_id":"196","competition_area_name":"Turkey","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/442003.png"},{"people_id":"441977","first_name":"Ismet","last_name":"Akpinar","match_name":"I. Akpinar","common_name":"Ismet Akpinar","date_of_birth":"1995-05-22","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"190","weight":"77","position":"Point Guard","team_id":"29943","team_name":"Beşiktaş Sompo Japan","short_name":"Beşiktaş","team_area_id":"196","team_area_name":"Turkey","start_date":"2019-08-01","competition_id":"1075","competition_name":"Basketbol Süper Ligi","competition_area_id":"196","competition_area_name":"Turkey","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/441977.png"},{"people_id":"424292","first_name":"Daniel","last_name":"Theis","match_name":"D. Theis","common_name":"Daniel Theis","date_of_birth":"1992-04-04","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"204","weight":"110","position":"Center","team_id":"25473","team_name":"Boston Celtics","short_name":"Celtics","team_area_id":"203","team_area_name":"United States","start_date":"2017-10-17","competition_id":"933","competition_name":"NBA","competition_area_id":"203","competition_area_name":"United States","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/424292.png"},{"people_id":"354763","first_name":"Dennis","last_name":"Schröder","match_name":"D. Schröder","common_name":"Dennis Schröder","date_of_birth":"1993-09-15","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"188","weight":"76","position":"Point Guard","team_id":"25481","team_name":"Oklahoma City Thunder","short_name":"Thunder","team_area_id":"203","team_area_name":"United States","start_date":"2018-07-24","competition_id":"933","competition_name":"NBA","competition_area_id":"203","competition_area_name":"United States","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/354763.png"},{"people_id":"160625","first_name":"Isaiah","last_name":"Hartenstein","match_name":"I. Hartenstein","common_name":"Isaiah Hartenstein","date_of_birth":"1998-05-05","country_of_birth":"United States","nationality":"Germany","gender":"male","height":"209","weight":"104","position":"Power Forward","team_id":"25483","team_name":"Houston Rockets","short_name":"Rockets","team_area_id":"203","team_area_name":"United States","start_date":"2018-07-30","competition_id":"933","competition_name":"NBA","competition_area_id":"203","competition_area_name":"United States","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/160625.png"},{"people_id":"442058","first_name":"Maximilian","last_name":"Kleber","match_name":"M. Kleber","common_name":"Maximilian Kleber","date_of_birth":"1992-01-29","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"207","weight":"98","position":"Power Forward","team_id":"25484","team_name":"Dallas Mavericks","short_name":"Mavericks","team_area_id":"203","team_area_name":"United States","start_date":"2017-07-13","competition_id":"933","competition_name":"NBA","competition_area_id":"203","competition_area_name":"United States","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/442058.png"},{"people_id":"259855","first_name":"Victor Moritz","last_name":"Wagner","match_name":"V. Wagner","common_name":"Moritz Wagner","date_of_birth":"1997-04-26","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"","weight":"109","position":"Power Forward","team_id":"25501","team_name":"Washington Wizards","short_name":"Wizards","team_area_id":"203","team_area_name":"United States","start_date":"2019-07-05","competition_id":"933","competition_name":"NBA","competition_area_id":"203","competition_area_name":"United States","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/259855.png"},{"people_id":"442007","first_name":"Isaac","last_name":"Bonga","match_name":"I. Bonga","common_name":"Isaac Bonga","date_of_birth":"1999-11-08","country_of_birth":"Germany","nationality":"Germany","gender":"male","height":"203","weight":"81","position":"Point Guard","team_id":"25501","team_name":"Washington Wizards","short_name":"Wizards","team_area_id":"203","team_area_name":"United States","start_date":"2019-07-05","competition_id":"933","competition_name":"NBA","competition_area_id":"203","competition_area_name":"United States","player_pic":"https:\/\/www.dsg-images.com\/players\/150x150\/442007.png"}]}}}