Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v4 GET /sumo/get_peoples
Returns person informations
Request URL
https://dsg-api.com/clients/{client_name}/sumo/get_peoples?id=450133&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)
id
int Required
player id to return
lang
string
two-character language code, defaults to 'en'
ml
int
match limit for , max limit = 100
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
match❯
details about the specific match
contestant_a_common_name
common name of the contestant
contestant_a_draw_position
darw position of the contestant
contestant_a_first_name
first name of the contestant
contestant_a_id
unique identifier for the contestant
contestant_a_last_name
last name of the contestant
contestant_a_nationality_area_code
area code of contestant_a nationality
contestant_a_nationality_area_id
unique area_id of the contestants nationality
contestant_a_nationality_area_name
nationality of the contestant
contestant_a_seeding
seeding of the contestant
contestant_a_short_name
short name of the contestant
contestant_b_common_name
common name of the contestant
contestant_b_draw_position
darw position of the contestant
contestant_b_first_name
first name of the contestant
contestant_b_id
unique identifier for the contestant
contestant_b_last_name
last name of the contestant
contestant_b_nationality_area_code
area code of contestants nationality
contestant_b_nationality_area_id
unique area_id of the contestants nationality
contestant_b_nationality_area_name
nationality of the contestant
contestant_b_seeding
seeding of the contestant
contestant_b_short_name
match name of the contestant
date
date of match, format 'yyyy-mm-dd' (CET)
date_utc
date of match, format 'yyyy-mm-dd' (UTC)
draw_position
darw position of the match
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')
method❯
details about the API function
method_id
unique ID of method
name
name of method
people❯
basic information about the person
age
current age of 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_death
death 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
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
nationality
nationality of the person
nationality_area_id
unique identifier for an area
people_id
unique identifier for person
people_picture
full path URL of people headshot, size can be changed via the picsize parameter
place_of_birth
name of city the person was born
short_name
shortened name of the person
status
status of the player ('active', 'retired' or 'dead')
weight
weight of person in kilograms
round❯
basic details about the updated round
round_id
unique identifier of round
round_name
name of the round
season❯
details about the updated season
season_id
unique identifier for season
season_name
name of the competition for this particular season (including sponsor names etc)
season_title
title of season
social_media❯
details about the social media channels
esea
ESEA Profile URL
esl_gaming
ESL Profile URL
facebook
facebook channel URL
faceit
Faceit Profile URL
instagram
instagram channel URL
reddit
reddit channel URL
steamid
steam ID channel URL
strava
strava Profile URL
tiktok
Tiktok Profile URL
twitch
Twitch channel URL
twitter
twitter channel URL
vk
vk channel URL
website
official website address (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}/sumo/get_peoples?id=450133&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}/sumo/get_peoples?id=450133&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}/sumo/get_peoples?id=450133&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}/sumo/get_peoples?id=450133&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success