Player - Individual

Individual Player Endpoint. Provides stats for the player on a per season/league basis.

get
Get Player

https://api.footystats.org/player?key=YOURKEY&player_id=*
Returns an array of player stats across all seasons and leagues that they've played in.
Request
Response
Query Parameters
key
required
string
Your API key.
player_id
required
integer
ID of the player. Often obtained via League Players endpoint.
200: OK
Cake successfully retrieved.
{
success: true,
data: [
{
id: "3171",
competition_id: "6",
full_name: "Cristiano Ronaldo dos Santos Aveiro",
first_name: "Cristiano Ronaldo",
last_name: "dos Santos Aveiro",
known_as: "Cristiano Ronaldo",
shorthand: "cristiano-ronaldo",
age: "33",
league: "UEFA Champions League",
league_type: "Cup",
season: "2016/2017",
starting_year: "2016",
ending_year: "2017",
national_team_id: "0",
url: "/players/portugal/cristiano-ronaldo",
club_team_id: "84",
club_team_2_id: "-1",
position: "Forward",
minutes_played_overall: "1170",
minutes_played_home: "540",
minutes_played_away: "630",
birthday: "476438400",
nationality: "Portugal",
continent: "eu"
...
}
...

Variable

Description

id

ID of the player

competition_id

ID of the season (and League) that the stats are based out of

full_name / first_name / last_name

Name of the player

known_as

Common name of the player

shorthand

Programming friendly representation of the player's full name

age

Current age

league

Name of the league

league_type

Type of the league

season

Season year of the league

starting_year / ending_year

Starting / Ending year of the league

url

FootyStats URL of the player

club_team_id

Team ID of the club that the player was in during this season

club_team_2_id

Team ID of the club that the player has transferred to during this season

position

Position of the player

minutes_played_overall / home / away

minutes played in this league this season

birthday

UNIX representation of the player birthday

nationality

Nationality of the player

continent

Continent from which the player is from

appearances_overall / home / away

number of matches played

goals_overall / home / away

Number of goals scored

clean_sheets_overall / home / away

Number of clean sheets for this player's team for the matches that they played in

conceded_overall / home / away

Number of goals conceded while the player was on the pitch

assists_overall / home / away

Number of assists this player has earned

penalty_goals

Number of goals scored via Penalty kick

goals_involved_per_90_overall

Goals involved (Goals + Assists) per 90 minutes

assists_per_90_overall

Assists per 90 minutes

goals_per_90_overall / home / away

Goals scored per 90 minutes

conceded_per_90_overall

Goals conceded per 90 minutes

min_per_conceded_overall

Minutes per goal conceded

cards_overall

Number of Yellow / Red cards earned during this season in this league

yellow_cards_overall

Number of Yellow cards earned during this season in this league

red_cards_overall

Number of Red cards earned during this season in this league

min_per_match

Average number of minutes this player has played per match

min_per_card_overall

Minutes per card (Yellow / Red)

min_per_assist_overall

Minutes per assist

cards_per_90_overall

Cards per 90 minutes

last_match_timestamp

When the last match was played