Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
GET /volleyball/get_peoples
Returns person informations and list of teams the person were member of.
Request URL
https://dsg-api.com/clients/{client_name}/volleyball/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
competition
player statistics in the specific competition
appearances
number of appearances
block_points
number of block points
competition_id
unique identifier for a competition.
competition_name
name of the competition
comp_area_id
unique identifier for area.
comp_format
competition format to filter out leagues or cups
lineup
number being starting player
points
number of points
rec_attempts
number of reception attempts
rec_excellents
number of reception excellents
rec_faults
number of reception faults
serve_attempts
number of serve attempts
serve_faults
number of serve faults
serve_points
number of serve points
spike_attempts
number of spike attempts
spike_faults
number of spike faults
spike_points
number of spike points
subs_on_bench
number of subs on bench
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
main_club_career
player statistics in all club competitions
appearances
number of appearances
block_points
number of block points
lineup
number being starting player
points
number of points
rec_attempts
number of reception attempts
rec_excellents
number of reception excellents
rec_faults
number of reception faults
serve_attempts
number of serve attempts
serve_faults
number of serve faults
serve_points
number of serve points
spike_attempts
number of spike attempts
spike_faults
number of spike faults
spike_points
number of spike points
subs_on_bench
number of subs on bench
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
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
duration
total duration of the match
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
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.
p1s_a
1st set score of home team.
p1s_b
1st set score of away team.
p2s_a
2nd set score of home team.
p2s_b
2nd set score of away team.
p3s_a
3rd set score of home team.
p3s_b
3rd set score of away team.
p4s_a
4th set score of home team.
p4s_b
4th set score of away team.
p5s_a
5th set score of home team.
p5s_b
5th set score of away team.
pgs_a
Golden set score of home team.
pgs_b
Golden set score of away team.
round_id
unique identifier of round
score_a
full-time score of home team, including any goals in over-time
score_b
full-time score of away team, including any goals in over-time
season_id
unique identifier of a particular 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')
membership
Membership handles the relation from a person to a team
active
Determines if person is still at the team ('yes') or not ('no').
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
block
block height in centimeters
common_name
common name of the person
country_of_birth
name of the country the person was born
date_of_birth
birth date of the person
date_of_death
date the people died
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
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_name
shortened match name of the person
nationality
current nationality of the person
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
spike
spike height in centimeters
status
status of the player ('active', 'retired' or 'dead')
weight
Weight of person in kilograms.
season_statistic
player statistics in the specific season
appearances
number of appearances
block_points
number of block points
competition_name
name of the competition
comp_area_id
unique identifier for area.
comp_format
competition format to filter out leagues or cups
lineup
number being starting player
original_name
competition name during this season
points
number of points
rec_attempts
number of reception attempts
rec_excellents
number of reception excellents
rec_faults
number of reception faults
season_id
unique identifier of a particular season
serve_attempts
number of serve attempts
serve_faults
number of serve faults
serve_points
number of serve points
spike_attempts
number of spike attempts
spike_faults
number of spike faults
spike_points
number of spike points
start_date
Start date of season, format 'yyyy-mm-dd'.
subs_on_bench
number of subs on bench
title
title of season
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}/volleyball/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}/volleyball/get_peoples?id={people_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}/volleyball/get_peoples?id={people_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}/volleyball/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"volleyball","lang":"en","method":{"method_id":"115","name":"get_peoples"},"people":{"people_id":"451625","first_name":"Hatice Gizem","last_name":"Örge","match_name":"G. Örge","common_name":"Gizem Örge","date_of_birth":"1993-04-26","place_of_birth":"","country_of_birth":"Turkey","nationality":"Turkey","gender":"female","height":"170","weight":"59","position":"Libero","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/451625.png","membership":[{"membership_id":"2692258","team_id":"31451","team_name":"Turkey","team_area":"Turkey","type":"national","start_date":"2018-05-10","end_date":"","role":"player","active":"yes","last_updated":"2018-05-14 20:38:47"},{"membership_id":"1280970","team_id":"31195","team_name":"Vakıfbank İstanbul","team_area":"Turkey","type":"club","start_date":"2017-05-08","end_date":"","role":"player","active":"yes","last_updated":"2017-06-07 11:59:19"}],"last_matches":{"match":[{"match_id":"1592267","date":"2019-03-20","time":"17:00:00","date_utc":"2019-03-20","time_utc":"16:00:00","team_a_id":"31195","team_a_name":"Vakıfbank İstanbul","team_a_short_name":"Vakıfbank","team_a_tla_name":"VKF","team_a_original_name":"Vakıfbank İstanbul","team_a_country":"TUR","team_b_id":"31198","team_b_name":"Dinamo Moskva","team_b_short_name":"Dinamo Moskva","team_b_tla_name":"MOS","team_b_original_name":"Dinamo Moskva","team_b_country":"RUS","status":"Played","gameweek":"","winner":"team_A","score_a":"3","score_b":"0","p1s_a":"25","p1s_b":"19","p2s_a":"25","p2s_b":"16","p3s_a":"25","p3s_b":"8","p4s_a":"","p4s_b":"","p5s_a":"","p5s_b":"","pgs_a":"","pgs_b":"","duration":"1:03","venue_type":"home_away","final_period":"vbl_p3s","attendance":"1453","venue_id":"12114","venue_name":"VakıfBank Spor Sarayı","venue_city":"İstanbul","competition_id":"1832","competition_name":"CEV Women's Champions League","season_id":"17946","round_id":"23671","last_updated":"2019-03-21 07:41:37"},{"match_id":"1610923","date":"2019-04-04","time":"18:00:00","date_utc":"2019-04-04","time_utc":"16:00:00","team_a_id":"31195","team_a_name":"Vakıfbank İstanbul","team_a_short_name":"Vakıfbank","team_a_tla_name":"VKF","team_a_original_name":"Vakıfbank İstanbul","team_a_country":"TUR","team_b_id":"35403","team_b_name":"AGIL Volley","team_b_short_name":"AGIL Volley","team_b_tla_name":"AGI","team_b_original_name":"Igor Gorgonzola Novara","team_b_country":"ITA","status":"Played","gameweek":"","winner":"team_B","score_a":"0","score_b":"3","p1s_a":"17","p1s_b":"25","p2s_a":"25","p2s_b":"27","p3s_a":"15","p3s_b":"25","p4s_a":"","p4s_b":"","p5s_a":"","p5s_b":"","pgs_a":"","pgs_b":"","duration":"1:16","venue_type":"home_away","final_period":"vbl_p3s","attendance":"1995","venue_id":"12114","venue_name":"VakıfBank Spor Sarayı","venue_city":"İstanbul","competition_id":"1832","competition_name":"CEV Women's Champions League","season_id":"17946","round_id":"23672","last_updated":"2019-04-05 08:18:23"},{"match_id":"1610925","date":"2019-04-10","time":"20:30:00","date_utc":"2019-04-10","time_utc":"18:30:00","team_a_id":"35403","team_a_name":"AGIL Volley","team_a_short_name":"AGIL Volley","team_a_tla_name":"AGI","team_a_original_name":"Igor Gorgonzola Novara","team_a_country":"ITA","team_b_id":"31195","team_b_name":"Vakıfbank İstanbul","team_b_short_name":"Vakıfbank","team_b_tla_name":"VKF","team_b_original_name":"Vakıfbank İstanbul","team_b_country":"TUR","status":"Played","gameweek":"","winner":"team_B","score_a":"1","score_b":"3","p1s_a":"23","p1s_b":"25","p2s_a":"20","p2s_b":"25","p3s_a":"25","p3s_b":"15","p4s_a":"21","p4s_b":"25","p5s_a":"","p5s_b":"","pgs_a":"16","pgs_b":"14","duration":"2:05","venue_type":"home_away","final_period":"vbl_p3s","attendance":"3300","venue_id":"12118","venue_name":"Sporting Palace Novara","venue_city":"Novara","competition_id":"1832","competition_name":"CEV Women's Champions League","season_id":"17946","round_id":"23672","last_updated":"2019-04-11 08:09:14"},{"match_id":"1635003","date":"2019-05-28","time":"16:30:00","date_utc":"2019-05-28","time_utc":"14:30:00","team_a_id":"31451","team_a_name":"Turkey","team_a_short_name":"Turkey","team_a_tla_name":"TUR","team_a_original_name":"Turkey","team_a_country":"TUR","team_b_id":"34713","team_b_name":"Japan","team_b_short_name":"Japan","team_b_tla_name":"JPN","team_b_original_name":"Japan","team_b_country":"JPN","status":"Played","gameweek":"","winner":"team_B","score_a":"0","score_b":"3","p1s_a":"23","p1s_b":"25","p2s_a":"22","p2s_b":"25","p3s_a":"14","p3s_b":"25","p4s_a":"","p4s_b":"","p5s_a":"","p5s_b":"","pgs_a":"","pgs_b":"","duration":"1:22","venue_type":"home_away","final_period":"vbl_p3s","attendance":"1904","venue_id":"10866","venue_name":"Başkent Voleybol Salonu","venue_city":"Ankara","competition_id":"1770","competition_name":"FIVB Volleyball Women's Nations League","season_id":"21492","round_id":"32186","last_updated":"2019-06-14 08:24:48"},{"match_id":"1635011","date":"2019-05-29","time":"16:30:00","date_utc":"2019-05-29","time_utc":"14:30:00","team_a_id":"34711","team_a_name":"Germany","team_a_short_name":"Germany","team_a_tla_name":"GER","team_a_original_name":"Germany","team_a_country":"DEU","team_b_id":"31451","team_b_name":"Turkey","team_b_short_name":"Turkey","team_b_tla_name":"TUR","team_b_original_name":"Turkey","team_b_country":"TUR","status":"Played","gameweek":"","winner":"team_B","score_a":"0","score_b":"3","p1s_a":"21","p1s_b":"25","p2s_a":"16","p2s_b":"25","p3s_a":"15","p3s_b":"25","p4s_a":"","p4s_b":"","p5s_a":"","p5s_b":"","pgs_a":"","pgs_b":"","duration":"1:16","venue_type":"home_away","final_period":"vbl_p3s","attendance":"1407","venue_id":"10866","venue_name":"Başkent Voleybol Salonu","venue_city":"Ankara","competition_id":"1770","competition_name":"FIVB Volleyball Women's Nations League","season_id":"21492","round_id":"32186","last_updated":"2019-06-14 08:28:35"},{"match_id":"1635019","date":"2019-05-30","time":"16:30:00","date_utc":"2019-05-30","time_utc":"14:30:00","team_a_id":"31451","team_a_name":"Turkey","team_a_short_name":"Turkey","team_a_tla_name":"TUR","team_a_original_name":"Turkey","team_a_country":"TUR","team_b_id":"34714","team_b_name":"Russia","team_b_short_name":"Russia","team_b_tla_name":"RUS","team_b_original_name":"Russia","team_b_country":"RUS","status":"Played","gameweek":"","winner":"team_A","score_a":"3","score_b":"0","p1s_a":"25","p1s_b":"19","p2s_a":"25","p2s_b":"21","p3s_a":"25","p3s_b":"20","p4s_a":"","p4s_b":"","p5s_a":"","p5s_b":"","pgs_a":"","pgs_b":"","duration":"1:26","venue_type":"home_away","final_period":"vbl_p3s","attendance":"2003","venue_id":"10866","venue_name":"Başkent Voleybol Salonu","venue_city":"Ankara","competition_id":"1770","competition_name":"FIVB Volleyball Women's Nations League","season_id":"21492","round_id":"32186","last_updated":"2019-06-26 15:24:39"}]}}}}