Live now!

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

Premier League API

How long does it take to integrate?

Most developers have their first Premier League fixture response rendering in their app within an hour of signing up. Our developers created a Postman collection and intuitive docs to get you up to speed quickly.

Which other English leagues are covered alongside the Premier League?

100+ English competitions are covered, including the EFL Championship, League One, League Two, FA Cup, EFL Cup, Community Shield, FA Trophy, and Women’s Super League (WSL). All accessible from the same API token you can create in MySportmonks.

What’s the difference between Expected Goals and Expected Points?

xG measures the quality of scoring chances in a single match. Expected Points (xPts) takes cumulative xG over a season and converts it into the points a team “should have” earned. Comparing real points vs xPts reveals which clubs are overperforming the table (luck, finishing) and which are underperforming (bad luck, profligacy). Both are available in the xG Data add-on.

Is the Premier League included in the Free plan?

The Free plan covers the Danish Superliga and Scottish Premiership only. To access the Premier League, start a 14-day free trial of any paid plan. No credit card up front; cancel any time before day 14 and you’ll never be invoiced.

How is Premier League xG calculated?

Our xG model is trained on millions of historical shots and their outcomes. For each shot it considers location, type of attempt, angle to goal, goalkeeper position, defenders between ball and goal, and distance. xG is available as a match and player level. See the xG section above for live Premier League examples.

Does the Premier League API include historical seasons?

Yes. Historical fixtures, standings, top scorers, squads, and (where applicable) xG are available for every Premier League season we’ve covered. Use the seasons endpoint to enumerate, then filter the fixtures or standings endpoint by season_id.

What is Arsenal’s team ID in the Sportmonks Premier League API?

Arsenal’s team ID is 19. Query it with GET /v3/football/teams/19. All 20 current Premier League team IDs are listed in the team table above. Team IDs are stable across seasons.

Süper Lig

Is there a free trial for the Süper Lig API?

Yes. Every paid plan includes a 14-day free trial with full access to live data, historical seasons, xG, and predictions. A credit card is required to activate the trial. You can cancel at any time before the trial ends and you will not be charged.

To get started, sign up at MySportmonks pick the plan that fits your project, and your first Süper Lig fixture call can be returning real data in under 15 minutes.

What does the Süper Lig API cost?

Plans start at €29/month (Starter, 5 leagues), €99/month (Growth), and €249/month (Pro). Enterprise plans with 2,300+ competitions and custom limits are available on request. Süper Lig access is included in every paid plan. Every paid plan also includes a 14-day free trial, after which you choose whether to continue.

Full pricing tiers, request-rate limits, and add-on pricing for Predictions and Odds are on the plans & pricing page.

Which Süper Lig stats are available?

The Süper Lig API covers a wide range of fixture and player statistics, including xG (Expected Goals), xGoT (Expected Goals on Target), shots on and off target, possession, passes and pass accuracy, tackles, duels, and cards. At the competition level, Expected Points (xPTS) let you build alternative tables alongside the official standings.

Predictions data, including match-win probabilities, both-teams-to-score, over/under goals, and correct-score forecasts, are also available. See Sportmonks Predictions for the full feature set.

How far back does Süper Lig historical data go?

The Süper Lig was founded in 1959, and Sportmonks provides deep historical coverage of the competition. The most recent seasons carry the richest detail, including lineups, match events, per-player statistics, xG, and standings. Earlier seasons carry result and scorer data. Use the seasons endpoint to see exactly which seasons are available before you build.

Does the Süper Lig API include live scores?

Yes. Live scores for every Süper Lig match are available through the livescores endpoint. The API is polling-based REST, so your application requests the latest data at the interval that suits your product — typically every few seconds for a live score widget. Goals, cards, substitutions, and other match events appear promptly after they occur.

Uptime sits at 99.99% across the football product, monitored from independent regions, so your users see a reliable feed whether they are watching a Galatasaray derby or a mid-table fixture on a Tuesday night.

Eredivisie API

Which other Dutch competitions are covered alongside the Eredivisie?

Dutch football is covered beyond the top flight, including the Eerste Divisie (Keuken Kampioen Divisie), the KNVB Cup, and the Johan Cruyff Shield. All are accessible from the same API token under a plan that includes the relevant leagues.

How do I get live Eredivisie scores and in-play updates?

