Home How-to use the Sportmonks’ Football Predictions API

How-to use the Sportmonks’ Football Predictions API

Welcome to our comprehensive How-to use the Sportmonks’ Football Prediction API. Whether you’re a passionate football fan seeking insights or a seasoned bettor aiming to make informed decisions, our state-of-the-art Prediction Service, developed and continuously refined since 2017, offers accurate predictions for various leagues and markets.

Join us as we explore how to maximise your football experience and unlock the potential of our advanced Prediction API.

Football

Guides

Time to read< 1 min

Published 20 February 2024

Last updated 7 March 2024

How-to use the Sportmonks’ Football Predictions API

What is a Prediction API?

But first thing first, what’s a Prediction API anyway? We’ve all been there, wishing you could peek into the future of your favourite team’s football matches. Unfortunately, we can’t do that. But a Prediction API can! A Prediction API looks at team stats, player performances, and past games to make its predictions. And the best part? It’s always learning, getting better with each match it analyses.

But it’s not just for fans—it’s a total game-changer for businesses too! Betting sites and sports blogs use it to make wise choices and keep fans on the edge of their seats.

Whether you’re a die-hard football fan, betting expert or a business owner, it’s your secret weapon for staying ahead of the game!

How you can benefit
How-to use the Sportmonks’ Football Predictions API
Practical example
The data explained
Value Bet

Why Choose Our Advanced Prediction Service?

In the competitive realm of football predictions, precision and reliability are paramount. Our Prediction Service stands out as a pinnacle of excellence, offering:

Advanced Predictions:
Our cutting-edge algorithms leverage accurate, data-driven match probabilities, considering team dynamics, previous match analytics, player contributions, and more for precise predictions.

Live data:
Stay ahead of the curve with predictions available 21 days before kick-off and daily updates, ensuring access to the latest data and forecasts.

Diverse Market Coverage:
Whether it’s match-winners, double chances, total goals, or other markets, our service offers extensive coverage, allowing users to explore various betting options and tailor strategies accordingly.

Detailed documentation:
Dive into our comprehensive Football API documentation, providing clear instructions on accessing daily predictions, probabilities, and average bookie odds for seamless integration into your projects.

Easy Integration:
Our Prediction API is designed for easy integration, allowing you to incorporate accurate predictions and probabilities effortlessly into applications, websites, or betting platforms.

Enough information? Ready to elevate your football experience?

Start your free trial now

Unlocking the Power of Our Prediction API:

Here’s how to harness the potential of our Football Prediction API.

Getting started

You will need some tools to access football predictions.

A MySportmonks account and subscription
First, register on MySportmonks with your preferred option. After that, choose the plan that best suits your needs and select the Prediction API in the add-on section. Having trouble finding the best plan for your application? Contact our sales team for more guidance.

Your personalised Sportmonks API token
Unlocking the full potential of your football application begins with your personalised API token after creating your My.Sportmonks account, navigate to the API Token page to generate your unique token. For security reasons, the API token will only be shown to you once upon creation. Please make sure to write down your API token somewhere safe.

Choose your preferred endpoint
Enrich your applications with detailed predictions. Our Predictions API offers predictions on various markets like the winner, correct scores, over/under, and both teams to score (BTTS), which are all available here, produced with our machine learning techniques and models.

Use one of our three probability endpoints. Per endpoint, you can find the details, including base URL, parameters, includes and more.

GET Probabilities: Retrieve all probabilities available within your subscription, exploring match outcomes or assessing potential betting options.
GET Performance by League ID: Investigate the performance of our Predictions Model for specific leagues, obtaining detailed performance metrics tailored to your requested league ID.
GET Probabilities by Fixture ID: Access predictions for particular fixtures, ideal for daily football predictions or analysing upcoming matchups.

Check our documentaiton

