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

FOOTBALL SCORELINES API

Scorelines
Complimentary key

How often each exact scoreline happens, by competition and season. On the complimentary key it reads this season's Premier League.

GET/v1/stats/scorelines
TRY ITComplimentary
Kept in this browser for every docs page. No key yet? Get a free key
GET https://api.footballapi.org/v1/stats/scorelines?competition=premier-league&group_by=season
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/stats/scorelines?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.
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

scorelinestringThe scoreline, home first
matchesintegerMatches counted
share_pctnumberShare of matches with it, as a percentage
resultstringHow it ended, from the home side: home, draw or away

EXAMPLE ANSWER

200GET /v1/stats/scorelines?competition=premier-league&group_by=season, taken 21 Oct 2026, first rows shown
{
  "data": [
    {
      "scoreline": "1-1",
      "matches": 1619,
      "share_pct": 11.207,
      "result": "draw"
    },
    {
      "scoreline": "1-0",
      "matches": 1440,
      "share_pct": 9.968,
      "result": "home"
    }
  ],
  "meta": {
    "count": 37,
    "group_by": "season",
    "request_id": "req_9b6b4f123b583708"
  }
}

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.
PREVIOUSGoalsNEXTHome advantage