Sportmonks is a polling-based REST API. Poll the Livescore endpoint every few seconds during a match to pull the latest score, events (goals, cards, substitutions) and fixture state. Each response returns the full fixture object, so a single call keeps your match centre current. See the docs for the live endpoint and the full event taxonomy.

What does the Eredivisie API cost, and is there a free trial?

Plans start at €29/month (Starter, 5 leagues). Growth is €99/month, Pro is €249/month, and Enterprise is a custom quote covering all 2,300+ competitions. Every paid plan includes a 14-day free trial. A credit card is required to activate the trial, and you can cancel any time during the trial without being charged.

How long does it take to integrate?

Most developers have their first Eredivisie fixture response rendering in their app within an hour of signing up. The API ships with code samples in 6 languages, a Postman collection, and an OpenAPI spec. Free-plan testing means you can wire end-to-end before deciding on a paid plan.

Does the Eredivisie API include historical seasons?

Yes. Historical fixtures, standings, top scorers, squads, and (where applicable) xG are available for every Eredivisie season we’ve covered. Use the seasons endpoint to enumerate, then filter the fixtures or standings endpoint by season_id. Season ID 25597 covers 2025/26.

What is Ajax’s team ID in the Sportmonks Eredivisie API

Ajax’s team ID is 629, Feyenoord’s is 73 and PSV’s is 682. Query Ajax with GET /v3/football/teams/629. All 18 current Eredivisie team IDs are listed in the team table above and can be found in my.sportmonks’ ID Finder. Team IDs are stable across seasons.

Conference League API

Which other UEFA competitions are covered alongside the Conference League?

UEFA club football is covered end to end, including the UEFA Champions League, the UEFA Europa League, UEFA Super Cup, and the qualifying rounds for all three competitions. All accessible from the same API token under your paid plan.

Which Conference League stats are available (xG, shots, possession)?

Every league-phase and knockout fixture comes with a deep statistics object, ball possession, shots (total, on target, off target, blocked), corners, fouls, cards, passes, tackles, saves, and more. Expected Goals (xG) and Expected Points (xPts) are available as a paid add-on. See the stats section above for a real JSON response from the 2025/26 final.

Does the Conference League API include historical UEFA Cup and Conference League seasons?

Yes. The UEFA Conference League launched in 2021/22, and historical fixtures, standings, top scorers, squads, and (where available) xG are exposed for every season since. That covers the legacy group-stage format (2021/22 to 2023/24) and the new Swiss-style league phase (2024/25 onwards). Use the seasons endpoint to enumerate, then filter the fixtures or standings endpoint by season_id.

Does the Conference League API cover the new 36-team league phase?

Yes. From 2024/25, the Conference League uses a Swiss-style league phase of 36 clubs each playing 6 unique opponents, followed by knockout round play-offs, round of 16, quarter-finals, semi-finals and a single-leg final. The standings endpoint returns the full 36-team table, the schedules endpoint returns every stage (3 qualifying rounds, play-offs, league phase, knockouts, final), and fixtures carry a stage_id so you can filter cleanly.

What’s the Sportmonks league ID for the Conference League?

The Conference League league ID is 2286, and the 2025/26 season ID is 25581. Query the league with GET /v3/football/leagues/2286 and the current season’s fixtures with GET /v3/football/schedules/seasons/25581. Team IDs (e.g. Crystal Palace 51, Rayo Vallecano 377, Strasbourg 686, Shakhtar Donetsk 621) are listed in the team table above.

Europa League API

Which other UEFA competitions are covered alongside the Europa League?

UEFA club football is covered end to end, including the UEFA Champions League, UEFA Conference League, UEFA Super Cup, and the qualifying rounds for all three competitions. All accessible from the same API token under your paid plan.

Can I get Europa League predictions?

Yes. Our Predictions API exposes ML-driven probabilities for every Europa League fixture across 20+ markets (1X2, double chance, BTTS, over/under, correct score, asian handicap, anytime scorer, etc.). Probabilities are available 21 days before kick-off and refresh daily as new information comes in. See the predictions section above for a sample response.

Which Europa League stats are available (xG, shots, possession)?

Every league-phase and knockout fixture comes with a deep statistics object, ball possession, shots (total, on target, off target, blocked), corners, fouls, cards, passes, tackles, saves, and more. Expected Goals (xG) and Expected Points (xPts) are available as a paid add-on. See the stats section above for a real JSON response from the 2025/26 final.

