FOOTBALL API
Sign inRequest a key
The collectionDocumentationMembershipStatusSupport
Sign inRequest a key
Documentation / Seasons

FOOTBALL SEASON STATISTICS API

Season stats
Complimentary keyMCP tool season_stats

A season of a competition in figures: matches, goals, home and away wins, draws, clean sheets, scorelines and cards. On the complimentary key it reads this season's Premier League.

GET/v1/competitions/{competition}/seasons/{season}/stats
TRY ITComplimentary
Kept in this browser for every docs page. No key yet? Get a free key
GET https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/stats
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/stats" \
  -H "X-API-Key: your key"

PARAMETERS

competitionrequiredstringA competition from /v1/competitions, such as premier-league. In the path.
seasonrequiredintegerThe first year of the season: 2026 for 2026/27. In the path.From 2015, or the competition's first season

RETURNS

competitionstringThe competition's name in the collection, such as premier-league
competition_namestringThe competition as people write it
country_namestringThe country, or World or Europe for a tournament
seasonintegerThe season, by its first year
first_daystringThe first day counted
last_daystringThe last day counted
clubsintegerHow many clubs
matchesintegerMatches counted
goalsintegerGoals in the match
goals_per_matchnumberGoals a match, on average
home_win_pctintegerShare of matches the home side won, as a percentage
draw_pctnumberShare of matches drawn, as a percentage
away_win_pctnumberShare of matches the away side won, as a percentage
goalless_pctnumberShare of matches with no goals, as a percentage
over_2_5_pctnumberShare of matches with three goals or more, as a percentage
home_clean_sheet_pctnumberShare of matches where the home side let none in, as a percentage
away_clean_sheet_pctnumberShare of matches where the away side let none in, as a percentage
average_travel_kmintegerHow far away sides came, on average, in kilometres
common_scorelineslistThe scorelines seen most, most first
common_scorelines[].scorestringThe scoreline, home first
common_scorelines[].matchesintegerMatches counted
common_scorelines[].share_pctnumberShare of matches with it, as a percentage
cardsobjectCards a match
cards.yellow_per_matchnumberYellow cards a match, on average
cards.red_per_matchnumberRed cards a match, on average
cards.matchesintegerMatches counted

EXAMPLE ANSWER

200GET /v1/competitions/premier-league/seasons/2026/stats, taken 21 Oct 2026, first rows shown
{
  "data": {
    "competition": "premier-league",
    "competition_name": "Premier League",
    "country_name": "England",
    "season": 2026,
    "first_day": "2026-08-21",
    "last_day": "2026-10-19",
    "clubs": 20,
    "matches": 70,
    "goals": 203,
    "goals_per_match": 2.9,
    "home_win_pct": 40,
    "draw_pct": 28.6,
    "away_win_pct": 31.4,
    "goalless_pct": 7.1,
    "over_2_5_pct": 54.3,
    "home_clean_sheet_pct": 25.7,
    "away_clean_sheet_pct": 28.6,
    "average_travel_km": 193,
    "common_scorelines": [
      {
        "score": "2-2",
        "matches": 8,
        "share_pct": 11.4
      },
      {
        "score": "0-1",
        "matches": 8,
        "share_pct": 11.4
      },
      {
        "score": "1-1",
        "matches": 7,
        "share_pct": 10
      }
    ],
    "cards": {
      "yellow_per_match": 3.96,
      "red_per_match": 0.19,
      "matches": 70
    }
  },
  "meta": {
    "competition": "premier-league",
    "season": "2026/27",
    "request_id": "req_51fae11310c80cad"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.
400bad_requestA parameter is missing or not in the right form; the message names it.
403upgrade_requiredAnything outside this season's Premier League, on the complimentary key.
404not_foundAn id or competition we do not have.
422unknown_parameterA parameter this endpoint does not take.
429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.
PREVIOUSSeason matchesNEXTMatches