FOOTBALL GOALS STATISTICS API

Goals

Complimentary key

Goals a game, how often matches go over or under each line, and how often both sides score, by competition and season. On the complimentary key it reads this season's Premier League.

GET/v1/stats/goals

TRY ITComplimentary

X-API-Key

Kept in this browser for every docs page. No key yet? Get a free key

competition

country

season

group_by

GET https://api.footballapi.org/v1/stats/goals?competition=premier-league&group_by=season

The answer appears below, with its status and time.

curl "https://api.footballapi.org/v1/stats/goals?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

goals_per_gamenumberGoals scored a match, on average

home_goals_per_gamenumberHome goals a match, on average

away_goals_per_gamenumberAway goals a match, on average

over_1_5_pctnumberShare of matches with two goals or more, as a percentage

over_2_5_pctnumberShare of matches with three goals or more, as a percentage

over_3_5_pctnumberShare of matches with four goals or more, as a percentage

both_scored_pctnumberShare of matches where both sides scored, as a percentage

goalless_pctnumberShare of matches with no goals, as a percentage

EXAMPLE ANSWER

200GET /v1/stats/goals?competition=premier-league&group_by=season, taken 21 Oct 2026, first rows shown

{
  "data": [
    {
      "season_start_year": 2023,
      "matches": 380,
      "goals_per_game": 3.279,
      "home_goals_per_game": 1.8,
      "away_goals_per_game": 1.479,
      "over_1_5_pct": 86.05,
      "over_2_5_pct": 64.74,
      "over_3_5_pct": 43.68,
      "both_scored_pct": 61.58,
      "goalless_pct": 2.89
    },
    {
      "season_start_year": 2024,
      "matches": 380,
      "goals_per_game": 2.934,
      "home_goals_per_game": 1.513,
      "away_goals_per_game": 1.421,
      "over_1_5_pct": 81.32,
      "over_2_5_pct": 56.58,
      "over_3_5_pct": 34.21,
      "both_scored_pct": 57.37,
      "goalless_pct": 4.21
    }
  ],
  "meta": {
    "count": 12,
    "group_by": "season",
    "request_id": "req_4dd04703c55ff5ce"
  }
}

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.

PREVIOUSGround NEXTScorelines