Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

Football · England · Tier 1

Premier League API with every season since 1992/93

A Premier League API for live scores, fixtures, the table, line-ups and match statistics, all hanging off league id 195828. The archive runs from the league's first season, 1992/93, to the one being played, and every call answers in the same JSON as the other football competitions we carry.

  • 35 seasons since 1992/93
  • 20 clubs · 380 matches a season
  • League id 195828
  • Live scores on every plan

Premier League

GET /v2/leagues/195828

League id
195828
Category
England
Tier
1
Archive
35 seasons since 1992/93
Teams
20 clubs
Matches
380 matches a season
Division below
Championship
Live channel
league:195828

In the data

The Premier League in the API

What league id 195828 holds, and how its seasons are laid out.

One id, every season

GET /v2/leagues/195828 returns the league card: England, tier 1, the Championship in lowerDivisions and the dates of the season in progress. /seasons lists every season from 1992/93 on, newest first, and its season ids are what the table, the rounds, the fixtures and the statistics calls ask for. A season's own detail adds its running totals and the clubs that came up from the Championship.

Thirty-eight rounds

A season is 20 clubs playing 380 matches over 38 rounds. The table comes overall, home or away, with each club's last five results and the zone its place falls in, from the Champions League spots down to relegation, while /v2/teams/{id}/position-history follows one club week by week. The calendar counts the match days, the venues call lists the grounds, and from Pro the leaderboards rank every player by goals, assists, expected goals or rating.

Inside each match

While a match is on, its status, score and clock are current to the second; statistics, line-ups with player ratings and the shot map with xG and xGOT are read again about every 30 seconds. Pro adds momentum, heat maps, our win-probability model and AI commentary, and Enterprise adds ball tracking. The further back a season lies, the thinner its matches get: the first Premier League seasons are mostly results and tables.

First request

The Premier League in three calls

Every call starts from the league id, 195828. The seasons list gives the season ids, newest first, and the season id is what the tables, rounds, leaderboards and statistics ask for.

The answers use the usual { data, meta } envelope and the same field names as every other football competition, so the code works unchanged for the next league you add.

# Every season, newest first, with its season id
curl "https://api.datasportsapi.com/v2/leagues/195828/seasons" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# The table for that season
curl "https://api.datasportsapi.com/v2/leagues/195828/standings?season={seasonId}" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# The scoring chart, and more boards (Pro and up)
curl "https://api.datasportsapi.com/v2/leagues/195828/top-players?season={seasonId}&category=goals" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
GET /v2/leagues/195828 · trimmed
{ "data": {
    "id": 195828, "name": "Premier League", "sport": "football",
    "category": "England", "country": { "code": "EN", "name": "England" },
    "tier": 1, "gender": "male",
    "lowerDivisions": [ { "name": "Championship", … } ],
    …
} }

History

How much of the Premier League each plan reads

The archive goes back to 1992/93. Each plan reads back a set time from today; nothing live or upcoming is ever held back.

TopicHistoryWhat it covers of the Premier League
FreeLast 7 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 7 days.
StarterLast 30 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 30 days.
ProLast 6 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 6 months.
BusinessLast 12 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 12 months.
EnterpriseFull historyThe whole archive: 35 seasons since 1992/93.

Questions

Premier League API, answered

Anything else? The full FAQ covers quota, plans and the data in general.

What is the Premier League's id in the API?

195828. League ids are issued by us and do not change, so it can live in a config file. GET /v2/search?q=premier league finds it too, next to other competitions with the same name, such as the women's Premier League, the darts Premier League and the Indian Premier League in cricket; each hit names its sport.

Is there xG for Premier League matches?

Yes. Match statistics carry expected goals for both sides on every plan. From Pro, the shot map lists each shot with its xG and xGOT, pitch and goal-mouth coordinates, body part and situation, and a player's season statistics add expected goals and expected assists over the whole league season.

Can I follow promotion and relegation?

Yes. The league card names the Championship in lowerDivisions, and each season's /v2/leagues/195828/seasons/{seasonId} lists the promoted clubs in newcomersLowerDivision. The table's zone marks the relegation places, so the bottom three can be shown before the last round is played.

How far back does Premier League data go?

To 1992/93: the archive holds 35 seasons of the Premier League. How far back a key can read is set by its plan, counted back from today: Free 7 days, Starter 30 days, Pro 6 months, Business 12 months, and Enterprise the whole archive. Live and upcoming matches, and the table and statistics of a season still being played, are open on every plan.

Can I follow Premier League matches live on the free plan?

Yes. Live and upcoming matches are never held back by a plan, so a Free key follows every Premier League match in play through /v2/livescores or /v2/fixtures/{id}, with score, status and clock current to the second, within the plan's request quota. On Business and Enterprise, the WebSocket channel league:195828 pushes every change instead.

Keep reading

Other competitions

Everything in the football data Sports statistics API Live scores API

Build on the Premier League today.

1,000 free requests a day during the beta. No card, no sales call.