Frequently Asked Questions about our Sports APIs

How can we help you?

Favorite questions

How does the API work?

We have built a well-structured, flexible, and fast JSON API. Our API makes it easy to customize your JSON responses.

Our API’s flexibility demonstrates itself by allowing its users to build their own responses in the form of adding include parameters to their requests. This means you can request the data you need and leave out the data you don’t need.

Filtering and Sorting is another widely used and loved characteristic of our API. It means you can request the data the way you want it to, by adding the proper filtering and sorting commands. Please check our documentation pages for more information.

How do we collect our data?

At Sportmonks, we manage all our data in the Sportmonks Scout Application Platform (SSAP). Our dedicated scout teams from all over the world add, manage and validate the data collected by this platform. We work together with high-class data partners to ensure our football data is reliable and always up to date.

How does the 14-day free trial work?

Once subscribed to one of our plans you will automatically receive the 14-day free trial. After 14 days, your credit card will be charged, unless you choose to cancel your subscription in time. You’re only permitted to have one free trial.

Who are we?

Sportmonks is a sports data provider, founded in 2016, primarily doing business in football, cricket and formula 1. We work with APIs to provide you the best possible data for an affordable price.

How can I request a custom plan?

There are two options for requesting a custom plan.

  1. You can email our sales team with the requirements of a plan. They will get you sorted with your request for a custom plan!
  2. You can go to my.sportmonks.com and create a custom plan yourself. Choose the leagues and data features you like and request a price. Our team will come back to you as soon as possible.

 

How can I test the Sportmonks API for FREE?

You have two options:

  1. Create an account on My Sportmonks and get immediate access to our free plan.
  2. Subscribe to one of our paid plans and receive a one-time-only 14-day free trial.

Expected Goals

Can I use xG with a custom plan?

Absolutely! If you have a personalized plan and wish to leverage the xG feature, simply reach out to our support team. We’ll swiftly arrange the setup of a tailored xG add-on for you.

Feel free to email us directly at [email protected] or get in touch with support via our contact page. We’re here to assist you every step of the way!

What are the numeric values associated with xG?

xG statistics generate numeric values that show the chance of scoring based on the quality of chances created or conceded. These values for one specific player usually range between 0 and 1.5 for a specific fixture. For example, Erling Haaland had an xG value of 1.1634 in the Manchester Derby (18842545). In that fixture, he scored 1 goal in total. Pretty accurate, right?

For that same fixture, the xG for both teams was as follows:

Manchester City: 3.6439 – Manchester United: 0.3841.

As you can see, the xG values are pretty accurate to the actual outcome, which was 3-1. However, Marcus Rashford’s wonder strike shows that xG doesn’t always tell the full story. He had an xG of 0.3553 for that match but did manage to score 1 goal.

Remember: This will not always be the case. You may expect Erlin Haaland to finish a 0,89 chance or to score at least once or twice if he has a total of 3,10 xG. However, that doesn’t mean the xG metrics are wrong if he doesn’t. xG metrics are just parameters to calculate the quality of a chance or multiple chances. Even if a chance has a 99% chance of resulting in a goal, there is a 1% chance it will not.

How does speed impact the availability of xG values?

The availability of xG values is influenced by the speed of data processing. Since xG calculations require match statistics like shots, there may be a delay before xG values become available. Patience is key as relevant match data is processed to generate accurate xG insights.

How does the reliability of xG values depend on the context of the match?

The reliability of xG values is contingent on various factors, including the context of the match. A nuanced understanding of the game’s flow, tempo, and dynamics enhances the interpretation of xG values, providing valuable insights into the scoring probabilities.

What is the update frequency for xG values?

xG values are continuously calculated and processed throughout the match, with updates occurring every couple of minutes. The maximum time between these updates should not exceed 5 minutes. Stay informed with real-time insights into evolving goal-scoring probabilities.

How can I get access to xG Data?

You can simply get access by going to MySportmonks and adding the Expected Goal add-on to your subscription. Not yet registered to MySportmonks? Create your account and start with Expected Goals by creating your New Subscription.

How are xG values calculated?

xG values are calculated using historical shot data. The calculations are made based on the shot’s location, angle, and distance. Next, the type of shot (for example, header or foot) is considered. The position of the goalkeeper and players is also used in the calculations. This data and additional information are used to create the different xG metrics, providing a comprehensive understanding of goal-scoring probabilities.

Expected goals is usually expressed as a value between 0 and 1, where 0 indicates a very low probability of scoring and 1 indicates a very high probability. For example, a clear one-on-one chance with the goalkeeper might have a high xG value close to 1, while a long-range speculative shot might have a low xG value closer to 0. An xG value above 0.38 for a specific shot is considered a big chance. For example, a penalty has an average xG of 0.79 to be scored.

