Premier League Standings API

Overview

This API allows the user to access English Premier League Standings from the 1992/1993 season until the 2023/2024 season.

Base URL

https://api.msmc.cc

Endpoints

1. Pull 1st Place Team for Specified Season

Info

Endpoint: /api/premier/:season
Method: GET

Options

  1. :season - End year of the season you want

Example Endpoint

/api/premier/2020

Example Response

{
        "season_end_year": "2020",
        "team": "Liverpool",
        "position": "1",
        "played": "38",
        "won": "32",
        "drawn": "3",
        "lost": "3",
        "gf": "85",
        "ga": "33",
        "gd": "52",
        "points": "99",
        "notes": "Champions"
    }
    

2. Pull A Specified Standing from a Specified Season

Info

Endpoint: /api/premier/:season/:place
Method: GET

Options

  1. :season - End year of the season you want
  2. :place - place you want

Example Request

/api/premier/2015/3

Example Response

{
        "season_end_year": "2015",
        "team": "Arsenal",
        "position": "3",
        "played": "38",
        "won": "20",
        "drawn": "11",
        "lost": "7",
        "gf": "65",
        "ga": "36",
        "gd": "29",
        "points": "71",
        "notes": ""
    }
    

3. Pull 1st Place Team from a Random Season

Info

Endpoint: /api/premier/random
Method: GET

Example Endpoint

/api/premier/random

Example Response
{
        "season_end_year": "2004",
        "team": "Arsenal",
        "position": "1",
        "played": "38",
        "won": "26",
        "drawn": "12",
        "lost": "0",
        "gf": "73",
        "ga": "26",
        "gd": "47",
        "points": "90",
        "notes": "Invincible Season"
    }
    

4. Pull a Random Place from a Specified Season

Info

Endpoint: /api/premier/random/:season
Method: GET

Options

  1. :season - end year of the season you want

Example Endpoint

/api/premier/random/2010

Example Response

{
        "season_end_year": "2010",
        "team": "Liverpool",
        "position": "7",
        "played": "38",
        "won": "18",
        "drawn": "9",
        "lost": "11",
        "gf": "61",
        "ga": "35",
        "gd": "26",
        "points": "63",
        "notes": ""
    }
    

Support

For support, email [email protected]