Does the Europa League API include historical UEFA Cup and Europa League seasons?

Yes. Historical fixtures, standings, top scorers, squads, and (where available) xG are exposed for every Europa League season we’ve covered, including the legacy group-stage format (2009/10 to 2023/24) and earlier UEFA Cup seasons. Use the seasons endpoint to enumerate, then filter the fixtures or standings endpoint by season_id.

Does the Europa League API cover the new 36-team league phase?

Yes. From 2024/25, the Europa League uses a Swiss-style league phase of 36 clubs each playing 8 unique opponents, followed by knockout round play-offs, round of 16, quarter-finals, semi-finals and a single-leg final. The standings endpoint returns the full 36-team table, the schedules endpoint returns every stage (3 qualifying rounds, play-offs, league phase, knockouts, final), and fixtures carry a stage_id so you can filter cleanly.

What’s the Sportmonks league ID for the Europa League?

The Europa League league ID is 5, and the 2025/26 season ID is 25582. Query the league with GET /v3/football/leagues/5 and the current season’s fixtures with GET /v3/football/schedules/seasons/25582. Team IDs (e.g. Aston Villa 15, Olympique Lyonnais 79, Porto 652, Roma 37) are listed in the team table above.

Champions League API

Which other European competitions are covered alongside the Champions League?

UEFA club football is covered end to end, including the UEFA Europa League, UEFA Conference League, UEFA Super Cup, and the qualifying rounds for all three competitions. All accessible from the same API token under your paid plan.

How do I get live Champions League scores?

The Sportmonks API is polling-based REST. Poll the Livescore endpoint (GET /v3/football/livescores/inplay) on a short interval, typically every 10 to 15 seconds, for in-play updates, scores, events, statistics, and league-phase reshuffles.

Is there a free trial?

Yes. Every paid plan includes a 14-day free trial. A credit card is required to activate it, and you can cancel any time during the trial without being charged.

Does the Champions League API include historical seasons and the legacy group stage?

Yes. Historical fixtures, standings, top scorers, squads, and (where available) xG are exposed for every Champions League season we’ve covered, including the legacy 32-team group-stage format (2005/26 to 2023/24). Use the seasons endpoint to enumerate, then filter the fixtures or standings endpoint by season_id.

Does the Champions League API cover the new 36-team league phase?

Yes. From 2024/25, the Champions League uses a Swiss-style league phase of 36 clubs each playing 8 matches, followed by knockout play-offs, round of 16, quarter-finals, semi-finals and the final. The standings endpoint returns the full 36-team table, the schedules endpoint returns every stage (qualifying, league, knockout, final), and fixtures carry a stage_id so you can filter cleanly.

What’s the Sportmonks league ID for the Champions League?

The Champions League league ID is 2, and the 2025/26 season ID is 25580. Query the league with GET /v3/football/leagues/2 and the current season’s fixtures with GET /v3/football/schedules/seasons/25580. Team IDs (e.g. Real Madrid 3468, FC Barcelona 83, PSG 591, Arsenal 19) are listed in the team table above.

MLS API

Which other North American competitions are covered alongside MLS?

North American football is covered end to end alongside MLS, including the U.S. Open Cup, Leagues Cup, Canadian Championship, USL Championship, MLS Next Pro, NWSL, and Liga MX. All accessible from the same API token under a worldwide or Enterprise plan.

How does the MLS API handle the Eastern and Western Conferences?

MLS standings return one row per club, with a group_id identifying the conference: 253478 for the Western Conference and 253479 for the Eastern Conference. Group by group_id in your client to render the two conference tables. See the standings section above for both top sixes.

Does the MLS API include historical seasons?

Yes. Historical fixtures, standings, top scorers, squads, MLS Cup winners and (where applicable) xG are available for every MLS season we’ve covered. Use the seasons endpoint to enumerate, then filter the fixtures or standings endpoint by season_id. Season ID 26720 covers the 2026 regular season.

What is Inter Miami’s team ID in the Sportmonks MLS API?

Inter Miami’s team ID is 239235, LA Galaxy is 413, and Lionel Messi’s club can be queried with GET /v3/football/teams/239235. All 30 current MLS team IDs are listed in the team table above. Team IDs are stable across seasons.