Keep in mind that the quality of a player is not accounted for. So, for expected goals, it does not matter if Lionel Messi is the one taking a shot or if the data scientist of Sportmonks takes the shot.

What is the pricing for the xG metrics add-on?

At Sportmonks, we use three types of packages: a basic package, a Standard package, and an Advanced package.

In the Basic package, xG per fixture will be available 12 hours post-match.

In the Standard package, xG per fixture and xG on Target per Fixture will be available straight after a match.

The xG advanced package will have all our xG metrics, including xG per Fixture, xG On Target, Non-Penalty xG, xG Open Play, xG Set Play, xG Corners, xG Free kick, xG Penalty, Expected Points, Expected Points Table, Expected Goals Conceded, Expected Goal difference, Over/Underperformance players, Over/Underperformance team, Expected Goals Saved. The Advanced package has all metrics live.

What leagues have xG available?

We have a list available in our documentation. Please keep in mind this list is not yet complete, as not all leagues that will have xG available is active.

Once leagues like the European Championship have played xG will also be available here.

What can I use xG Corner/Free Kick/Penalty for?

Of course, we offer xG Open Play and xG Set Play. But if you want to dive deeper into xG Set Play, the metrics xG Corner, xG Free Kick, and xG Penalty will come in handy.

These statistics have particular use cases. For example, in the 2023/2024 season, Arsenal scored many goals from set pieces. For some people, it might be very interesting to see if the XG Arsenal generates is higher than the XG for other title contenders (like Manchester City and Liverpool). At the moment of writing, they are only 1 point apart and are numbers one to three in the league standings. As you can imagine, the over- and underperformance of these teams from set pieces might have a small or big influence on the rest of the season.

It might be interesting to show which of the set pieces generates the most xG for certain teams and to find out if there are any differences. For one team, free kicks might be way more dangerous (maybe because they have a free-kick specialist), while others have a way higher xG from corners (maybe because they have two giants as centre-backs who join the attack when they have a corner).

As you can see, these use cases can be really interesting to get a better understanding of the tactics of specific teams and to find out if a late free kick or corner is actually as interesting as it seems when the whole stadium is cheering to support their team with this late chance to score.

Getting started

Where can I find all the available endpoints?

You can find all our endpoints with explanations on our well-described documentation pages. Please note that we also have a helpful Postman collection.

Where can I create an account?

You can create an account via our dedicated My Sportmonks platform. After you signed up, you will automatically be assigned to our free plan.

How can I create an API-token?

Once you’ve created your account, you can create your API token via the settings page on My Sportmonks. For security reasons, the API token will only be shown to you once when you create it. Please make sure to write down your API token somewhere safe.

How can I test the Sportmonks API for FREE?

You have two options:

  1. Create an account on My Sportmonks and get immediate access to our free plan.
  2. Subscribe to one of our paid plans and receive a one-time-only 14-day free trial.

General

How do I best receive updates from Sportmonks?

We are active on Facebook, LinkedIn, Instagram and Twitter. We also have a weekly newsletter for people who are subscribed to our email services.

Is there live chat support?

Unfortunately no, but who knows? We might implement this in the future.

For now, you can best contact us via email.

How do I contact you?

You can contact us via our support & contact page.

Alternatively, you can send a direct email to [email protected] for technical issues or to [email protected] for questions about plans and pricing.

How does the API work?

We have built a well-structured, flexible, and fast JSON API. Our API makes it easy to customize your JSON responses.

Our API’s flexibility demonstrates itself by allowing its users to build their own responses in the form of adding include parameters to their requests. This means you can request the data you need and leave out the data you don’t need.

Filtering and Sorting is another widely used and loved characteristic of our API. It means you can request the data the way you want it to, by adding the proper filtering and sorting commands. Please check our documentation pages for more information.

How many API calls do I get?

By default, you will have access to 2000 API calls per endpoint per hour.

If you feel this is not enough, you can upgrade this amount when selecting your plan.

Where can I create an account?

You can create an account via our dedicated My Sportmonks platform. After you signed up, you will automatically be assigned to our free plan.

What is an API-token?

Sportmonks makes use of API-tokens for authorization of our API. You are required to add the parameter ‘api_token’ to your API requests. The parameter’s value is the actual token you received when you created it in My Sportmonks.

Without this key, you cannot use our APIs.

What is the difference between subscribing on RapidAPI and Sportmonks?

You can subscribe to the Sportmonks Football API via RapidAPI or via My Sportmonks.

