No Subscription to this function
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 of substitutes in
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 of substitutes in
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 of substitutes in
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
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
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.
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 of substitutes in
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 of substitutes in
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 of substitutes in
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}"
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"}]}}}}