Brasileirão API

Does the API cover Copa do Brasil, Libertadores and state championships too?

Brazil Serie A is the league this page documents (league ID 648), but our plans include the wider Brazilian football pyramid on Growth, Pro and Enterprise tiers, Copa do Brasil, Copa Libertadores, Copa Sudamericana, Série B, plus the major state championships (Paulista, Carioca, Mineiro, Gaúcho) and Brazil national team fixtures. Same API, same auth, same data shape.

Is there a free trial?

Yes, 14 days, no credit card. Sign up at my.sportmonks.com/register, get your API token immediately, and start pulling Brasileirão fixtures and live data the same session. Real humans are available 7 days a week if you get stuck.

How much does Brasileirão API access cost?

Plans start at €29/month (Starter, 5 leagues). Growth is €99/month (30 leagues), Pro is €249/month (120 leagues, most popular), and Enterprise is a custom quote covering all 2,300+ competitions with full historical data. Every paid plan includes a 14-day free trial.

Are the live standings and top scorers included?

Both are. The standings endpoint reorders as goals go in, including live goal difference for tiebreakers, poll it during a rodada to keep the table fresh. The top-scorer endpoint returns the current ranked list (sortable by goals, assists or any other stat) and the historical Artilheiro do Campeonato winners by season_id. Both data sets are also available as embeddable iframe widgets.

Does the API include Brasileirão predictions?

Yes. Our Predictions API runs ML models trained on millions of historical fixtures and outputs probabilities for every Brazil Serie A match across 20+ markets: full-time result, double chance, both teams to score, over/under, correct score, half-time/full-time, Asian and European handicap, total corners and cards, anytime goalscorer, and value bet indicators. Probabilities are available 21 days before kick-off and refresh daily.

Which Brasileirão stats are available?

Every Brasileirão fixture comes back with possession, shots (total, on target, off target, blocked, woodwork), passes (total, accurate, accuracy %), corners, fouls, yellow and red cards, tackles, interceptions, saves (inside box, total), goal kicks, throw-ins, offsides, big chances created and missed, and more. xG is delivered through the xG Data add-on. Coach and referee stats are included.

How far back does Brasileirão historical data go?

We hold the full Campeonato Brasileiro Série A catalogue back through the unified national format for results and final standings, with deeper data (fixtures, player stats, lineups, events) available from roughly 2010 onwards depending on availability. Enterprise plans include the full historical archive. Recent seasons carry xG, advanced statistics and lineups, older seasons are results-grade.

Does the Brasileirão API include live match data?

Yes. Every Brasileirão fixture exposes live data through a REST endpoint, score, in-play events (goals, cards, subs, VAR), live possession, live xG, and a continuously-updated statistics object. Poll the live endpoint every few seconds to keep your UI fresh.

Primeira Liga API

Can I access Liga Portugal 2 (the second tier) as well?

Yes. Liga Portugal 2 is covered with the same data depth (fixtures, results, lineups, statistics, top scorers, standings).

Are Portuguese clubs in European competitions covered?

Yes. Champions League, Europa League, Conference League and qualifying rounds are all covered. Porto, Benfica, Sporting CP and Sporting Braga’s European fixtures sit in their own competition IDs (UCL = 2, UEL = 5, UECL = 2286), but the same player and team objects flow through so you can build cross-competition profiles on the same IDs.

What does the Primeira Liga API cost?

Plans start at €29/month (Starter, 5 leagues). Growth is €99/month (30 leagues), Pro is €249/month (120 leagues), and Enterprise is a custom quote covering all 2,300+ competitions.
Every paid plan includes a 14-day free trial. The Primeira Liga is included from Starter upwards if you select it as one of your 5 leagues, or available on every higher tier.

Can I get Primeira Liga predictions?

Yes. Our Predictions API has been refined since 2017 and outputs probabilities for every Primeira Liga fixture across 20+ markets: 1X2, double chance, BTTS, over/under, correct score, half-time/full-time, asian and european handicaps, total corners, total cards, clean sheet, anytime goalscorer, and more. Predictions become available 21 days before kick-off and are updated daily.

Which Primeira Liga stats are available (xG, shots, possession)?