A subscription on RapidAPI means you have access to all available data features and all 1000+ Leagues, with the exception of the Prediction API. The plans on RapidAPI are categorized by the number of API calls included in your plan. On RapidAPI the API is called Football Pro.

On Sportmonks you get the exact same features, but you will have everything nicely put together in your My Sportmonks environment.

Why should I choose Sportmonks instead of other suppliers?

Unlike many other suppliers, we are an official football data supplier, providing high-quality football data at a reasonable price. Our global presence and highly dedicated scout teams ensure you will have the best football data available. Sportmonks has proven to be the go-to partner for long term success since 2016.

Many smaller competitors have suddenly disappeared in the past years. If you want to go for a long-term, sustainable partnership, Sportmonks is the right football data supplier for you.

Technical questions

How can I handle high traffic on my livescore website?

Ensure you have a robust hosting solution, use caching mechanisms, and optimize API requests to manage and sustain high traffic efficiently.

How do I build and filter API requests?

Use the base URL and include necessary data points like scores, events, and participants. Apply filters to refine the data to match specific criteria.

Here’s an example of how to incorporate the filter into your request:

https://api.sportmonks.com/v3/football/livescores/inplay?api_token=YOUR_TOKEN&include=events&filters=eventTypes:14,19,20,21

By utilising filtering capabilities, we can tailor the data retrieved from the API to match the specific needs and preferences of our livescore website. For further details on filtering techniques, refer to our dedicated filter tutorial for additional guidance.

What data should I show on my livescore website?

Common data includes match date and time, league details, teams, scores, and match events like goals and cards. But it’s totally up to your projects requirement.

What is a livescore website?

A livescore website provides real-time updates on football matches, including scores, match statistics, team lineups, and other essential information.

Are there any limitations or restrictions when using Sportmonks Football API with Postman?

Sportmonks Football API does not impose any specific limitations or restrictions on using Postman with the API. However, you should be mindful of your API usage limits based on your subscription plan. Additionally, ensure that you handle sensitive information such as API keys securely within Postman to prevent unauthorized access or misuse.

Can I save and share API requests in Postman for future use?

Yes, you can save API requests in Postman collections for future use and easily share them with team members or collaborators. Postman allows you to organize your requests into collections, add descriptions and documentation, and export collections as JSON files for sharing or version control purposes.

Do I need to sign up for an account to use Sportmonks Football API with Postman?

While signing up for an account on the MySportmonks platform is required to obtain API keys for accessing certain endpoints and features, you can still use Postman to test and interact with the API without signing up. However, you’ll need to sign up for an account and obtain API keys to access restricted endpoints or features.

Can I access all Sportmonks Football API endpoints using Postman?

Yes, you can access all Football API endpoints using Postman. The API provides a wide range of endpoints for accessing football-related data, including match fixtures, live scores, player statistics, team information, and more. You can use Postman to explore and interact with these endpoints to retrieve the data you need for your applications or projects. Visit our Postman Collection.

What is Postman, and how can I use it with Sportmonks Football API?

Postman is a popular API development environment that allows you to test, document, and interact with APIs more efficiently. You can use Postman to send HTTP requests to SportMonks Football API endpoints, view responses, and streamline API testing and development processes. This “How to use Sportmonks’ Football API” provides a step-by-step guide on how to set up Postman and make requests to the Football API.

Do I need prior experience with Python to use Sportmonks Football API?

While basic knowledge of Python programming is beneficial for working with the Football API, the blog provides detailed explanations and code examples to help developers of all skill levels integrate the API with Python. Familiarity with handling JSON data and making HTTP requests using Python’s requests library would be advantageous but not mandatory.

What types of data can I access through Sportmonks Football API using Python?

Our Football API offers a vast array of football-related data you can access using Python, including match fixtures, live scores, player statistics, team information, standings, and more. You can retrieve data for current matches, upcoming fixtures, and historical data for past matches, leagues, and tournaments. Head over to our coverage page for all the available leagues and data features.

How do I get started with Sportmonks Football API in Python?

To begin utilizing the Football API with Python, you’ll first need to sign up for an account on MySportmonks to obtain your API token. Once you have your tokens, you can use Python’s requests library to request HTTP to the Football API endpoints. The how-to guide provides a comprehensive guide on authentication, making API calls, handling responses, and error handling in Python.

Is there a limit to the number of API requests I can make?

We offers different subscription plans with varying levels of access and usage limits. While the Free plan has certain restrictions on the number of API requests allowed per day, higher-tier plans offer increased usage (3,000 API calls per entity per hour) allowances and additional features. If you require more API requests than your current plan allows, you can consider upgrading to a higher-tier plan or contacting support for customised solutions tailored to your needs.

Can I customise the data retrieved from Sportmonks Football API?

