Sport winner API

Our sport winner API is providing historical stats on winners on major sport events.

Current sport events we provide data for:

UEFA Champions league
Super Bowl
Cricket World Cup
Stanley Cup (NHL)
Wimbledon
Wimbledon woman
French open (Tennis)
French open woman (Tennis)
Tour de france
FIFA World Cup
The Masters tournament (Golf)
Premier league (football)

If you have any wishes, please contact us and we will add it for you. Contact us here.

Docs

All available endpoints

GET https://api.algobook.info/v1/sports/championsLeague
GET https://api.algobook.info/v1/sports/championsLeague/:year
GET https://api.algobook.info/v1/sports/premierLeague
GET https://api.algobook.info/v1/sports/premierLeague/:year
GET https://api.algobook.info/v1/sports/stanleyCup
GET https://api.algobook.info/v1/sports/stanleyCup/:season
GET https://api.algobook.info/v1/sports/wimbledon
GET https://api.algobook.info/v1/sports/wimbledon/:year
GET https://api.algobook.info/v1/sports/womanwimbledon
GET https://api.algobook.info/v1/sports/womanwimbledon/:year
GET https://api.algobook.info/v1/sports/frenchopen
GET https://api.algobook.info/v1/sports/frenchopen/:year
GET https://api.algobook.info/v1/sports/womanfrenchopen
GET https://api.algobook.info/v1/sports/womanfrenchopen/:year
GET https://api.algobook.info/v1/sports/fifaWorldCup
GET https://api.algobook.info/v1/sports/fifaWorldCup/:year
GET https://api.algobook.info/v1/sports/tourdefrance
GET https://api.algobook.info/v1/sports/tourdefrance/:year
GET https://api.algobook.info/v1/sports/superbowl
GET https://api.algobook.info/v1/sports/superbowl/:year
GET https://api.algobook.info/v1/sports/cricketworldcup
GET https://api.algobook.info/v1/sports/cricketworldcup/:year
GET https://api.algobook.info/v1/sports/themasters
GET https://api.algobook.info/v1/sports/themasters/:year

Below we will share some examples in JavaScript on how the API can be consumed

GET /sports/championsLeage

This endpoint will return all historical data we have for Champions League football

const response = await fetch(
  "https://api.algobook.info/v1/sports/championsLeague"
);
const data = await response.json();
console.log(data);

Response

Note that we have stripped down the data in below response

[
    {
        "year": "1955-56",
        "finalScore": "4-3",
        "winner": {
            "country": "ESP",
            "team": "Real Madrid"
        },
        "loser": {
            "country": "FRA",
            "team": "Reims"
        },
        "venue": "Parc des Princes",
        "audienceCount": "38,239"
    },
    {
        "year": "1956-57",
        "finalScore": "2-0",
        "winner": {
            "country": "ESP",
            "team": "Real Madrid"
        },
        "loser": {
            "country": "ITA",
            "team": "Fiorentina"
        },
        "venue": "Santiago Bernabéu",
        "audienceCount": "124,000"
    },
    ......
    {
        "year": "2021-22",
        "finalScore": "1-0",
        "winner": {
            "country": "ESP",
            "team": "Real Madrid"
        },
        "loser": {
            "country": "ENG",
            "team": "Liverpool"
        },
        "venue": "Stade de France",
        "audienceCount": "75,000"
    }
]

GET /sports/championsLeage/:year

By providing a year, you will only get one entity back

Note that format of year should be xxxx-yy.

const response = await fetch(
  "https://api.algobook.info/v1/sports/championsLeague/1999-00"
);
const data = await response.json();
console.log(data);

Response

{
  "year": "1999-00",
  "finalScore": "3-0",
  "winner": {
    "country": "ESP",
    "team": "Real Madrid"
  },
  "loser": {
    "country": "ESP",
    "team": "Valencia"
  },
  "venue": "Stade de France",
  "audienceCount": "80,000"
}

GET /sports/stanleyCup

Get all historical winners of the Stanley Cup

const response = await fetch("https://api.algobook.info/v1/sports/stanleyCup");
const data = await response.json();
console.log(data);

