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

FOOTBALL HOME ADVANTAGE API

Home advantage
Complimentary key

How often the home side wins, draws and loses, by competition and season. On the complimentary key it reads this season's Premier League.

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

PARAMETERS

competitionstringA competition from /v1/competitions, such as premier-league. Leave it out for every competition your key reads.
countrystringOnly this country, such as England.
seasonintegerThe first year of the season: 2026 for 2026/27.From 2015, or the competition's first season
group_bystringHow the figures are split: by competition, season, country, or competition and season.competition or season or country or competition_season

RETURNS

season_start_yearintegerThe first year of the season: 2026 for 2026/27
matchesintegerMatches counted
home_win_pctnumberShare 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
goal_advantagenumberHome goals less away goals, a match, on average
home_points_per_gamenumberPoints a match for the home side, on average
away_points_per_gamenumberPoints a match for the away side, on average

EXAMPLE ANSWER

200GET /v1/stats/home-advantage?competition=premier-league&group_by=season, taken 21 Oct 2026, first rows shown
{
  "data": [
    {
      "season_start_year": 2016,
      "matches": 380,
      "home_win_pct": 49.21,
      "draw_pct": 22.11,
      "away_win_pct": 28.68,
      "goal_advantage": 0.395,
      "home_points_per_game": 1.697,
      "away_points_per_game": 1.082
    },
    {
      "season_start_year": 2022,
      "matches": 380,
      "home_win_pct": 48.42,
      "draw_pct": 22.89,
      "away_win_pct": 28.68,
      "goal_advantage": 0.416,
      "home_points_per_game": 1.682,
      "away_points_per_game": 1.089
    }
  ],
  "meta": {
    "count": 12,
    "group_by": "season",
    "request_id": "req_d30a20f3a24c6dd2"
  }
}

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.
PREVIOUSScorelinesNEXTHalf time