Yes, you can customise the data retrieved from the Football API to suit your specific requirements. The API allows you to filter data based on various parameters, such as date, team, player, league, and more. Additionally, you can specify which fields you want to include or exclude in the API responses to minimize bandwidth usage and optimize performance. Check our documentation for more information.

Do I need any special knowledge or skills to integrate the API with PHP?

While basic knowledge of PHP programming is essential for integrating the API with PHP, the how-to guide provides detailed instructions and code examples to guide you through the integration process. Familiarity with handling JSON data and making HTTP requests using PHP’s cURL or Guzzle library would be beneficial but not mandatory.

How can I integrate Sportmonks Football API with PHP?

To integrate Sportmonks Football API with PHP, you’ll need to sign up for an account on MySportmonks platform to obtain your API token. Once you have your token, you can use PHP’s cURL or Guzzle HTTP client to make HTTP requests to the API endpoints. The How-to guide provides a comprehensive guide on how to authenticate your requests, make various types of API calls, and handle the responses in PHP.

The livescores endpoint doesn’t show any livescores

We often receive this complaint that the livescores endpoint doesn’t function.
It’s often the case that you’re currently requesting livescores for a match that isn’t live yet.
In such scenarios, the livescore endpoint returns nothing back.

Head to our tutorials if you need more technical guidance.

If this is not the case for your issue, please contact our support team.

When will my subscription be active?

After you’ve subscribed to a plan, it will take a maximum of 15 minutes before your new data is visible.

What happens if I hit the rate limit?

Once you’ve hit the rate limit, you will receive a 429 response. The rate limit kicks in after the first request has been made. The rate limit will be set to 0 when an hour has passed.

For example: If you make the first of X requests at 18:18 UTC it will be reset at 19:18. Information about the current number of calls, as well as the reset time, can be found in the responses meta section.

Where can I find all the available endpoints?

You can find all our endpoints with explanations on our well-described documentation pages. Please note that we also have a helpful Postman collection.

How does the API work?

We have built a well-structured, flexible, and fast JSON API. Our API makes it easy to customize your JSON responses.

Our API’s flexibility demonstrates itself by allowing its users to build their own responses in the form of adding include parameters to their requests. This means you can request the data you need and leave out the data you don’t need.

Filtering and Sorting is another widely used and loved characteristic of our API. It means you can request the data the way you want it to, by adding the proper filtering and sorting commands. Please check our documentation pages for more information.

Do I need to change tokens when I switch to another plan?

No, you can stick to the same token you used beforehand.

Is my token valid for all sports?

Yes, you can use the same token for multiple sports.

How long is my token valid?

Each token is valid until manually removed by yourself from your My Sportmonks account.

Can I make multiple tokens?

You can make as many tokens as you want. Each token is valid until deleted.

Where can I find my API-tokens?

You can view all the tokens you’ve created in your account settings on My Sportmonks. Here you can manage and delete api-tokens.

What is an API-token?

Sportmonks makes use of API-tokens for authorization of our API. You are required to add the parameter ‘api_token’ to your API requests. The parameter’s value is the actual token you received when you created it in My Sportmonks.

Without this key, you cannot use our APIs.

How can I create an API-token?

Once you’ve created your account, you can create your API token via the settings page on My Sportmonks. For security reasons, the API token will only be shown to you once when you create it. Please make sure to write down your API token somewhere safe.

Pricing and plans

What data can I access through Sportmonks Football API?

The Football API offers a wide range of football-related data, including match fixtures, live scores, player statistics, team information, standings, and more. You can retrieve data for current and upcoming matches, as well as historical data for past matches, tournaments, and leagues. Please visit our coverage page for an overview of all leagues and features.

Where can I find an overview of the leagues?

You can download the full overview of all our leagues on our Google Docs.
Or you can visit our coverage page.

Which data features are included in the advanced package?

In the advanced data feature package, you will have access to all the features in the standard and basic packages. Furthermore, you will have access to live odds, trends, and live standings.

For a full overview of all our data features and more information, you can refer to our coverage page.

 

Which features are included in the standard package?

In the standard data feature package, you will have access to all the features in the basic package. Furthermore, you will have access to statistics, head2head, team squads, and much more.

For a full overview of all our data features and more information, you can refer to our coverage page.

 

Which features are included in the basic package?

In the basic data feature package, you will have access to livescores, events, standings, historical data, and much more.

For a full overview of all our data features and more information, you can refer to our coverage page. 

 

What is included in the Enterprise package?

Our Enterprise package offers you:

  • All the leagues we have
  • Personal support from one of our support members
  • All data features
  • Some add-ons

