Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /cricket/get_team
Returns a list of team details selected from team or season
Request URL
https://dsg-api.com/clients/{client_name}/cricket/get_team?team={team_id}&client={client_name}&authkey={client_authkey}
API Threshold
- 10k calls per hour (2.78 calls per second)
- This threshold applies to ALL your calls you do across the API.
- Your number of calls get reset every hour at :00
- If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
lang
string
two-character language code, defaults to 'en'
team
int Required
team id to get details from
Nodes
competition❯
details about the competition
competition_id
unique identifier for a competition
competition_name
name of the competition
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 call
sport
sport value
version
version of the API
discipline❯
basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant, contestant_team or team)
gender❯
details about the gender
age_group
defines the age group (senior,u23,u22,u21....)
value
gender type (male, female or mixed)
match❯
details about the match
date
date of match, format 'yyyy-mm-dd' (CET)
date_utc
date of match, format 'yyyy-mm-dd' (UTC)
final_period
display the period in which the match finished.
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 team_a
score_b
full-time score of team_b
status
status of the game (Played, Playing, Fixture, Cancelled, Postponed, Suspended, Awarded, Break, Retired, Bye, No Contest, Disqualified, Tech Knockout, Knockout, Draw, Submission) + (Cricket-specific = No Result, Tea, Lunch, Dinner, between Innings, Stumps, rain delay, bad light, crowd trouble, pitch condition, start delay, drinks, super over, floodlight failure)
team_a_area_code
three-letter-acronym of the area where the home team origins
team_a_area_id
unique area_id for team_a
team_a_area_name
area name of home team origins county
team_a_id
unique team ID for team_a
team_a_logo
team logo URL
team_a_name
current name of team_a
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 team_a
team_b_area_code
three-letter-acronym of the area where the home team origins
team_b_area_id
unique area_id for team_b
team_b_area_name
area name of away team origins county
team_b_id
unique team ID for team_b
team_b_logo
team logo URL
team_b_name
current name of team_b
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of team_b
team_b_tla_name
three-letter-acronym of team_b
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'
venue_type
determines if the match is on neutral ground or on home/away basis (home_away or neutral)
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
match_extra❯
extra informations about the match
attendance
amount of people that attended the particular match
gameweek
contains the gameweek a match belongs to.
method❯
details about the API function
method_id
unique ID of method
name
name of method
period❯
details about periods of the match
score_a
period score of team_a
score_b
period score of team_b
type
three-letter-acronym of the period
related_team❯
details about related teams
order
can be used to order the related teams (ascending)
team_id
unique identifier of the team
team_name
current team name
type
type of relation to the main team (reserve, youth, women, related)
round❯
basic identifier details about the round
round_id
unique identifier of round
season❯
identifier details of the season
season_id
unique identifier for season
team❯
basic details about a team
area_id
unique identifier for an area
area_name
name of the area
discipline_id
unique identifier of the discipline
discipline_name
name of the discipline
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
shortened name of the person
status
the current status of the team ('active' or 'defunct')
team_id
unique identifier of the team
team_name
current team name
tla_name
three letter acronym for this team
type
determines the type of team ('national' or 'club' or 'selection')
team_extra❯
extra details about a team
address
name of street and street number
address_city
name of the city
address_zip
ZIP code
club_colors
original colors of club (seperated with / )
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
website
official website address (URL)
team_social_media❯
details about the social media channels of the team
facebook
facebook channel URL
instagram
instagram channel URL
twitter
twitter channel URL
vk
vk channel URL
youtube
youtube channel URL
venue❯
basic details about the venue
venue_area_id
unique identifier for an area
venue_area_name
name of the area
venue_city
city where the venue is based
venue_id
unique identifier of the venue
venue_name
current name of the venue
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}/cricket/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}/cricket/get_team?team={team_id}&client={client_name}&authkey={client_authkey}"
Imports System
Imports System.Net
Imports System.IO
Imports System.Text
Public Module Module1
Public Sub Main()
Dim url As String = "https://dsg-api.com/clients/{client_name}/cricket/get_team?team={team_id}&client={client_name}&authkey={client_authkey}"
Dim myReq As WebRequest = WebRequest.Create(url)
myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
Dim wr As WebResponse = myReq.GetResponse()
Dim receiveStream As Stream = wr.GetResponseStream()
Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
Dim content As String = reader.ReadToEnd()
End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/cricket/get_team?team={team_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example200 Success{"datasportsgroup":{"version":"1.0","sport":"cricket","lang":"en","method":{"method_id":"188","name":"get_team"},"team":{"team_id":"25796","team_name":"Chennai Super Kings","short_name":"Chennai SK","tla_name":"CSK","type":"club","gender":"male","status":"active","area_id":"94","area_name":"India","last_updated":"2016-11-15 01:14:13","team_extra":{"adress":"","adress_zip":"","adress_city":"","tel":"","fax":"","website":"","email":"","official_name":"","founded":"","club_colors":"","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25796.png","nicknames":"","primary_venue_id":"11565","primary_venue_name":"M. A. Chidambaram Stadium"},"team_social_media":{"facebook":"","twitter":"","youtube":"","google_plus":"","instagram":"","vk":""},"last_matches":{"match":[{"match_id":"1610027","date":"2019-04-26","time":"16:30:00","date_utc":"2019-04-26","time_utc":"14:30:00","team_a_id":"25796","team_a_name":"Chennai Super Kings","team_a_short_name":"Chennai SK","team_a_tla_name":"CSK","team_a_original_name":"Chennai Super Kings","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25796.png","team_b_id":"25797","team_b_name":"Mumbai Indians","team_b_short_name":"Mumbai Indians","team_b_tla_name":"MI","team_b_original_name":"Mumbai Indians","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25797.png","status":"Played","gameweek":"","winner":"team_B","runs_a":"109","runs_b":"155","wickets_a":"10","wickets_b":"4","overs_a":"17.4","overs_b":"20.0","number_days":"1","result_text":"Mumbai Indians win by 46 runs","toss_team":"25796","toss_decision":"Field","toss_text":"Chennai Super Kings won the toss and elected to bowl.","win_margin":"46","win_type":"runs","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11565","venue_name":"M. A. Chidambaram Stadium","venue_city":"Chennai, Tamil Nadu","competition_id":"1048","competition_name":"VIVO IPL","season_id":"20972","round_id":"29790","last_updated":"2019-04-26 20:37:21"},{"match_id":"1610040","date":"2019-05-01","time":"16:30:00","date_utc":"2019-05-01","time_utc":"14:30:00","team_a_id":"25796","team_a_name":"Chennai Super Kings","team_a_short_name":"Chennai SK","team_a_tla_name":"CSK","team_a_original_name":"Chennai Super Kings","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25796.png","team_b_id":"25802","team_b_name":"Delhi Capitals","team_b_short_name":"Delhi Capitals","team_b_tla_name":"DEL","team_b_original_name":"Delhi Capitals","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25802.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"179","runs_b":"99","wickets_a":"4","wickets_b":"10","overs_a":"20.0","overs_b":"16.2","number_days":"1","result_text":"Chennai Super Kings win by 80 runs","toss_team":"25802","toss_decision":"Field","toss_text":"Delhi Capitals won the toss and elected to bowl.","win_margin":"80","win_type":"runs","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11565","venue_name":"M. A. Chidambaram Stadium","venue_city":"Chennai, Tamil Nadu","competition_id":"1048","competition_name":"VIVO IPL","season_id":"20972","round_id":"29790","last_updated":"2019-05-01 20:18:40"},{"match_id":"1610063","date":"2019-05-05","time":"12:30:00","date_utc":"2019-05-05","time_utc":"10:30:00","team_a_id":"25803","team_a_name":"Kings XI Punjab","team_a_short_name":"Kings XI","team_a_tla_name":"KXI","team_a_original_name":"Kings XI Punjab","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25803.png","team_b_id":"25796","team_b_name":"Chennai Super Kings","team_b_short_name":"Chennai SK","team_b_tla_name":"CSK","team_b_original_name":"Chennai Super Kings","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25796.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"173","runs_b":"170","wickets_a":"4","wickets_b":"5","overs_a":"18.0","overs_b":"20.0","number_days":"1","result_text":"Kings XI Punjab win by 6 wickets","toss_team":"25803","toss_decision":"Field","toss_text":"Kings XI Punjab won the toss and elected to bowl.","win_margin":"6","win_type":"wickets","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11568","venue_name":"IS Bindra Stadium","venue_city":"Mohali, Punjab","competition_id":"1048","competition_name":"VIVO IPL","season_id":"20972","round_id":"29790","last_updated":"2019-05-05 15:59:44"},{"match_id":"1631580","date":"2019-05-07","time":"16:00:00","date_utc":"2019-05-07","time_utc":"14:00:00","team_a_id":"25797","team_a_name":"Mumbai Indians","team_a_short_name":"Mumbai Indians","team_a_tla_name":"MI","team_a_original_name":"Mumbai Indians","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25797.png","team_b_id":"25796","team_b_name":"Chennai Super Kings","team_b_short_name":"Chennai SK","team_b_tla_name":"CSK","team_b_original_name":"Chennai Super Kings","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25796.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"132","runs_b":"131","wickets_a":"4","wickets_b":"4","overs_a":"18.3","overs_b":"20.0","number_days":"1","result_text":"Mumbai Indians win by 6 wickets","toss_team":"25796","toss_decision":"Bat","toss_text":"Chennai Super Kings won the toss and elected to bat.","win_margin":"6","win_type":"wickets","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11565","venue_name":"M. A. Chidambaram Stadium","venue_city":"Chennai, Tamil Nadu","competition_id":"1048","competition_name":"VIVO IPL","season_id":"20972","round_id":"31708","last_updated":"2019-05-09 17:06:34"},{"match_id":"1631582","date":"2019-05-10","time":"16:00:00","date_utc":"2019-05-10","time_utc":"14:00:00","team_a_id":"25796","team_a_name":"Chennai Super Kings","team_a_short_name":"Chennai SK","team_a_tla_name":"CSK","team_a_original_name":"Chennai Super Kings","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25796.png","team_b_id":"25802","team_b_name":"Delhi Capitals","team_b_short_name":"Delhi Capitals","team_b_tla_name":"DEL","team_b_original_name":"Delhi Capitals","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25802.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"151","runs_b":"147","wickets_a":"4","wickets_b":"9","overs_a":"19.0","overs_b":"20.0","number_days":"1","result_text":"Chennai Super Kings win by 6 wickets","toss_team":"25796","toss_decision":"Field","toss_text":"Chennai Super Kings won the toss and elected to bowl.","win_margin":"6","win_type":"wickets","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11976","venue_name":"Visakhapatnam ACA-VDCA Cricket Stadium","venue_city":"Visakhapatnam","competition_id":"1048","competition_name":"VIVO IPL","season_id":"20972","round_id":"31710","last_updated":"2019-05-10 19:35:56"},{"match_id":"1631583","date":"2019-05-12","time":"16:00:00","date_utc":"2019-05-12","time_utc":"14:00:00","team_a_id":"25797","team_a_name":"Mumbai Indians","team_a_short_name":"Mumbai Indians","team_a_tla_name":"MI","team_a_original_name":"Mumbai Indians","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25797.png","team_b_id":"25796","team_b_name":"Chennai Super Kings","team_b_short_name":"Chennai SK","team_b_tla_name":"CSK","team_b_original_name":"Chennai Super Kings","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25796.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"149","runs_b":"148","wickets_a":"8","wickets_b":"7","overs_a":"20.0","overs_b":"20.0","number_days":"1","result_text":"Mumbai Indians win by 1 run","toss_team":"25797","toss_decision":"Bat","toss_text":"Mumbai Indians won the toss and elected to bat.","win_margin":"1","win_type":"runs","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"7936","venue_name":"Rajiv Gandhi International Cricket Stadium","venue_city":"Uppal, Hyderabad","competition_id":"1048","competition_name":"VIVO IPL","season_id":"20972","round_id":"31711","last_updated":"2019-05-12 20:23:01"}]},"next_matches":[]}}}