Algobook
- The developer's handbook
mode-switch
back-button
Buy Me A Coffee

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

signature
See all our articlesSee all our open source projects