Contact our sales team for more information. A personal sales representative will be happy to help you.

Which leagues are included in the World plan?

You will have access to all the leagues in the Euro Plan + some other major leagues like the Brazilian Serie A, MLS, Copa Liga MX, Copa Libertadores, and much more. Putting the total on a 100+ leagues worldwide.

For a full overview of all the covered leagues of the World plan, please refer to its plan page.

 

Which leagues are included in the Euro plan?

You will have access to the English Premier League, Bundesliga, Italian Serie A, La Liga Santander, French Ligue 1, Dutch Eredivisie, UEFA Champions and Europa League, and 20 more leagues.

For a full overview of all covered leagues, you can head to the Euro plan page.

 

Do you offer yearly plans?

Yes, we offer yearly plans. Yearly plans are discounted compared to monthly plans.

When will my subscription be active?

After you’ve subscribed to a plan, it will take a maximum of 15 minutes before your new data is visible.

Can I add multiple sports?

Yes, you can select multiple plans to create one subscription.

Which payment methods are supported?

As of now, we only accept credit card and PayPal as valid payment methods.

How does the billing cycle work?

If your subscription is still active after the free trial period, a recurring billing cycle will commence for the amount you have agreed to. A billing period lasts 1 month and is paid upfront.

Is it possible to increase the number of API calls?

Yes this is possible. We offer an increased number of API calls for an extra tariff.

Please contact us if you would like to increase the number of API calls.

Which leagues are included in my plan?

For Formula 1, all 21 races are included.

For Football and Cricket you can go to their respective pages and click on the different plans.
Football has the Euro, World and Enterprise plans, while Cricket has the Major, World and Enterprise plans.

Go to the plan you’re interested in and you will be re-directed to the chosen plan page, which will show you all the included leagues as well.

How does the 14-day free trial work?

Once subscribed to one of our plans you will automatically receive the 14-day free trial. After 14 days, your credit card will be charged, unless you choose to cancel your subscription in time. You’re only permitted to have one free trial.

How can I request a custom plan?

There are two options for requesting a custom plan.

  1. You can email our sales team with the requirements of a plan. They will get you sorted with your request for a custom plan!
  2. You can go to my.sportmonks.com and create a custom plan yourself. Choose the leagues and data features you like and request a price. Our team will come back to you as soon as possible.

 

Terms of service

Can I use player images/club logos?

All logo’s and profile photos are copyrighted by their legal owner.
To display these types of content in your app or website you have to arrange the proof of intellectual property yourself.

What is your Service Level Agreement (SLA)?

Our approach is to put as much effort as possible to keep our API available and have real-time updates as fast as possible. The speed of our livescores is very fast compared to competitors, so it is definitely one of our competitive advantages.

Moreover, our we have incredibly high server uptime. There’s little chance of you experiencing much downtime.
Use our product for a few months and you will see for yourself.

Do note that, our company does not work with SLA’s and guarantees on uptime.

Prediction API

What is the endpoint to get the all the predictions with the team names?

The best way to do this would be to call the “All Predictions” endpoint and then use the fixture.participants include. This retrieves all the predictions with their corresponding fixtures and teams.

Are there any previous statistics about the prediction’s performance?

You can retrieve statistics on prediction performance by using the “GET Performance by League ID” endpoint, which provides information about the prediction model’s performance for a specific league.

Is the prediction also available for other sports on your API?

The prediction is only available on the Football API at the moment.

Can I subscribe to only the predictions?

The Prediction API is an add-on that can be added to your subscription. It is not possible to subscribe to the prediction API add-on. You must always subscribe to a plan and add the Prediction API to your football plan.

What is the average success rate of the predictions?

Our advanced machine learning model accurately predicts football match outcomes by analysing historical data, including team form, player injuries, and head-to-head records. Additionally, our player contribution model enhances prediction accuracy by analszing individual player performance, recent form, position, and impact on the team. With our predictions API, you can access various markets such as match-winner, double chance, and total goals.

What models do you use?

Our prediction API has two key models:

1. Prediction model:


Using advanced machine learning techniques and historical data, our model accurately predicts the outcomes of future football matches, considering various factors such as team form, player injuries, head-to-head records, and more. In addition to that, we also incorporate the player contribution model, which further enhances the accuracy of the predictions. By analysing the performance of individual players and their impact on the team, we can better understand how they’ll contribute to the match’s final outcome. This model takes into account various metrics such as the player’s recent form, their position, and their contribution to the team’s overall performance

2. Value bet model:

The Value Bet model processes thousands of historical odds data and market trends to find the best value opportunities. In other words: it compares bookmakers’ odds with each other and then gives you the best value bookmaker. Using our value bet model, you can access valuable insights into the best bets, which can help you make better decisions.