{
  "data": {
    "id": 18842136,
    "sport_id": 1,
    "league_id": 8,
    "season_id": 21646,
    "stage_id": 77464011,
    "group_id": null,
    "aggregate_id": null,
    "round_id": 307127,
    "state_id": 5,
    "venue_id": 206,
    "name": "Manchester United vs Manchester City",
    "starting_at": "2023-10-29 15:30:00",
    "result_info": "Manchester City won after full-time.",
    "leg": "1/1",
    "details": null,
    "length": 90,
    "placeholder": false,
    "has_odds": true,
    "starting_at_timestamp": 1698593400,
    "predictions": [
      {
        "id": 8870093,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 72.1,
          "no": 27.9
        },
        "type_id": 334,
        "type": {
          "id": 334,
          "name": "Home Over/Under 0.5 Probability",
          "code": "home-over-under-0_5_probability",
          "developer_name": "HOME_OVER_UNDER_0_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870091,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 46.83,
          "no": 53.17
        },
        "type_id": 236,
        "type": {
          "id": 236,
          "name": "Over/Under 3.5 Probability",
          "code": "over-under-3_5_probability",
          "developer_name": "OVER_UNDER_3_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870097,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 67.08,
          "no": 32.92
        },
        "type_id": 235,
        "type": {
          "id": 235,
          "name": "Over/Under 2.5 Probability",
          "code": "over-under-2_5-probability",
          "developer_name": "OVER_UNDER_2_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870085,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 25.44,
          "no": 74.56
        },
        "type_id": 328,
        "type": {
          "id": 328,
          "name": "Away Over/Under 2.5 Probability",
          "code": "away-over-under-2_5_probability",
          "developer_name": "AWAY_OVER_UNDER_2_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870105,
        "fixture_id": 18842136,
        "predictions": {
          "home": 35.05,
          "away": 42.48,
          "draw": 22.48
        },
        "type_id": 237,
        "type": {
          "id": 237,
          "name": "Fulltime Result Probability",
          "code": "fulltime-result-probability",
          "developer_name": "FULLTIME_RESULT_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870094,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 44.52,
          "no": 55.48
        },
        "type_id": 331,
        "type": {
          "id": 331,
          "name": "Home Over/Under 1.5 Probability",
          "code": "home-over-under-1_5_probability",
          "developer_name": "HOME_OVER_UNDER_1_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870099,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 84.83,
          "no": 15.17
        },
        "type_id": 234,
        "type": {
          "id": 234,
          "name": "Over/Under 1.5 Probability",
          "code": "over-under-1_5-probability",
          "developer_name": "OVER_UNDER_1_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870095,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 75.53,
          "no": 24.47
        },
        "type_id": 333,
        "type": {
          "id": 333,
          "name": "Away Over/Under 0.5 Probability",
          "code": "away-over-under-0_5_probability",
          "developer_name": "AWAY_OVER_UNDER_0_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870096,
        "fixture_id": 18842136,
        "predictions": {
          "scores": {
            "0-0": 3.83,
            "0-1": 5.8,
            "0-2": 4.81,
            "0-3": 2.85,
            "1-0": 5.58,
            "1-1": 9.11,
            "1-2": 8.06,
            "1-3": 4.83,
            "2-0": 4.11,
            "2-1": 7.35,
            "2-2": 7.03,
            "2-3": 4.14,
            "3-0": 2.3,
            "3-1": 4.31,
            "3-2": 3.63,
            "3-3": 2.32,
            "Other_1": 8.69,
            "Other_2": 10.66,
            "Other_X": 0.64
          }
        },
        "type_id": 240,
        "type": {
          "id": 240,
          "name": "Correct Score Probability",
          "code": "correct-score-probability",
          "developer_name": "CORRECT_SCORE_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870104,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 65.71,
          "no": 34.29
        },
        "type_id": 231,
        "type": {
          "id": 231,
          "name": "Both Teams To Score Probability",
          "code": "both-teams-to-score-probability",
          "developer_name": "BTTS_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      }
    ]
  },

Practical example

For this how-to guide, we will use the ‘Probabilities by Fixture ID’ endpoint. We’re going to look at the Manchester Derby: Manchester United vs Manchester City, played in the 2023/2024 season of the English Premier League.

Step 1: Make our request

First, some general information about the English Premier League

League ID: 8
2023/2024 season id: 21646
Manchester United team ID: 14
Manchester City Team ID: 9
Fixture ID: 18842136

Based on the information, your request will be:

https://api.sportmonks.com/v3/football/predictions/probabilities/fixtures/18842136?api_token=YOUR_TOKEN

As mentioned before, you have multiple options for retrieving predictions, including the option to use the fixtures between dates or fixture by ID endpoint with predictions as include.

i.e;

https://api.sportmonks.com/v3/football/fixtures/18842136?api_token=YOUR_TOKEN&include=predictions

{
  "data": [
    {
      "id": 8870073,
      "fixture_id": 18842136,
      "predictions": {
        "yes": 30.08,
        "no": 69.92
      },
      "type_id": 1679,
      "type": {
        "id": 1679,
        "name": "Over/Under 4.5 Probability",
        "code": "over-under-4_5-probability",
        "developer_name": "OVER_UNDER_4_5_PROBABILITY",
        "model_type": "prediction",
        "stat_group": null
      }
    },
    {
      "id": 8870076,
      "fixture_id": 18842136,
      "predictions": {
        "yes": 90.42,
        "no": 4.49,
        "equal": 5.09
      },
      "type_id": 1690,
      "type": {
        "id": 1690,
        "name": "Corners Over/Under 4 Probability",
        "code": "corners-over-under-4-probability",
        "developer_name": "CORNERS_OVER_UNDER_4_PROBABILITY",
        "model_type": "prediction",
        "stat_group": null
      }
    },
    {
      "id": 8870079,
      "fixture_id": 18842136,
      "predictions": {
        "yes": 82.71,
        "no": 9.58,
        "equal": 7.72
      },
      "type_id": 1683,
      "type": {
        "id": 1683,
        "name": "Corners Over/Under 5 Probability",
        "code": "corners-over-under-5-probability",
        "developer_name": "CORNERS_OVER_UNDER_5_PROBABILITY",
        "model_type": "prediction",
        "stat_group": null
      }
    },
    {
      "id": 8870080,
      "fixture_id": 18842136,
      "predictions": {
        "yes": 72.57,
        "no": 17.29,
        "equal": 10.13
      },
      "type_id": 1685,
      "type": {
        "id": 1685,
        "name": "Corners Over/Under 6 Probability",
        "code": "corners-over-under-6-probability",
        "developer_name": "CORNERS_OVER_UNDER_6_PROBABILITY",
        "model_type": "prediction",
        "stat_group": null
      }
    },

Step 2: Analyse the response

By default, you will receive some static information. It can be tricky if you have limited experience with our Football API and its structure. As you can see, there are a lot of values, but what do they mean exactly?

For your convenience, you can include the type variable. This will return the definition of the values as well.

It is important to note that if you use the probabilities by fixture ID endpoint, you must repeat this step for all the other matches you’re interested in. But you won’t have to if you use the predictions included on one of our fixtures or livescores endpoints.

Predictions are updated multiple times a day. Take this into account when you start implementing.

Please note that including .type is not recommended as an inclusion on any endpoint. Types are used throughout the entire API. We recommend retrieving all types from the types endpoint and storing them in your database or other data structure. Only include the type if no other option exists or when testing the API.

{
  "data": {
    "id": 18842136,
    "sport_id": 1,
    "league_id": 8,
    "season_id": 21646,
    "stage_id": 77464011,
    "group_id": null,
    "aggregate_id": null,
    "round_id": 307127,
    "state_id": 5,
    "venue_id": 206,
    "name": "Manchester United vs Manchester City",
    "starting_at": "2023-10-29 15:30:00",
    "result_info": "Manchester City won after full-time.",
    "leg": "1/1",
    "details": null,
    "length": 90,
    "placeholder": false,
    "has_odds": true,
    "starting_at_timestamp": 1698593400,
    "predictions": [
      {
        "id": 8870093,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 72.1,
          "no": 27.9
        },
        "type_id": 334,
        "type": {
          "id": 334,
          "name": "Home Over/Under 0.5 Probability",
          "code": "home-over-under-0_5_probability",
          "developer_name": "HOME_OVER_UNDER_0_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870091,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 46.83,
          "no": 53.17
        },
        "type_id": 236,
        "type": {
          "id": 236,
          "name": "Over/Under 3.5 Probability",
          "code": "over-under-3_5_probability",
          "developer_name": "OVER_UNDER_3_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870097,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 67.08,
          "no": 32.92
        },
        "type_id": 235,
        "type": {
          "id": 235,
          "name": "Over/Under 2.5 Probability",
          "code": "over-under-2_5-probability",
          "developer_name": "OVER_UNDER_2_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870085,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 25.44,
          "no": 74.56
        },
        "type_id": 328,
        "type": {
          "id": 328,
          "name": "Away Over/Under 2.5 Probability",
          "code": "away-over-under-2_5_probability",
          "developer_name": "AWAY_OVER_UNDER_2_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870105,
        "fixture_id": 18842136,
        "predictions": {
          "home": 35.05,
          "away": 42.48,
          "draw": 22.48
        },
        "type_id": 237,
        "type": {
          "id": 237,
          "name": "Fulltime Result Probability",
          "code": "fulltime-result-probability",
          "developer_name": "FULLTIME_RESULT_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870094,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 44.52,
          "no": 55.48
        },
        "type_id": 331,
        "type": {
          "id": 331,
          "name": "Home Over/Under 1.5 Probability",
          "code": "home-over-under-1_5_probability",
          "developer_name": "HOME_OVER_UNDER_1_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870099,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 84.83,
          "no": 15.17
        },
        "type_id": 234,
        "type": {
          "id": 234,
          "name": "Over/Under 1.5 Probability",
          "code": "over-under-1_5-probability",
          "developer_name": "OVER_UNDER_1_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870095,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 75.53,
          "no": 24.47
        },
        "type_id": 333,
        "type": {
          "id": 333,
          "name": "Away Over/Under 0.5 Probability",
          "code": "away-over-under-0_5_probability",
          "developer_name": "AWAY_OVER_UNDER_0_5_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870096,
        "fixture_id": 18842136,
        "predictions": {
          "scores": {
            "0-0": 3.83,
            "0-1": 5.8,
            "0-2": 4.81,
            "0-3": 2.85,
            "1-0": 5.58,
            "1-1": 9.11,
            "1-2": 8.06,
            "1-3": 4.83,
            "2-0": 4.11,
            "2-1": 7.35,
            "2-2": 7.03,
            "2-3": 4.14,
            "3-0": 2.3,
            "3-1": 4.31,
            "3-2": 3.63,
            "3-3": 2.32,
            "Other_1": 8.69,
            "Other_2": 10.66,
            "Other_X": 0.64
          }
        },
        "type_id": 240,
        "type": {
          "id": 240,
          "name": "Correct Score Probability",
          "code": "correct-score-probability",
          "developer_name": "CORRECT_SCORE_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      },
      {
        "id": 8870104,
        "fixture_id": 18842136,
        "predictions": {
          "yes": 65.71,
          "no": 34.29
        },
        "type_id": 231,
        "type": {
          "id": 231,
          "name": "Both Teams To Score Probability",
          "code": "both-teams-to-score-probability",
          "developer_name": "BTTS_PROBABILITY",
          "model_type": "prediction",
          "stat_group": null
        }
      }
    ]
  },

Explanation of the data:

Both Teams To Score Probability (type id: 231) = 65,71% probability that both teams will score.

Over/Under 1.5 Probability (type id: 234) = 84,83% probability that there will be more than 1.5 goals.

Over/Under 2.5 Probability (type id: 235) = 67,08% probability that there will be more than 2.5 goals.

Over/Under 3.5 Probability (type id: 236) = 46,83 % probability of more than 3.5 goals, 53,17% probability of less than 3.5 goals.

Fulltime Result Probability (type id: 237) = probability of 35,05% that the home team (Manchester United) will win. 42,78% probability that the away team (Manchester City) will win and 22,48% probability that the match will end in a draw.

Correct Score Probability (type id: 240) = 9,11% probability of a final score of 1-1.

Away Over/Under 2.5 Probability (type id: 328) = 25,44% probability that the away team will score more than 2.5 goals, 74,56% probability that the away team will score less than 2.5 goals.

Home Over/Under 1.5 Probability (type id: 331) =44,52% probability that the home team will score more than 1.5 goals, 55,48% probability that the home team will score less than 1,5 goals.

Away Over/Under 0.5 Probability (type id: 333) = 75,53% probability that the away team will score more than 0.5 goals (Manchester City), 24,47% probability that the away team will score less than 0.5 goals.

Home Over/Under 0.5 Probability (type id: 334) = 72,10% probability that the away Home will score more than 0.5 goals (Manchester United), 27,90% probability that the home team will score less than 0.5 goals.

{
  "data": [
    {
      "id": 3507922,
      "fixture_id": 18535517,
      "predictions": {
        "bet": "1",
        "bookmaker": "interwetten",
        "odd": 1.9,
        "is_value": false,
        "stake": 0.95,
        "fair_odd": 1.84
      },
      "type_id": 33,
      "type": {
        "id": 33,
        "name": "Valuebet",
        "code": "valuebet",
        "developer_name": "VALUEBET",
        "model_type": "prediction",
        "stat_group": null
      }
    }

Value bets

Besides the Prediction API, we also have the Value Bet API. While the Prediction API evaluates the probabilities of game events, the Value Bet API processes thousands of historical odds data and market trends to find Value opportunities compared to bookmakers’ odds.

Once the opening odds are available, the value detection algorithm runs every 10 minutes up to the beginning of the match. Each value detected by the model comes with a set of features described below.

If you want to combine your Value Bets requests with your requests on the Fixture endpoint or Livescore endpoint, you can add the relationship include &include=valuebet.

Create stunning applications

Congratulations! You’ve embarked on a journey to master football predictions with our advanced Prediction API. Whether you’re a bettor seeking value opportunities or a fan seeking deeper insights, our Prediction Service is your gateway to unparalleled football experiences. Start your journey today and unlock the full potential of football predictions with our API.

Written by Wesley Van Rooij

Wesley van Rooij is a seasoned marketing and football expert with over 5 years of industry experience. His comprehensive knowledge of the Sportmonks Football API and a focused approach to APIs in the Sports Data industry allow him to offer invaluable insights and support to enthusiasts and businesses. His outstanding marketing and communication skills and technical writing expertise enable him to empathise with the world of developers. He understands their needs and challenges to facilitate the development of cutting-edge football applications that stand out in the market.

Are you interested in more information about how you can create stunning applications? Check out our How-to Create a Livescore Website Guide for tips and tricks.

Happy coding!