No Subscription to this function
GET /basketball/get_team
Returns a list of team details selected from team or season
Request URL
https://dsg-api.com/clients/{client_name}/basketball/get_team?team={team_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)
team
int Required
team id to get details from
Nodes
match
Details about next matches of the particular team
attendance
amount of people that attended the particular match
competition_id
unique identifier for a competition.
competition_name
name of the competition.
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
et1_a
1st extra-time period score of home team.
et1_b
1st extra-time period score of away team.
et2_a
2nd extra-time period score of home team.
et2_b
2nd extra-time period score of away team.
et3_a
3rd extra-time period score of home team.
et3_b
3rd extra-time period score of away team.
et_a
extra-time score of home team
et_b
extra-time score of away team
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
gameweek
contains the gameweek a match belongs to.
match_id
unique identifier of match.
p1s_a
1st period score of home team.
p1s_b
1st period score of away team.
p2s_a
2nd period score of home team
p2s_b
2nd period score of away team
p3s_a
3rd period score of home team.
p3s_b
3rd period score of away team.
p4s_a
4th period score of home team.
p4s_b
4th period score of away team.
round_id
unique identifier of round
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
season_id
unique identifier of season
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
team_a_country
three-letter-acronym of the area where the home team origins.
team_a_id
unique team ID for the home team.
team_a_logo
URL to the team logo
team_a_name
current name of the home team.
team_a_original_name
the real name at the particular season (so can differ to current name)
team_a_short_name
short name of the home team.
team_a_tla_name
three-letter-acronym of the home team.
team_b_country
three-letter-acronym of the area where the home team origins.
team_b_id
unique team ID for the away team.
team_b_logo
URL to the team logo
team_b_name
current name of the away team.
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of the away team.
team_b_tla_name
three-letter-acronym of the away team.
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'.
venue_city
city where the venue is based
venue_id
unique identifier of the venue
venue_name
current name of the venue
venue_type
determines if the match is on neutral ground or on home/away basis
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.
related_team
Details about related teams
order
can be used to order the related teams (ascending)
team_id
unique team ID for the team
team_name
current name of the team.
type
type of relation to the main team (reserve, youth, women, related)
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')
team_extra
Extra details about a team
adress
Name of street and street number
adress_city
Name of the city
adress_zip
ZIP code
club_colors
Original colors of club (seperated with / )
email
Official e-mail address.
fax
Fax number
founded
Year club was founded. Format 'yyyy'
nicknames
nickname of the club. Can contain until 3 different ones seperated with a "/"
official_name
The official name of a team
primary_venue_id
venue_id of the home venue or primary used one for the particular team
primary_venue_name
venue name of the home venue or primary used one for the particular team
team_logo
full path URL of team logo
tel
Telephone number
website
Official website address (URL).
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_team?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}/basketball/get_team?team={team_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/basketball/get_team?team={team_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":"132","name":"get_team"},"team":{"team_id":"25473","team_name":"Boston Celtics","short_name":"Celtics","tla_name":"BOS","type":"club","gender":"male","status":"active","area_id":"203","area_name":"United States","last_updated":"2016-10-07 21:38:02","team_extra":{"adress":"","adress_zip":"","adress_city":"Boston, MA","tel":"","fax":"","website":"http:\/\/www.nba.com\/celtics","email":"","official_name":"Boston Celtics","founded":"1946","club_colors":"Green \/ Gold \/ Black","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25473.png","nicknames":"","primary_venue_id":"5066","primary_venue_name":"TD Garden"},"team_social_media":{"facebook":"https:\/\/www.facebook.com\/bostonceltics","twitter":"https:\/\/twitter.com\/celtics","youtube":"https:\/\/www.youtube.com\/user\/bostonceltics","google_plus":"https:\/\/plus.google.com\/+cavs\/posts","instagram":"https:\/\/www.instagram.com\/celtics\/","vk":""},"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_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25495.png","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","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25473.png","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_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25496.png","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","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25473.png","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_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25496.png","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","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25473.png","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_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25473.png","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","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25496.png","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_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25473.png","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","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25496.png","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_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25496.png","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","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25473.png","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"}]},"next_matches":[]}}}