No Subscription to this function
GET /cricket/get_peoples
Returns person informations and list of teams the person were member of.
Request URL
https://dsg-api.com/clients/{client_name}/cricket/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
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
match
Details about match
attendance
amount of people that attended the particular match
competition_id
unique identifier for a competition.
competition_name
name of the competition
cricket_type
cricket type of the team (Test, ODI or T20)
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
duckworth_lewis
if value = 1, then the match was decided by D/L Method.
final_period
display the period/inning in which the match finished. ('crc_p1s','crc_p2s','crc_p3s' ....)
gameweek
contains the gameweek a match belongs to.
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
number_days
number of days
overs_a
number of overs played for home team
overs_b
number of overs played for away team
result_text
short phrase to mention which team won and by how much
round_id
unique identifier of round
runs_a
number of runs made for home team
runs_b
number of runs made for away team
season_id
unique identifier of a particular season
status
status of the game (Played, Playing, Fixture, Cancelled, Postponed, Suspended, Awarded,No Result, Break, Tea,Lunch, Dinner, between Innings, Stumps, rain delay, bad light, crowd trouble, pitch condition, start delay, drinks, super over, floodlight failure)
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'.
toss_decision
decision of the toss by team who won it. valid values are "Bat" or "Field"
toss_team
team_id of the team which won the toss
toss_text
short phrase which names the toss winner and what was elected.
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
wickets_a
number of wickets made for home team
wickets_b
number of wickets made for away team
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
win_margin
the value tells you with which margin the win was achieved by referencing attribute win_type
win_type
the value tells you how the win was achieved. valid values are "wickets" and "runs"
membership
Membership handles the relation from a person to a team
active
Determines if person is still at the team ('yes') or not ('no').
cricket_type
cricket type of the team (Test, ODI or T20)
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
ball_type
ball type of the player
batting_handed
batting hand of the player
bowling_handed
bowling hand of the player
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
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
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.
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_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}/cricket/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/cricket/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"cricket","lang":"en","method":{"method_id":"36","name":"get_peoples"},"people":{"people_id":"437690","first_name":"Kedar Mahadav","last_name":"Jadhav","match_name":"K. Jadhav","common_name":"Kedar Jadhav","date_of_birth":"1985-03-26","place_of_birth":"Puṇe","country_of_birth":"India","nationality":"India","gender":"male","height":"","weight":"","ball_type":"Off Spin","batting_handed":"right","bowling_handed":"right arm","position":"All-rounder","player_picture":"","membership":[{"membership_id":"2835858","team_id":"38306","team_name":"India A","short_name":"India A","team_area":"India","type":"national","start_date":"2018-10-25","end_date":"2018-11-22","role":"player","active":"no","last_updated":"2018-11-22 18:06:52"},{"membership_id":"2670718","team_id":"25796","team_name":"Chennai Super Kings","short_name":"Chennai SK","team_area":"India","type":"club","start_date":"2018-04-01","end_date":"","role":"player","active":"yes","last_updated":"2018-04-04 09:07:09"},{"membership_id":"1176007","team_id":"25798","team_name":"Royal Challengers Bangalore","short_name":"RC Bangalore","team_area":"India","type":"club","start_date":"2016-04-01","end_date":"2017-09-01","role":"player","active":"no","last_updated":"2018-04-04 09:06:57"},{"membership_id":"2600915","team_id":"33577","team_name":"India","short_name":"India","team_area":"India","type":"national","start_date":"2014-11-16","end_date":"","role":"player","active":"yes","last_updated":"2019-08-08 12:41:27"}],"last_matches":{"match":[{"match_id":"1426087","date":"2019-06-05","time":"11:30:00","date_utc":"2019-06-05","time_utc":"09:30:00","team_a_id":"33573","team_a_name":"South Africa","team_a_short_name":"South Africa","team_a_tla_name":"SAF","team_a_original_name":"South Africa","team_a_country":"RSA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33573.png","team_b_id":"33577","team_b_name":"India","team_b_short_name":"India","team_b_tla_name":"IND","team_b_original_name":"India","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33577.png","status":"Played","gameweek":"","winner":"team_B","runs_a":"227","runs_b":"230","wickets_a":"9","wickets_b":"4","overs_a":"50","overs_b":"47.3","number_days":"","result_text":"","toss_team":"33573","toss_decision":"Bat","toss_text":"South Africa won the toss and elected to bat.","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11965","venue_name":"The Ageas Bowl","venue_city":"Southampton","competition_id":"1824","competition_name":"ICC Cricket World Cup","season_id":"15317","round_id":"23742","last_updated":"2019-07-14 20:48:12"},{"match_id":"1426093","date":"2019-06-09","time":"11:30:00","date_utc":"2019-06-09","time_utc":"09:30:00","team_a_id":"33577","team_a_name":"India","team_a_short_name":"India","team_a_tla_name":"IND","team_a_original_name":"India","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33577.png","team_b_id":"33572","team_b_name":"Australia","team_b_short_name":"Australia","team_b_tla_name":"AUS","team_b_original_name":"Australia","team_b_country":"AUS","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33572.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"352","runs_b":"316","wickets_a":"5","wickets_b":"10","overs_a":"50","overs_b":"50","number_days":"","result_text":"","toss_team":"33577","toss_decision":"Bat","toss_text":"India won the toss and elected to bat.","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"10933","venue_name":"Kia Oval","venue_city":"London","competition_id":"1824","competition_name":"ICC Cricket World Cup","season_id":"15317","round_id":"23742","last_updated":"2019-07-14 20:50:53"},{"match_id":"1426101","date":"2019-06-16","time":"11:30:00","date_utc":"2019-06-16","time_utc":"09:30:00","team_a_id":"33577","team_a_name":"India","team_a_short_name":"India","team_a_tla_name":"IND","team_a_original_name":"India","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33577.png","team_b_id":"33575","team_b_name":"Pakistan","team_b_short_name":"Pakistan","team_b_tla_name":"PAK","team_b_original_name":"Pakistan","team_b_country":"PAK","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33575.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"336","runs_b":"212","wickets_a":"5","wickets_b":"6","overs_a":"50","overs_b":"40","number_days":"","result_text":"","toss_team":"33575","toss_decision":"Field","toss_text":"Pakistan won the toss and elected to bowl.","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11963","venue_name":"Old Trafford Cricket Ground","venue_city":"Manchester","competition_id":"1824","competition_name":"ICC Cricket World Cup","season_id":"15317","round_id":"23742","last_updated":"2019-07-14 20:53:01"},{"match_id":"1426107","date":"2019-06-22","time":"11:30:00","date_utc":"2019-06-22","time_utc":"09:30:00","team_a_id":"33577","team_a_name":"India","team_a_short_name":"India","team_a_tla_name":"IND","team_a_original_name":"India","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33577.png","team_b_id":"33581","team_b_name":"Afghanistan","team_b_short_name":"Afghanistan","team_b_tla_name":"AFG","team_b_original_name":"Afghanistan","team_b_country":"AFG","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33581.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"224","runs_b":"213","wickets_a":"8","wickets_b":"10","overs_a":"50","overs_b":"49.5","number_days":"","result_text":"","toss_team":"33577","toss_decision":"Bat","toss_text":"India won the toss and elected to bat.","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11965","venue_name":"The Ageas Bowl","venue_city":"Southampton","competition_id":"1824","competition_name":"ICC Cricket World Cup","season_id":"15317","round_id":"23742","last_updated":"2019-06-23 02:14:16"},{"match_id":"1426113","date":"2019-06-27","time":"11:30:00","date_utc":"2019-06-27","time_utc":"09:30:00","team_a_id":"33574","team_a_name":"Windies","team_a_short_name":"Windies","team_a_tla_name":"WIN","team_a_original_name":"Windies","team_a_country":"WIN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33574.png","team_b_id":"33577","team_b_name":"India","team_b_short_name":"India","team_b_tla_name":"IND","team_b_original_name":"India","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33577.png","status":"Played","gameweek":"","winner":"team_B","runs_a":"143","runs_b":"268","wickets_a":"9","wickets_b":"7","overs_a":"34","overs_b":"50","number_days":"","result_text":"","toss_team":"33577","toss_decision":"Bat","toss_text":"India won the toss and elected to bat.","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"11963","venue_name":"Old Trafford Cricket Ground","venue_city":"Manchester","competition_id":"1824","competition_name":"ICC Cricket World Cup","season_id":"15317","round_id":"23742","last_updated":"2019-06-27 18:48:14"},{"match_id":"1426117","date":"2019-06-30","time":"11:30:00","date_utc":"2019-06-30","time_utc":"09:30:00","team_a_id":"33570","team_a_name":"England","team_a_short_name":"England","team_a_tla_name":"ENG","team_a_original_name":"England","team_a_country":"ENG","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33570.png","team_b_id":"33577","team_b_name":"India","team_b_short_name":"India","team_b_tla_name":"IND","team_b_original_name":"India","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/33577.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"337","runs_b":"306","wickets_a":"7","wickets_b":"5","overs_a":"50","overs_b":"50","number_days":"","result_text":"","toss_team":"33570","toss_decision":"Bat","toss_text":"England won the toss and elected to bat.","win_margin":"","win_type":"","duckworth_lewis":"","venue_type":"home_away","final_period":"crc_p2s","attendance":"","venue_id":"12363","venue_name":"Edgbaston Cricket Ground","venue_city":"Birmingham","competition_id":"1824","competition_name":"ICC Cricket World Cup","season_id":"15317","round_id":"23742","last_updated":"2019-06-30 19:42:28"}]}}}}