API 3.0

Why did we create API 3.0?

In order to accommodate our growing customer base and provide more sports-related services, we introduced a new APIโ€”Sportmonks 3โ€”to the market. We tried our best to keep elements of the previous APIโ€”API 2โ€”but some endpoints proved difficult to maintain. For more information on the transition to API 3, please head to this documentation page.

How long will API 2.0 remain active?

We understand the impact of these changes and want to make the transition as easy as possible for our current users. Therefore, access to API 2.0 will remain available until at least mid-2024.

Our API 2.0 still runs and will be gradually phased out. We will send out a clear notification about when we will stop supporting API 2.0 to allow you ample time for integration.

We strongly recommend that you integrate the new version of our Football API to benefit from the various new features and improved data quality. Future innovations will only appear on API 3.0, so we recommend making the switch as soon as possible.

How does the historical data compare to API 2.0?

We've successfully transitioned all the data from API 2.0 to 3.0. However, as we transitioned to API 3.0, we faced the challenge of handling large volumes of data without overwhelming our servers. While we've successfully transferred all data to API 3.0, some minor gaps may exist in statistical values. Please rest assured, we're actively addressing this issue to ensure a seamless experience.

Where have the 'localTeam' and 'visitorTeam' includes gone?

The data model for API 3 is ready to support a wide range of sports in addition to football, which differs from API 2. As a result, the "localTeam" and "visitorTeam" includes are no longer offered. Instead, all available teams can be seen by adding the new "participants" include as a nested include to the fixtures.

How do the API calls work compared to API 2.0?

For API 2.0, each plan has 2000 API calls per endpoint per hour. The rate limit starts counting when you make the first of X requests. 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 can be found in the response meta section.

For API 3.0, every default plan has 3000 API calls per entity per hour. For example, the teams entity is used in multiple teams endpoints. This means that all the requests made from the team endpoints count for the same entity: teams. The rate starts counting after the first request has been made. The rate limit will reset back to your original amount after an hour. Information about the usage is shown in our API 3 metrics dashboard or can be received at the following endpoint: Get My Usage.

Why do I have access to fewer players than I did in API 2.0?

Due to the limitations of the data model, authentication was set up differently in API 2.0, resulting in a costly update process. In response to this, API 3.0 has been completely revamped to be much more efficient.

With API 3.0, you can now access players who have actually played for a team according to your plan. This is far preferable to API 2.0, which included many inactive or duplicate/non-existing players, inflating the total number of available players.

Overall, this problem has been successfully resolved in API 3.0, making the experience much better and resulting in far fewer players being available.

What Predictions are available in API 3.0?

In API 3.0, we offer the following predictions:

  • Over/Under 2.5 Probability

  • Home Over/Under 0.5 Probability

  • Both Teams To Score Probability

  • First Half Winner Probability

  • Away Over/Under 0.5 Probability

  • Half Time/Full Time Probability

  • Double Chance Probability

  • Over/Under 3.5 Probability

  • Home Over/Under 1.5 Probability

  • Away Over/Under 2.5 Probability

  • Away Over/Under 2.5 Probability

  • Over/Under 2.5 Probability

  • Fulltime Result Probability

  • Correct Score Probability

  • Team To Score First Probability

  • Over/Under 1.5 Probability

What is the difference between the Standard and Advanced Statistics package?

We proudly tell you we cover more than 100 statistics due to our new API 3.0. The number of statistics made it necessary to distribute them over our standard and advanced statistics packages. If you want to get access to all available statistics, you can opt for our advanced statistics package. But maybe our standard statistics package suits you more if you don't need access to all available statistics. It's up to you! A list is created to display which stats are included in the standard and advanced packages so you can opt for the statistics youโ€™re interested in while choosing your plan. You can find this list on our data features page or here.

Last updated