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.

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 support@sportmonks.com for technical issues or to sales@sportmonks.com 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

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 response 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

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.

 

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 support@sportmonks.com.

 

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. The News API should always be combined with the Football API.

You can get access to these plans and the News articles by contacting our sales team at our contact page or by mailing support@sportmonks.com.

Another way is to go to my.sportmonks.com and go to the ‘edit my subscription’ environment to add the News API plans to your subscription.

 

What is a Football News API?

In Sportmonks’ Football News API, six of the European top Football Leagues are included. These Leagues are the English Premier League, UEFA Champions League, Bundesliga, La Liga, Serie A and Ligue 1.

With the News API you can request preview news articles for the matches included in your subscription. Our Football News API is sold as an exclusive add-on for our football plans.

Here you can find an example of an article of the EURO2020 final.

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

When making an API request you will receive the data om 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 ‘news’
  3. You can use the Livescore endpoint and use the include ‘news’

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

 

Are the articles handwritten or created via Robots?

The match previews are written by Sportmonks’ data experts and scouts.

Robots are not used in the process.

How are the articles in the News API written?

The match previews are written by Sportmonks’ data experts and scouts.

What do the prices per plan mean?

The prices of the plans ‘Top News Plan’ and ‘Full News Plan’  are prices per single league.

The price of the ‘All-In News Plan’ is the price for a plan with all six leagues included. This plan gives you the coverage for all matches of the Champions League and Premier League and the top 5 of the Bundesliga, Serie A, La Liga and Ligue 1.

  1. UEFA Champions League: All teams.
  2. English Premier League: All teams.
  3. Bundesliga: Bayern Munich, Red Bull Leipzig, Borussia Dortmund, Bayer Leverkusen and Wolfsburg.
  4. La Liga: Atletico Madrid, Real Madrid, Barcelona,  Sevilla and Villareal.
  5. Serie A: Juventus, AC Milan, Internazionale, Napoli and AS Roma.
  6. Ligue 1: PSG, Olympique Lyon, Lille, AS Monaco and Olympique Marseille.

Remember, we offer a discount off for 1 year if you subscribe before August 29th.

Can I combine multiple leagues from different plans?

Yes, you can combine leagues from the ‘Top News plan’ and the ‘Full News plan’ to your liking.

Do not forget that the ‘All-in News plan’ is there for all leagues.

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.

Live Score Widget

Wat is the difference between the Free and Pro version?

The free widget has the following functions:

  • Select a default theme (light/dark)
  • Show/hide the theme switch
  • Show/hide team/ league logos and player images

The Pro version has the same functions and the following extra functions:

  • Change the colors to fit it in your corporate identity
  • Change the logo in the footer
  • Select and show only your favorite leagues
Do I need another API token for the Widget to work?

No, the API token that is generated with your football subscription will be used for the Live Score Widget as well.

What happens to my API Calls when using the widget?

By default, our plans have a rate limit of 2.000 API Calls per endpoint per hour. However, it is always possible to get a plan with more API calls. You can expand your API calls by adding an add-on to your subscription or by emailing Sportmonks’ team of support. The API requests are not made per page visitor. This means there is no difference in the number of API calls being made when the Livescore Widget has only one-page visitors or over a hundred-page visitors.

How does the Livescore widget look and feel?

Well, you can find a previews and a live examples at the following places:

In our Documentation you can find how to set up your widget.

Also, we have created a Livescore Product Tour for you to find out how the differnt functionalities look.

Last but not least, we have set up a Live example of the widget in My.Sportmonks. Please visit the Live Widget example to find out how the Livescore Widget looks, works and feels.

How to start implementing the Livescore Widget?

You can create an account via our dedicated My Sportmonks platform. Choose or create a plan and make sure you activate the widget in your plan.

If you already have a subscription:

  1. Add the widget to your subscription
  2. Set your domain
  3. Configure your widget
  4. Copy-paste your embed code into your app or website

Do you need a little more information to find out how you can set up your Football Widget? You can find all information on our documentation pages.

Can I try the Livescore Widget for free?

Even better, Sportmonks’ Live Score Widget is free of charge.

However, there is a Pro version with even more functions. For example, you can:

  1. Change the primary, secondary and tertiary colors
  2. Change Sportmonks’ logo into your own logo
  3. Customize leagues

Please do keep in mind you an active football subscription.

World Cup

How can I subscribe to the World Cup?

At the moment we do have a special early bird discount!

Contact our Sales Team and retrieve a personal offer.

About Sportmonks

How can I leave a review?

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

Simple email our Sportmonks Team and they will get back 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.

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.

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.