Every Primeira Liga fixture comes with the full statistics object: goals, shots (total, on target, off target, blocked), big chances created and missed, corners, crosses, offsides, ball possession, pass accuracy, tackles, interceptions, blocks, saves, fouls, yellow and red cards. Expected Goals (xG) and Expected Points (xPts) are available through our xG Data add-on.

How far back does Primeira Liga historical data go?

We cover the full Primeira Liga back to the 2005/06 season, with deeper historical coverage in the most recent seasons. That includes final standings, match results, top scorers, and squad lists for every season, queryable by season_id. Recent seasons also include statistics, lineups, and xG.

Does the Primeira Liga API include live scores?

Yes. Live scores update in real time during every Primeira Liga fixture, with goals, cards, substitutions, and minute-by-minute events all available through the same fixtures endpoint
(GET /v3/football/livescoers/).

Serie A API (Italy)

Do you cover Coppa Italia, Supercoppa Italiana and the lower Italian tiers?

Yes. Sportmonks covers 40+ Italian competitions in total, well beyond Serie A. That includes Coppa Italia (league_id 390), Supercoppa Italiana (1202), Serie B (387), all three Serie C Gironi (A: 1203, B: 1204, C: 1205), Lega Pro 2 Gironi A/B/C (1206/1207/1208), Serie D Gironi A through I, and more, all queryable through the same API surface with stable league IDs across seasons.

What does Serie A API access cost?

Plans start at €29/month (Starter, 5 leagues). Growth is €99/month, Pro is €249/month, and Enterprise is a custom quote covering all 2,300+ competitions worldwide. Every paid plan includes a 14-day free trial. The Pro plan (120 leagues) is the most common entry point for builders who want Serie A plus the other top European leagues.

Can I get Serie A predictions?

Yes. The Predictions API outputs probabilities for every Serie A fixture across 20+ markets, 1X2 result, double chance, both teams to score, over/under goals, correct score, team to score first, half-time / full-time, Asian handicap, total corners, total cards and more. Probabilities are published up to 21 days before kick-off and refreshed daily.

Which Serie A stats are available (xG, shots, possession, lineups)?

Every fixture comes with shots (total, on target, inside the box, woodwork), possession %, corners, passes, successful passes, pass accuracy %, fouls, yellow/red cards, offsides, tackles, interceptions, saves, and a full events timeline. xG, xGoT, xPTS, npxG and xG (open play / set play) are available on the xG Data add-on for Serie A.

How far back does Serie A historical data go?

Sportmonks covers Serie A historically through the Enterprise Plan or Historical Add-on package (one-time fee). For the recent decade you get full statistics, lineups, events, xG (where applicable) and predictions.

Does the Serie A API include live scores?

Yes. Poll the live endpoint every few seconds during a match and you’ll get live goal scorers, cards, substitutions, possession, shots, corners and a complete match-events timeline. Most live-score products poll on a 10–15 second cadence for in-play data.

Bundesliga API

How much does Bundesliga API access cost?

Plans start at €29/month (Starter, 5 leagues). Growth is €99/month (30 leagues), Pro is €249/month (120 leagues, most popular), and Enterprise is a custom quote covering all 2,300+ competitions with full historical data. Every paid plan includes a 14-day free trial.

What’s the rate limit and uptime?

Starter gives you 2,000 requests per entity per hour, Growth 2,500, Pro 3,000, Enterprise 5,000. Production uptime sits at 99.99%. Our data ops team verifies fixtures and live events 24/7, the same feed powers professional broadcast platforms.

Are the live standings and top scorers included?

Both are. Standings reorder in real time as goals go in, including live goal difference for tiebreakers. The top-scorer endpoint returns the current ranked list (sortable by goals, assists or any other stat) and the historical Torjägerkanone winners by season_id.

Which Bundesliga stats are available?

Every Bundesliga fixture comes back with possession, shots (total, on target, off target, blocked, woodwork), passes (total, accurate, accuracy %), corners, fouls, yellow and red cards, tackles, interceptions, saves (inside box, total), goal kicks, throw-ins, offsides, big chances created and missed, and more. xG is delivered through the xG Data add-on. Coach and referee stats are included.

How far back does Bundesliga historical data go?

We hold the full Bundesliga catalogue from 2005/2006 onwards for results and final standings, with deeper data (fixtures, player stats, lineups, events) from roughly 2010 onwards depending on availability. Recent seasons carry xG, advanced statistics and lineups; older seasons are results-grade.