The models and algorithms are based on five key principles:

1. Timely and substantive:
The prediction API is updated daily with the latest data from the Sportmonks Football Database.

2. Data controlled:
No human intervention is needed. The prediction API runs on statistical analysis results based on the entire historical Sportmonks Football Database.

3. Precise probabilities:
The prediction API offers the most precise probabilities possible, thanks to our mathematical probability distribution models.

4. Predictability performance:
We monitor our prediction API’s success rate and quality, but you can also track our predictions’ performance.

5. Machine Learning:
We use cross-validation machine learning models.

Why should I use the Predictions?

Football prediction sites have become increasingly popular in recent years as more and more people turn to online resources for insights into their favourite football teams and matches. Using advanced machine learning techniques and historical data, our Prediction API accurately predicts the outcomes of future football matches, considering various factors such as team form, player injuries, head-to-head records, and more. We also incorporate the player contribution model, which further enhances the accuracy of the predictions.

With our Predictions API, you’ll have access to a vast range of markets, including match-winner, double chance, total goals, and beyond. We’re constantly improving our model, adding new features to ensure you have access to the most accurate and up-to-date predictions possible. The Prediction API is a valuable asset to any football prediction website, providing accurate predictions for future matches based on advanced machine-learning techniques and historical data.

How to get the best probabilities out there?

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

An overview of all the options to request predictions:

  • GET Probabilities: returns all probabilities available within your subscription.
  • GET Performance by League ID: returns the performances of our Predictions Model for your requested league ID.
  • GET Probabilities by Fixture ID: returns all the predictions available for your requested fixture ID.

Check our docs for more info.

What is the quality of the predictions?

At Sportmonks, we believe that transparency on the predictions and models used results in a better understanding, more sympathy and a greater product. That’s why we’ve introduced the league predictability.

We provide access to our prediction history and performance metrics, allowing you to see the accuracy of our model over time. We are committed to continually monitoring and refining our model to remain accurate and up-to-date.

We understand the importance of trust when making informed betting decisions. With our transparent approach, you can be confident in our predictions’ accuracy and easily make informed decisions.

News API

I am currently subscribed to your API, how can I add a News API plan to my subscription?

You can get access to these articles by going to my.sportmonks.com and go to the ‘edit my subscription’ environment to add the News API plans to your subscription.

Another way to get access to these articles is by contacting our sales team at our contact page or by mailing [email protected].

 

How can I get access to these football news articles?

First of all, you need to be subscribed to one of our Football API plans with a News API add-on of your choice. After that you can make a request to our API. To access pre-match news, you can use the prematchNews.lines include. For post-match news, you can use the postmatchNews.lines. For more information, you can navigate to our documentation.

What is a Football News API?

A football news API allows developers and enthusiasts to access and retrieve up-to-date football news articles and headlines via our Football API. This API grants users the ability to integrate real-time football news content into their applications, websites, or platforms seamlessly.

How can I use the API to get the News articles I need?

When making an API request you will receive the data in JSON format. There are two ways to request the news in our API.

  1. You can use the News API endpoint.
  2. You can use the Fixture endpoint and use the include ‘prematchNews.lines’ or ‘postmatchNews.lines’.
  3. You can use the Livescore endpoint and use the include ‘prematchNews.lines’ or ‘postmatchNews.lines’.

Our News API is combined with our Football API. So make sure you are subscribed to a Football plan.

 

How are the articles in the News API written?

The match previews are written by Sportmonks’ data experts and scouts. Our post-match articles are AI written in collaboration with United Robots, a renowned AI news provider. The articles are based on match results, statistics, goals, injuries, and other important events. With our reliable and up-to-date football data, you can provide your users with instant updates after the final whistle.

What is covered in the Football News API?

What is covered in the pre-match news API?

The Football News API offers comprehensive coverage across various leagues, providing users with a wide range of football-related content. The Top News Plan and Full News Plan are priced per single league, offering in-depth coverage tailored to specific leagues such as the UEFA Champions League, English Premier League, Bundesliga, La Liga, Serie A, and Ligue 1.

The All-In News Plan encompasses all six leagues for users seeking broader coverage. This plan includes detailed updates on matches from the UEFA Champions League and English Premier League and coverage of the top five teams from the previous season in the Bundesliga, Serie A, La Liga, and Ligue 1. With this plan, users gain access to comprehensive news and insights spanning across multiple leagues, ensuring they stay informed about the latest developments in football across Europe.

What is covered in the post-match news API?

