No Subscription to this function
GET /soccer/get_squad
Returns a list of players linked to a team.
Request URL
https://dsg-api.com/clients/{client_name}/soccer/soccer/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
detailed
string Required
only 'yes' is valid, enables more details
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
picsize
string
one of 150x150, 50x50, 30x30 or 18x18 to get correct size of player picture.
season
string
season_id to get player statistics for the particular season
team
int Required
team id to return
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
sport
sport of the API
version
version of the API
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
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
height
Height of person in centimeters
last_name
last name of the person
match_name
shortened match name of the person
membership_id
Unique identifier for the membership
nationality
current nationality of the person
nationality_area_id
unique identifier for an area
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_player_statistic
detailed player statistics per season
aerials_lost
number of lost aerials
aerials_won
number of won aerials
att_freekick_goal
number of freekick goals
ball_recovery
number of ball recoveries
big_chance_created
number of big chances created
blocked_cross
number of blocked crosses
blocked_scoring_att
number of blocked shots
corners
number of corners
crosses
number of crosses
duel_lost
number of lost duels
duel_won
number of duels won
error_lead_to_goal
number of errors which lead to a goal
error_lead_to_shot
number of errors who lead to a shot
fouled
number of fouls received
fouls
number of fouls made
hit_woodwork
number of times a shot hit the woodwork
interceptions
number of interceptions made
key_passes
number of key passes
last_man_tackle
number of last man tackles
long_balls
number of long balls
offsides
number of offsides made
original_name
competition name during this season
passes
number of passes attempted
passes_completed
number of passes completed
penalty_conceded
number of penalties conceded
penalty_won
number of penaltys drawn
poss_lost_all
number of times possession was lost
saves
number of goalkeeper saves
season_id
unique identifier for season
second_goal_assist
number of second goal assists
shots_on_target
number of shots on target
shots_total
number of total shots
tackles
number of tackles attempted
tackles_won
number of tackles won
title
title of season
total_clearance
number of total clearances
total_final_third_passes
number of final third passes
touches
number of touches
touches_in_opp_box
number of touches in the opposite box
won_contest
number of contests won
won_corners
number of corners won
season_player_statistic_avg
detailed player statistics per season (average per appearance)
aerials_lost
average of lost aerials
aerials_won
average of won aerials
att_freekick_goal
average of freekick goals
ball_recovery
average of ball recoveries
big_chance_created
average of big chances created
blocked_cross
average of blocked crosses
blocked_scoring_att
average of blocked shots
corners
average of corners
crosses
average of crosses
duel_lost
average of lost duels
duel_won
average of duels won
error_lead_to_goal
average of errors which lead to a goal
error_lead_to_shot
average of errors who lead to a shot
fouled
average of fouls received
fouls
average of fouls made
hit_woodwork
average of times a shot hit the woodwork
interceptions
average of interceptions made
key_passes
average of key passes
last_man_tackle
average of last man tackles
long_balls
average of long balls
offsides
average of offsides made
original_name
competition name during this season
passes
average of passes attempted
passes_completed
average of passes completed
penalty_conceded
average of penalties conceded
penalty_won
average of penaltys drawn
poss_lost_all
average of times possession was lost
saves
average of goalkeeper saves
season_id
unique identifier for season
second_goal_assist
average of second goal assists
shots_on_target
average of shots on target
shots_total
average of total shots
tackles
average of tackles attempted
tackles_won
average of tackles won
title
title of season
total_clearance
average of total clearances
total_final_third_passes
average of final third passes
touches
average of touches
touches_in_opp_box
average of touches in the opposite box
won_contest
average of contests won
won_corners
average of corners won
season_statistic
player statistics per season
appearances
number of appearances (starting 11 + sub in)
assists
number of assists
clean_sheets
number of clean_sheets
goals
number of goals made
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
minutes_played
number of played minutes
original_name
competition name during this season
red_cards
number of red cards
saves
number of saves
season_id
unique identifier for season
start_date
Start date of season, format 'yyyy-mm-dd'.
substitutes_in
number of substitutes in
substitutes_out
number of substitutes out
subs_on_bench
number of subs on bench
title
title of season
yellow_cards
number of yellow cards
yellow_red_cards
number of yellow-red cards
staff
Basic details about the staff
common_name
common name of the person
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
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
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
role
type of role ('player', 'coach' or 'assistant_coach', 'goalkeeper_coach', 'local_coach', 'scout', 'sporting director')
team
Basic details about a team
area_id
Unique identifier for area.
area_name
name of area the team is located
gender
gender of the team ('male', 'male youth', 'female' or 'female youth')
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
short_name
short name of the team.
status
The current status of the team ('active' or 'defunct')
team_id
unique team ID for the team.
team_name
current name of the team.
tla_name
three letter acronym for this team
type
Determines the type of team ('national' or 'club')
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}/soccer/soccer/get_squad?team={team_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}/soccer/soccer/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/soccer/soccer/get_squad?team={team_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"soccer","lang":"en","method":{"method_id":"11","name":"get_squad"},"team":{"team_id":"459","team_name":"Wolverhampton Wanderers FC","short_name":"Wolverhampton","tla_name":"WOL","type":"club","gender":"male","status":"active","area_id":"68","area_name":"England","last_updated":"2019-03-30 14:43:57","people":[{"people_id":"776","membership_id":"1294003","first_name":"John","last_name":"Ruddy","match_name":"J. Ruddy","common_name":"John Ruddy","date_of_birth":"1986-10-24","place_of_birth":"Cambridgeshire","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Goalkeeper"},{"people_id":"11370","membership_id":"2712370","first_name":"Rui Pedro","last_name":"dos Santos Patrício","match_name":"Rui Patrício","common_name":"Rui Patrício","date_of_birth":"1988-02-15","place_of_birth":"Marrazes","country_of_birth":"Portugal","nationality":"Portugal","country_of_birth_area_id":"156","nationality_area_id":"156","position":"Goalkeeper"},{"people_id":"218295","membership_id":"3192759","first_name":"Andreas","last_name":"Søndergaard","match_name":"Andreas Søndergaard","common_name":"Andreas Søndergaard","date_of_birth":"2001-01-17","place_of_birth":"","country_of_birth":"Denmark","nationality":"Denmark","country_of_birth_area_id":"61","nationality_area_id":"61","position":"Goalkeeper"},{"people_id":"36243","membership_id":"40537","first_name":"Matthew","last_name":"Doherty","match_name":"M. Doherty","common_name":"Matt Doherty","date_of_birth":"1992-01-16","place_of_birth":"Dublin","country_of_birth":"Republic of Ireland","nationality":"Republic of Ireland","country_of_birth_area_id":"98","nationality_area_id":"98","position":"Defender"},{"people_id":"4418","membership_id":"175166","first_name":"Conor","last_name":"Coady","match_name":"C. Coady","common_name":"Conor Coady","date_of_birth":"1993-02-25","place_of_birth":"Liverpool","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Defender"},{"people_id":"26844","membership_id":"683089","first_name":"Romain Ghanem Paul","last_name":"Saïss","match_name":"R. Saïss","common_name":"Romain Saïss","date_of_birth":"1990-03-26","place_of_birth":"Paris","country_of_birth":"France","nationality":"Morocco","country_of_birth_area_id":"76","nationality_area_id":"133","position":"Defender"},{"people_id":"2722","membership_id":"1278646","first_name":"Ryan","last_name":"Bennett","match_name":"R. Bennett","common_name":"Ryan Bennett","date_of_birth":"1990-03-06","place_of_birth":"Orsett","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Defender"},{"people_id":"113126","membership_id":"1301993","first_name":"Ruben","last_name":"Vinagre","match_name":"R. Vinagre","common_name":"Ruben Vinagre","date_of_birth":"1999-04-09","place_of_birth":"Almada","country_of_birth":"Portugal","nationality":"Portugal","country_of_birth_area_id":"156","nationality_area_id":"156","position":"Defender"},{"people_id":"49099","membership_id":"2713328","first_name":"Dominic","last_name":"Iorfa","match_name":"D. Iorfa","common_name":"Dominic Iorfa","date_of_birth":"1995-06-24","place_of_birth":"Southend-on-Sea","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Defender"},{"people_id":"17025","membership_id":"2726978","first_name":"Jonathan","last_name":"Castro Otto","match_name":"Jonny Castro","common_name":"Jonny Castro","date_of_birth":"1994-03-03","place_of_birth":"Vigo","country_of_birth":"Spain","nationality":"Spain","country_of_birth_area_id":"176","nationality_area_id":"176","position":"Defender"},{"people_id":"26745","membership_id":"2731162","first_name":"Willy","last_name":"Boly","match_name":"W. Boly","common_name":"Willy Boly","date_of_birth":"1991-02-03","place_of_birth":"Melun","country_of_birth":"France","nationality":"France","country_of_birth_area_id":"76","nationality_area_id":"76","position":"Defender"},{"people_id":"196996","membership_id":"2985885","first_name":"Max","last_name":"Kilman","match_name":"M. Kilman","common_name":"Max Kilman","date_of_birth":"1997-05-23","place_of_birth":"London","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Defender"},{"people_id":"25935","membership_id":"3165647","first_name":"Philemon","last_name":"Ofosu-Ayeh","match_name":"P. Ofosu-Ayeh","common_name":"Phil Ofosu-Ayeh","date_of_birth":"1991-09-15","place_of_birth":"Moers","country_of_birth":"Germany","nationality":"Ghana","country_of_birth_area_id":"80","nationality_area_id":"81","position":"Defender"},{"people_id":"77111","membership_id":"3165817","first_name":"Sylvain","last_name":"Deslandes","match_name":"S. Deslandes","common_name":"Sylvain Deslandes","date_of_birth":"1997-04-25","place_of_birth":"Yaoundé","country_of_birth":"Cameroon","nationality":"France","country_of_birth_area_id":"42","nationality_area_id":"76","position":"Defender"},{"people_id":"33270","membership_id":"3166234","first_name":"Roderick Jefferson","last_name":"Gonçalves Miranda","match_name":"Roderick Miranda","common_name":"Roderick Miranda","date_of_birth":"1991-03-30","place_of_birth":"Odivelas","country_of_birth":"Portugal","nationality":"Portugal","country_of_birth_area_id":"156","nationality_area_id":"156","position":"Defender"},{"people_id":"249319","membership_id":"3194250","first_name":"Dion","last_name":"Sanderson","match_name":"D. Sanderson","common_name":"Dion Sanderson","date_of_birth":"1999-12-15","place_of_birth":"","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Defender"},{"people_id":"4588","membership_id":"3195035","first_name":"Jesús","last_name":"Vallejo Lázaro","match_name":"Jesús Vallejo","common_name":"Jesús Vallejo","date_of_birth":"1997-01-05","place_of_birth":"Zaragoza","country_of_birth":"Spain","nationality":"Spain","country_of_birth_area_id":"176","nationality_area_id":"176","position":"Defender"},{"people_id":"151926","membership_id":"1077595","first_name":"Morgan","last_name":"Gibbs-White","match_name":"M. Gibbs-White","common_name":"Morgan Gibbs-White","date_of_birth":"2000-01-27","place_of_birth":"Stafford","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Midfielder"},{"people_id":"38382","membership_id":"1292880","first_name":"Rúben Diogo","last_name":"Da Silva Neves","match_name":"Rúben Neves","common_name":"Rúben Neves","date_of_birth":"1997-03-13","place_of_birth":"Santa Maria da Feira","country_of_birth":"Portugal","nationality":"Portugal","country_of_birth_area_id":"156","nationality_area_id":"156","position":"Midfielder"},{"people_id":"45289","membership_id":"1304406","first_name":"Diogo","last_name":"Jota","match_name":"Diogo Jota","common_name":"Diogo Jota","date_of_birth":"1996-12-04","place_of_birth":"Massarelos","country_of_birth":"Portugal","nationality":"Portugal","country_of_birth_area_id":"156","nationality_area_id":"156","position":"Midfielder"},{"people_id":"11374","membership_id":"2726311","first_name":"João Filipe","last_name":"Iria Santos Moutinho","match_name":"João Moutinho","common_name":"João Moutinho","date_of_birth":"1986-09-08","place_of_birth":"Portimão","country_of_birth":"Portugal","nationality":"Portugal","country_of_birth_area_id":"156","nationality_area_id":"156","position":"Midfielder"},{"people_id":"22963","membership_id":"2738450","first_name":"Leander","last_name":"Dendoncker","match_name":"L. Dendoncker","common_name":"Leander Dendoncker","date_of_birth":"1995-04-15","place_of_birth":"Passendale","country_of_birth":"Belgium","nationality":"Belgium","country_of_birth_area_id":"27","nationality_area_id":"27","position":"Midfielder"},{"people_id":"144511","membership_id":"2752750","first_name":"Elliot","last_name":"Watt","match_name":"E. Watt","common_name":"Elliot Watt","date_of_birth":"2000-03-11","place_of_birth":"Preston","country_of_birth":"England","nationality":"Scotland","country_of_birth_area_id":"68","nationality_area_id":"165","position":"Midfielder"},{"people_id":"122167","membership_id":"3165892","first_name":"Ben","last_name":"Stevenson","match_name":"B. Stevenson","common_name":"Ben Stevenson","date_of_birth":"1997-03-23","place_of_birth":"Coventry","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Midfielder"},{"people_id":"25055","membership_id":"3166240","first_name":"Ming-yang","last_name":"Yang","match_name":"M. Yang","common_name":"Ming-yang Yang","date_of_birth":"1995-07-11","place_of_birth":"Basel","country_of_birth":"Switzerland","nationality":"Switzerland","country_of_birth_area_id":"185","nationality_area_id":"185","position":"Midfielder"},{"people_id":"218273","membership_id":"3192760","first_name":"Terry","last_name":"Taylor","match_name":"T. Taylor","common_name":"Terry Taylor","date_of_birth":"2001-06-29","place_of_birth":"","country_of_birth":"Scotland","nationality":"Scotland","country_of_birth_area_id":"165","nationality_area_id":"165","position":"Midfielder"},{"people_id":"330695","membership_id":"3192761","first_name":"Nathaniel Shio Hong","last_name":"Wan","match_name":"N. Wan","common_name":"Nathaniel Wan","date_of_birth":"2000-08-17","place_of_birth":"","country_of_birth":"England","nationality":"England","country_of_birth_area_id":"68","nationality_area_id":"68","position":"Midfielder"},{"people_id":"11796","membership_id":"2712773","first_name":"Raúl Alonso","last_name":"Jiménez Rodríguez","match_name":"R. Jiménez","common_name":"Raúl Jiménez","date_of_birth":"1991-05-05","place_of_birth":"Tepeji del Río Ocampo","country_of_birth":"Mexico","nationality":"Mexico","country_of_birth_area_id":"129","nationality_area_id":"129","position":"Attacker"},{"people_id":"5653","membership_id":"2738136","first_name":"Adama","last_name":"Traoré Diarra","match_name":"Adama Traoré","common_name":"Adama Traoré","date_of_birth":"1996-01-25","place_of_birth":"L'Hospitalet de Llobregat ","country_of_birth":"Spain","nationality":"Spain","country_of_birth_area_id":"176","nationality_area_id":"176","position":"Attacker"},{"people_id":"28785","membership_id":"3192758","first_name":"Leonardo","last_name":"Bonatini Lohner Maia","match_name":"Léo Bonatini","common_name":"Léo Bonatini","date_of_birth":"1994-03-28","place_of_birth":"Belo Horizonte, MG","country_of_birth":"Brazil","nationality":"Brazil","country_of_birth_area_id":"35","nationality_area_id":"35","position":"Attacker"},{"people_id":"63334","membership_id":"3198178","first_name":"Patrick","last_name":"Cutrone","match_name":"P. Cutrone","common_name":"Patrick Cutrone","date_of_birth":"1998-01-03","place_of_birth":"Como","country_of_birth":"Italy","nationality":"Italy","country_of_birth_area_id":"100","nationality_area_id":"100","position":"Attacker"}]},"staff":{"people":{"people_id":"2357","membership_id":"1280443","first_name":"Nuno Herlander","last_name":"Simões Espírito Santo","match_name":"Nuno Espírito Santo","common_name":"Nuno Espírito Santo","date_of_birth":"1974-01-25","place_of_birth":"São Tomé","country_of_birth":"São Tomé e Príncipe","nationality":"Portugal","country_of_birth_area_id":"","nationality_area_id":"","role":"coach"}}}}