Does the Bundesliga API include live match data?

Yes. Every Bundesliga fixture streams in real time, score, in-play events (goals, cards, subs, VAR), live possession, live xG, and a continuously-updated statistics object.

Ligue 1 API

Which other French competitions are covered alongside Ligue 1?

French football is covered end to end, including Ligue 2 (the second tier), Coupe de France, Trophée des Champions, Championnat National (third tier), and the Première Ligue (women’s top flight, formerly D1 Arkema). All accessible from the same API token under your European or Worldwide plan.

Is Ligue 1 included in the Free plan?

The Free plan covers the Danish Superliga and Scottish Premiership only. To access Ligue 1, start a 14-day free trial of any paid plan. Plans start at 29/month (Starter, 5 leagues), Growth is 99/month (30 leagues), Pro is 249/month (120 leagues, most popular), and Enterprise is a custom quote covering all 2,300+ competitions. Cancel any time before day 14 and you’ll never be invoiced.

How long does it take to integrate the Ligue 1 API?

Most developers have their first Premier League fixture response rendering in their app within an hour of signing up. Our developers created a Postman collection and intuitive docs to get you up to speed quickly.

How is Ligue 1 xG calculated?

Our xG model is trained on millions of historical shots and their outcomes. For each shot it considers location, type of attempt, angle to goal, goalkeeper position, defenders between ball and goal, and distanc. See the xG section above for live Ligue 1 examples.

Does the Ligue 1 API include historical seasons?

Yes. Historical fixtures, standings, top scorers, squads, and (where applicable) xG are available for every Ligue 1 season we’ve covered. Use the seasons endpoint to enumerate, then filter the fixtures or standings endpoint by season_id. Season ID 25651 covers 2025/26.

What is Paris Saint-Germain’s team ID in the Sportmonks Ligue 1 API?

Paris Saint-Germain’s team ID is 591, Olympique Marseille’s is 44, Olympique Lyonnais is 79 and Monaco is 6789. Query PSG with GET /v3/football/teams/591. All 18 current Ligue 1 team IDs are listed in the team table above. Team IDs are stable across seasons.

La Liga API

How do I pull El Clásico fixtures and historical head-to-head?

Filter the fixtures endpoint by both participant IDs (83 and 3468). Add ?include=statistics.type,xgfixture,events and you get possession, shots, xG and the full goal timeline for every Barcelona vs Real Madrid match we’ve covered in one response, going back more than 30 seasons.

What are Real Madrid’s and FC Barcelona’s team IDs?

Real Madrid is 3468, FC Barcelona is 83, Atlético Madrid is 7980. The La Liga league ID is 564. Pull a club with GET /v3/football/teams/{id}. All 20 team IDs for the current season are listed in the table above, and IDs stay stable across seasons.

Does the API include the Pichichi Trophy and historical top scorers?

Yes. The historical top-scorer endpoint returns the Pichichi winner for every season we’ve covered, with goals, assists and club info. The live top-scorer endpoint (and embeddable widget) rebuilds the current ranking after every La Liga goal no polling required.

Are Copa del Rey and Supercopa de España covered alongside La Liga?

Yes. Spanish football is covered end-to-end: La Liga, LaLiga 2 (Segunda División), Copa del Rey, Supercopa de España, Primera Federación, and the Liga F (women’s top flight) and much more. All accessible from the same API token.

How are accented Spanish team and player names handled?

Everything is UTF-8 throughout, so “Atlético Madrid”, “Iñaki Williams”, “Aitana Bonmatí” and “Pedri” return exactly as written. No transliteration, no name mangling. Each team object also exposes a short_code (BAR, RMA, ATM, ATH) for cases where you need ASCII-safe identifiers.

Does the API expose VAR decisions and Spanish referee assignments?

Yes. Each fixture object exposes the head referee, and event-level data captures VAR reviews with the outcome and minute. La Liga adopted VAR in 2018/19 and our coverage of VAR decisions runs from that season onwards.

How fast are Spanish transfer window changes reflected in the squads?

Squad changes (signings, departures, loans, contract renewals) are picked up by our data ops team within minutes of the official La Liga announcement. Use the squads by season id endpoint, our transfers endpoint and our Transfer Rumours endpoint for the most detailed transfer and actual squad data.

Is La Liga included in the Free plan?