Our Football post-match News API meticulously covers post-match analysis for Premier League, Serie A, La Liga, Eredivisie, and Champions League matches. On top of that, we also offer post-match football news for the EUROs. The articles are based on match results, statistics, goals, injuries, and other important events. With our reliable and up-to-date football data, you can provide your users with instant updates after the final whistle.

What happens when the top 5 in the leagues are playing against each other?

When two teams in the top 5 are playing against each other we will add another matchup. For example, the numbers 1 and 2 are playing each other.

We will add the matchup of the team that is number six at the start of that round.

This will only happen in the Bundesliga, La Liga, Serie A and Ligue 1. The News API will have 20 articles available per month if that month includes 4 rounds of the competition.

Odds

How often are the Premium odds updated?

Our pre-match odds are updated around every 1 minute. Meaning (worst-case scenario) it can take up to 2 minutes before a change on the bookmakers’ site is available in our API feed.

Which markets are available in the Premium Odds Feed?

To access the comprehensive list of markets included in our Premium Odds Feed, kindly navigate to the following link:

Premium Odds Feed – Markets

This link will provide detailed information regarding the markets available, including their market ID, ensuring transparency and accessibility to our valued users.

Please do not hesitate to reach out if you require further assistance or have any additional inquiries.

Do you offer winning odds?

We are happy to provide you with more information about our winning odds.

Winning odds are calculated automatically during or after a match. Winning odds determine whether an odd has ‘won’ or not. For example, if the market for an odd was over 2.5 goals and there were 3 goals in that match, the odd will be set to “winning”: “true”. If there were less than 3 goals in that match, the odd will be set to “winning”: “false”.

Please note that not all markets we cover have winning odds calculations. Every market has a flag marking whether you can expect winning odds for it. You can check the markets here:

Do you offer historical odds?

Our API provides a history of odds for fixtures for up to 7 days after kick-off (starting_at). Additionally, we offer the history of changes of each odd. We document the opening odds for each fixture; subsequently, all changes and updates are stored and accessible for your use.

What is the difference between the Standard and Premium Odds Feed?

We would happily explain the difference between our Standard and Premium Odds feeds.

First, our Premium Odds feed is developed in partnership with TXOdds, a highly reputable odds provider known for its exceptional data reliability. The Premium Odds feed offers an extensive selection of 42 markets from 145+ different bookmakers, which you can review here.

Additionally, we meticulously document the opening odds for each fixture, and all subsequent changes and updates are recorded and made accessible for your use. This functionality enables you to track the evolution of each odd and effectively present these changes to your customers.

Which bookmakers are available in the Premium Odds Feed?

To access the comprehensive list of bookmakers included in our Premium Odds Feed, kindly navigate to the following link:

Premium Odds Feed – Bookmakers

This link will provide detailed information regarding the bookmakers available, including their bookmaker ID, ensuring transparency and accessibility to our valued users.

Please do not hesitate to reach out if you require further assistance or have any additional inquiries.

 

How to get the lastest odds available?

The best way to achieve this is to request the “odds/pre-match/latest” endpoint every 5 seconds. This way, you only get the odds as close as real-time. The endpoint itself returns odds that were updated within 10 seconds. So, if you request the endpoint every 10 seconds, you may miss some values because making a request also takes some time (can take around ±1 second). Within that second, you are prone to missing updates.

How often are the odds updated?

Our pre-match odds are updated around every 10 minutes. Meaning (worst-case scenario) it can take up to 20 minutes before a change on the bookmakers’ site is available in our API feed. Our inplayOdds refresh every second, so that should be pretty much instant.

Widgets

Do I need an API token for the Football Widgets to work?

Maintenance is done by our developers, and the widgets will request our API every time it is needed. Therefore, no API token is required.

How do the Football widgets look and feel?

You can preview all widgets on my.sportmonks.com. Next to that, you can find how to set up your widgets on our Documentation.

How to start implementing the Football Widgets?
To get started, if you’re interested in any of our widgets, you can easily request them by heading to My.Sportmonks. If you haven’t created an account yet, you’ll need to do so first. Once you’re signed up, navigate to the My Widgets page under Football Widgets in mySportmonks. This page provides an overview of all available widgets; you can manage them from here.
Here, you can easily request the widgets you’re interested in.

Option 1: Opt for a default widget package
We’ve created default widget packages: European Widgets, WorldWide Widgets and Enterprise Widgets. The packages are based on the default API plans, meaning they have the same leagues available.

Option 2: Choose a custom widget subscription
Besides the default packages, you can create custom widget subscriptions. There is an option to select their preferred widgets, data features and leagues.

Option 3: A default widget package and a custom widget subscription
There is also an option to combine options 1 and 2. Meaning that you can subscribe to a default and custom widget package.

