Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
GET /american_football/get_peoples
Returns person informations and list of teams the person were member of.
Request URL
https://dsg-api.com/clients/{client_name}/american_football/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 per competition
appearances
number of appearances (starting 11 + sub in)
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
conversions
number of conversions
extra_points
number of extra_points
field_goals
number of played minutes
lineup
number being starting player
safeties
number of safeties
subs_on_bench
number of subs on bench
touchdowns
number of touchdowns
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 (starting 11 + sub in)
conversions
number of conversions
extra_points
number of extra_points
field_goals
number of played minutes
lineup
number being starting player
safeties
number of safeties
subs_on_bench
number of subs on bench
touchdowns
number of touchdowns
main_national_team_career
player statistics in all national team competitions
appearances
number of appearances (starting 11 + sub in)
conversions
number of conversions
extra_points
number of extra_points
field_goals
number of played minutes
lineup
number being starting player
safeties
number of safeties
subs_on_bench
number of subs on bench
touchdowns
number of touchdowns
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)
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.
ot_a
over-time period score of home team.
ot_b
over-time period score of away team.
p1s_a
half-time score of home team.
p1s_b
half-time score of away team.
p2s_a
2nd half score of home team
p2s_b
2nd half 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 away team, including any goals in extra-time
season_id
unique identifier for 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
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
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
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
status
status of the player ('active', 'retired' or 'dead')
weight
Weight of person in kilograms.
season_statistic
player statistics per season
appearances
number of appearances (starting 11 + sub in)
competition_name
name of the competition.
comp_area_id
unique identifier for area.
comp_format
competition format to filter out leagues or cups
conversions
number of conversions
extra_points
number of extra_points
field_goals
number of played minutes
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
lineup
number being starting player
original_name
competition name during this season
safeties
number of safeties
season_id
unique identifier for season
shirtnumber
shirtnumber for the particular season
start_date
Start date of season, format 'yyyy-mm-dd'.
subs_on_bench
number of subs on bench
title
title of season
touchdowns
number of touchdowns
youth_club_career
player statistics in all youth club competitions
appearances
number of appearances (starting 11 + sub in)
conversions
number of conversions
extra_points
number of extra_points
field_goals
number of played minutes
lineup
number being starting player
safeties
number of safeties
subs_on_bench
number of subs on bench
touchdowns
number of touchdowns
youth_national_team_career
player statistics in all youth national team competitions
appearances
number of appearances (starting 11 + sub in)
conversions
number of conversions
extra_points
number of extra_points
field_goals
number of played minutes
lineup
number being starting player
safeties
number of safeties
subs_on_bench
number of subs on bench
touchdowns
number of touchdowns
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}/american_football/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}/american_football/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}/american_football/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}/american_football/get_peoples?id={people_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"american_football","lang":"en","method":{"method_id":"72","name":"get_peoples"},"people":{"people_id":"356212","first_name":"James","last_name":"Carpenter","match_name":"J. Carpenter","common_name":"James Carpenter","date_of_birth":"1989-03-22","place_of_birth":"","country_of_birth":"United States","nationality":"United States","gender":"male","height":"196","weight":"146","position":"Guard","player_picture":"https:\/\/www.dsg-images.com\/players\/150x150\/356212.png","membership":{"membership_id":"595684","team_id":"1","team_name":"New York Jets","short_name":"Jets","team_area":"United States","type":"club","start_date":"2015-08-01","end_date":"","role":"player","active":"yes","last_updated":"2017-09-07 15:24:28"},"last_matches":{"match":[{"match_id":"1321123","competition_id":"1","season_id":"15914","round_id":"21521","date":"2018-10-07","time":"19:00:00","date_utc":"2018-10-07","time_utc":"17:00:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/1.png","team_b_id":"15","team_b_name":"Denver Broncos","team_b_short_name":"Broncos","team_b_tla_name":"DEN","team_b_original_name":"Denver Broncos","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/15.png","status":"Played","gameweek":"5","winner":"team_A","score_a":"34","score_b":"16","p1s_a":"0","p1s_b":"7","p2s_a":"21","p2s_b":"3","p3s_a":"3","p3s_b":"0","p4s_a":"10","p4s_b":"6","et_a":"","et_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"77982","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","last_updated":"2018-10-09 08:41:20"},{"match_id":"1321140","competition_id":"1","season_id":"15914","round_id":"21521","date":"2018-10-14","time":"19:00:00","date_utc":"2018-10-14","time_utc":"17:00:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/1.png","team_b_id":"11","team_b_name":"Indianapolis Colts","team_b_short_name":"Colts","team_b_tla_name":"IND","team_b_original_name":"Indianapolis Colts","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/11.png","status":"Played","gameweek":"6","winner":"team_A","score_a":"42","score_b":"34","p1s_a":"10","p1s_b":"7","p2s_a":"13","p2s_b":"6","p3s_a":"10","p3s_b":"7","p4s_a":"9","p4s_b":"14","et_a":"","et_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"77982","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","last_updated":"2018-10-15 11:28:47"},{"match_id":"1321151","competition_id":"1","season_id":"15914","round_id":"21521","date":"2018-10-21","time":"19:00:00","date_utc":"2018-10-21","time_utc":"17:00:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/1.png","team_b_id":"23","team_b_name":"Minnesota Vikings","team_b_short_name":"Vikings","team_b_tla_name":"MIN","team_b_original_name":"Minnesota Vikings","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/23.png","status":"Played","gameweek":"7","winner":"team_B","score_a":"17","score_b":"37","p1s_a":"7","p1s_b":"7","p2s_a":"0","p2s_b":"3","p3s_a":"3","p3s_b":"10","p4s_a":"7","p4s_b":"17","et_a":"","et_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"77982","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","last_updated":"2018-10-22 12:10:15"},{"match_id":"1321167","competition_id":"1","season_id":"15914","round_id":"21521","date":"2018-10-28","time":"18:00:00","date_utc":"2018-10-28","time_utc":"17:00:00","team_a_id":"21","team_a_name":"Chicago Bears","team_a_short_name":"Bears","team_a_tla_name":"CHI","team_a_original_name":"Chicago Bears","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/21.png","team_b_id":"1","team_b_name":"New York Jets","team_b_short_name":"Jets","team_b_tla_name":"NYJ","team_b_original_name":"New York Jets","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/1.png","status":"Played","gameweek":"8","winner":"team_A","score_a":"24","score_b":"10","p1s_a":"7","p1s_b":"0","p2s_a":"0","p2s_b":"3","p3s_a":"7","p3s_b":"0","p4s_a":"10","p4s_b":"7","et_a":"","et_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"61397","venue_id":"1962","venue_name":"Soldier Field","venue_city":"Chicago, IL","last_updated":"2018-10-29 13:39:44"},{"match_id":"1321179","competition_id":"1","season_id":"15914","round_id":"21521","date":"2018-11-04","time":"19:00:00","date_utc":"2018-11-04","time_utc":"18:00:00","team_a_id":"3","team_a_name":"Miami Dolphins","team_a_short_name":"Dolphins","team_a_tla_name":"MIA","team_a_original_name":"Miami Dolphins","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/3.png","team_b_id":"1","team_b_name":"New York Jets","team_b_short_name":"Jets","team_b_tla_name":"NYJ","team_b_original_name":"New York Jets","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/1.png","status":"Played","gameweek":"9","winner":"team_A","score_a":"13","score_b":"6","p1s_a":"0","p1s_b":"0","p2s_a":"6","p2s_b":"3","p3s_a":"0","p3s_b":"0","p4s_a":"7","p4s_b":"3","et_a":"","et_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"65533","venue_id":"6727","venue_name":"Hard Rock Stadium","venue_city":"Miami Gardens, FL","last_updated":"2018-11-05 11:03:59"},{"match_id":"1321194","competition_id":"1","season_id":"15914","round_id":"21521","date":"2018-11-11","time":"19:00:00","date_utc":"2018-11-11","time_utc":"18:00:00","team_a_id":"1","team_a_name":"New York Jets","team_a_short_name":"Jets","team_a_tla_name":"NYJ","team_a_original_name":"New York Jets","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/1.png","team_b_id":"4","team_b_name":"Buffalo Bills","team_b_short_name":"Bills","team_b_tla_name":"BUF","team_b_original_name":"Buffalo Bills","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/150x150\/4.png","status":"Played","gameweek":"10","winner":"team_B","score_a":"10","score_b":"41","p1s_a":"0","p1s_b":"14","p2s_a":"3","p2s_b":"17","p3s_a":"7","p3s_b":"7","p4s_a":"0","p4s_b":"3","et_a":"","et_b":"","venue_type":"home_away","final_period":"amf_p4s","attendance":"77982","venue_id":"1999","venue_name":"MetLife Stadium","venue_city":"East Rutherford, NJ","last_updated":"2018-11-12 13:41:49"}]}}}}