No. The Free plan covers the Danish Superliga and Scottish Premiership only. To access La Liga, start a 14-day free trial of any paid plan. No credit card up front, cancel any time before day 14 and you’ll never be invoiced.

Match Facts

Is the AI Overview included in the Match Facts add-on permanently?

AI Overviews are available as part of the Match Facts add-on for a limited time. We’ll communicate clearly before anything changes. If you’re on a paid Match Facts plan when availability changes, we’ll make sure you’re not caught off guard.

What happens when I reach my API call limit?

The same as with the rest of your plan. You can add extra API calls as an add-on at any time. See full pricing for add-on options: Pricing page

Is Match Facts a separate API or part of my existing integration?

It’s part of your existing integration. Match Facts are returned through the same fixtures endpoint you’re already calling. Add matchfacts as an include parameter and your response is enriched with the full insights payload. Same authentication, same data format, no new infrastructure.

Which leagues are covered in the Match Facts add-on?

Match Facts is available for over 200 leagues. Coverage depends on your plan: Starter includes 5 leagues, Growth 30, and Pro 120. Additional leagues can be added to any plan. See the full list here: Match Facts Football Leagues →

Does Match Facts work with my current Sportmonks plan?

Yes. Match Facts is an add-on that sits on top of your existing Football API plan: Starter, Growth, or Pro. You don’t need a new account or a separate integration. Just add the add-on and start using the matchfacts include on your current fixtures calls.

Formula 1

What is a sports data API, and how does it work?

A sports data API gives your application programmatic access to match results, live scores, player statistics, standings, odds, and more. Your app sends HTTP requests to specific endpoints with an API token and receives structured JSON in return. The provider handles data collection, normalisation, and storage. You simply request what you need and render it. Most APIs, including Sportmonks, follow REST conventions and support query parameters like include to control related data.

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.

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.

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.

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.

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.

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.

Pricing and plans

Is historical data included?

Historical data older than three seasons is available as a one-time add-on for Starter, Growth, and Pro plans. Enterprise plans include full historical access.

Can I change my selected leagues?

Yes. You can swap leagues within your plan’s monthly swap limit. If you need more leagues, you can purchase extra league add-ons or upgrade your plan.

What happens if I exceed my API limit?

Each plan includes a defined hourly limit. If you exceed your limit, you’ll receive notifications. For higher-scale needs, you can add extra API call packages or upgrade your plan.

Do all plans include the same features?

Yes. All plans include the same professional-grade data features. The only difference between plans is the number of leagues you can select and your API call capacity.

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.

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.

Do you offer yearly plans?

Yes, we offer yearly plans. Yearly plans are discounted 20% 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.

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.

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.

Plan add-ons

Is the AI Overview included in the Match Facts add-on permanently?

AI Overviews are available as part of the Match Facts add-on for a limited time. We’ll communicate clearly before anything changes. If you’re on a paid Match Facts plan when availability changes, we’ll make sure you’re not caught off guard.

What happens when I reach my API call limit?

The same as with the rest of your plan. You can add extra API calls as an add-on at any time. See full pricing for add-on options: Pricing page

Is Match Facts a separate API or part of my existing integration?

It’s part of your existing integration. Match Facts are returned through the same fixtures endpoint you’re already calling. Add matchfacts as an include parameter and your response is enriched with the full insights payload. Same authentication, same data format, no new infrastructure.

Which leagues are covered in the Match Facts add-on?

Match Facts is available for over 200 leagues. Coverage depends on your plan: Starter includes 5 leagues, Growth 30, and Pro 120. Additional leagues can be added to any plan. See the full list here: Match Facts Football Leagues →

Does Match Facts work with my current Sportmonks plan?

Yes. Match Facts is an add-on that sits on top of your existing Football API plan: Starter, Growth, or Pro. You don’t need a new account or a separate integration. Just add the add-on and start using the matchfacts include on your current fixtures calls.

From which season is xG data available?

Expected Goals (xG) data is available starting from the 2024 season onward. xG metrics were not collected or generated for seasons prior to 2024, and therefore are not available historically before this point.

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 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 two types of packages: a Basic package and an Advanced package.

In the Basic package, all metrics will be available straight after a match.

The xG advanced package will have all our xG metrics and will be available live during the match.

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.

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.

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.

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.

Tournaments

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.

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.