Player - Individual

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

Get Player

GET https://api.football-data-api.com/player-stats?key=YOURKEY&player_id=*

Sample Response (Access URL below) https://api.football-data-api.com/player?key=example&player_id=216091 Returns an array of player stats across all seasons and leagues that they've played in.

Query Parameters

NameTypeDescription

key*

string

Your API key.

player_id*

integer

ID of the player. Often obtained via League Players endpoint.

{
    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"
        ...
        }
        ...

^ Click on ">" icon in the above section to see all Queries and Parameters.

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

Last updated