Response

Note that we have stripped down the data in below response

[
    {
        "season": "1927",
        "winningTeam": {
            "name": "Ottawa Senators",
            "coach": "Dave Gill"
        },
        "loserTeam": {
            "name": "Boston Bruins",
            "coach": "Art Ross"
        },
        "games": "2–0",
        "winningGoal": "Cy Denneny (7:30, second)"
    },
    {
        "season": "1928",
        "winningTeam": {
            "name": "New York Rangers",
            "coach": "Lester Patrick"
        },
        "loserTeam": {
            "name": "Montreal Maroons",
            "coach": "Eddie Gerard"
        },
        "games": "3–2",
        "winningGoal": "Frank Boucher (3:35, third)"
    },

    ....

    {
        "season": "2022",
        "winningTeam": {
            "name": "Colorado Avalanche",
            "coach": "Jared Bednar"
        },
        "loserTeam": {
            "name": "Tampa Bay Lightning",
            "coach": "Jon Cooper"
        },
        "games": "4–2",
        "winningGoal": "Artturi Lehkonen (12:28, second)"
    }

GET /sports/stanleyCup/:season

Get only one season result by providing the season in the endpoint

const response = await fetch(
  "https://api.algobook.info/v1/sports/stanleyCup/2022"
);
const data = await response.json();
console.log(data);

Response

{
  "season": "2022",
  "winningTeam": {
    "name": "Colorado Avalanche",
    "coach": "Jared Bednar"
  },
  "loserTeam": {
    "name": "Tampa Bay Lightning",
    "coach": "Jon Cooper"
  },
  "games": "4–2",
  "winningGoal": "Artturi Lehkonen (12:28, second)"
}

GET /sports/wimbledon

Get all winners and runner ups for Wimbledon since 1968

const response = await fetch("https://api.algobook.info/v1/sports/wimbledon");
const data = await response.json();
console.log(data);

[
  ....
  {
    "year": "2017",
    "winner": {
      "country": "SUI",
      "name": "Roger Federer"
    },
    "loser": {
      "country": "CRO",
      "name": "Marin Čilić"
    },
    "setScores": "6-3, 6-1, 6-4"
  },
  {
    "year": "2018",
    "winner": {
      "country": "SRB",
      "name": "Novak Djokovic"
    },
    "loser": {
      "country": "RSA",
      "name": "Kevin Anderson"
    },
    "setScores": "6-2, 6-2, 7-6(7-3)"
  },
  {
    "year": "2019",
    "winner": {
      "country": "SRB",
      "name": "Novak Djokovic"
    },
    "loser": {
      "country": "SUI",
      "name": "Roger Federer"
    },
    "setScores": "7-6(7-5), 1-6, 7-6(7-4), 4-6, 13-12(7-3)"
  },
  {
    "year": "2021",
    "winner": {
      "country": "SRB",
      "name": "Novak Djokovic"
    },
    "loser": {
      "country": "ITA",
      "name": "Matteo Berrettini"
    },
    "setScores": "6-7(4-7), 6-4, 6-4, 6-3"
  },
  {
    "year": "2022",
    "winner": {
      "country": "SRB",
      "name": "Novak Djokovic"
    },
    "loser": {
      "country": "AUS",
      "name": "Nick Kyrgios"
    },
    "setScores": "4-6, 6-3, 6-4, 7-6(7-3)"
  }
]

GET /sports/wimbledon/:year

To get one years winner, pass in year as parameter

const response = await fetch(
  "https://api.algobook.info/v1/sports/wimbledon/2022"
);
const data = await response.json();
console.log(data);

{
  "year": "2022",
  "winner": {
    "country": "SRB",
    "name": "Novak Djokovic"
  },
  "loser": {
    "country": "AUS",
    "name": "Nick Kyrgios"
  },
  "setScores": "4-6, 6-3, 6-4, 7-6(7-3)"
}

Extending the API

We want to grow this API to support more sport events. If you have any great suggestions, please don't hesitate to contact us and we will make sure we will add it. Contact us here.

Feedback

If any feedback, feature requests or issues - contact us here

See all our articles See all our open source projects