Please follow our detailed guide: “How-to create your widget in three steps“, guide for more information about selecting and integrating your football widget.

Can I try the Football Widgets for free?

Yes, if you are a first-time customer, you can use the 14-day trial to try the Football Widgets.

API 3.0

Can I keep my current API token?

You can use the same API token as you are currently using for API 2.0. You don’t need to create another token for API 3.0.

What is the date Sportmonks stops supporting API 2.0?

API 2.0 is deprecated but will remain working. Sportmonks will keep monitoring and validating API 2.0 till at least mid-2024. All the new features and improved data quality are only available in API 3.0. Therefore, we do recommend integrating the new API as soon as possible.

Is API 3.0 better than API 2.0?

Yes! Our developers made a lot of improvements. We have new features, new endpoints, a better data quality and more. Multiple customers have helped us during the testing phase of our Beta version. With your help, we have ensured a high level of data quality.

Where do I find the differences between API 2.0 and API 3.0?

We have written new documentation pages and a blog to help you get started and find your way into API 3.0.

Copa America

Does the Football API provide historical data for previous Copa America tournaments?

Yes, the Sportmonks Football API provides access to historical data for previous Copa America tournaments, including match results, player statistics, and more.

Are there any restrictions on the usage of Copa America data for commercial purposes?

You are free to use Copa America data for commercial purposes as long as they comply with the terms of service and licensing agreements provided by Sportmonks.

Can I access real-time data during Copa America matches using the API?

Yes, you can access real-time data during Copa America matches using the Sportmonks Football API. The API provides live match updates, including scores, events, and other relevant information.

Are there any specific endpoints or parameters for accessing Copa America data?

Yes, the Sportmonks Football API offers specific endpoints and parameters for accessing Copa America data, allowing users to retrieve match information, player statistics, team data, and more.

Can I retrieve detailed player statistics for Copa America matches through the API?

Yes, you can retrieve detailed player statistics for Copa America matches through the Sportmonks Football API. This includes information such as goals, assists, yellow cards, red cards, and more.

European Championship

Can I retrieve detailed player statistics for European Championship matches through the API?

Yes, you can retrieve detailed player statistics for European Championship matches through the Sportmonks Football API. This includes information such as goals, assists, yellow cards, red cards, and more.

Are there any specific endpoints or parameters for accessing European Championship data?

Yes, the Sportmonks Football API offers specific endpoints and parameters for accessing European Championship data, allowing users to retrieve match information, player statistics, team data, and more.

Can I access real-time data during European Championship matches using the API?

Yes, you can access real-time data during European Championship matches using the Sportmonks Football API. The API provides live match updates, including scores, events, and other relevant information.

Are there any restrictions on the usage of European Championship data for commercial purposes?

Users are free to use European Championship data for commercial purposes as long as they comply with the terms of service and licensing agreements provided by Sportmonks.

Does the Football API provide historical data for previous Euro tournaments?

Yes, the Sportmonks Football API provides access to historical data for previous Euro tournaments, including match results, player statistics, and more.

World Cup

How can I subscribe to the World Cup?

Contact our Sales Team and retrieve a personal offer or subscribe to the World Cup in My.Sportmonks.com. The World Cup is currently available as a special.

About Sportmonks

How can I leave a review?

Do you like our services so much that you want to write a review about us?

Simply email our Sportmonks Team, and they will get back to you with more details.

Where are you located?

Sportmonks is a Dutch company, with two locations in the Netherlands.

How do we collect our data?

At Sportmonks, we manage all our data in the Sportmonks Scout Application Platform (SSAP). Our dedicated scout teams from all over the world add, manage and validate the data collected by this platform. We work together with high-class data partners to ensure our football data is reliable and always up to date.

Who are we?

Sportmonks is a sports data provider, founded in 2016, primarily doing business in football, cricket and formula 1. We work with APIs to provide you the best possible data for an affordable price.

Why should I choose Sportmonks instead of other suppliers?

Unlike many other suppliers, we are an official football data supplier, providing high-quality football data at a reasonable price. Our global presence and highly dedicated scout teams ensure you will have the best football data available. Sportmonks has proven to be the go-to partner for long term success since 2016.

Many smaller competitors have suddenly disappeared in the past years. If you want to go for a long-term, sustainable partnership, Sportmonks is the right football data supplier for you.

Sales/discounts on products

Do you offer any discounts?

Yes, we do! In fact, we often host special events where you can win discounts on your plan. Sometimes we also give out free discounts, like with our Black Friday 2 Friday event.

Follow us on social media and subscribe to our newsletter to get the latest news about any discounts.

How many discount coupons can I use?

You are only allowed to use one discount coupon at a time. The stacking of coupons does not work.