Statistics · match · season · leaderboards
Sports statistics API for matches, seasons and leagues
DataSportsAPI is a sports statistics API that keeps the numbers of a match, a season and a whole league behind one contract. Ask /v2/fixtures/{id}/statistics for a match, /v2/players/{id}/statistics for a player's season, or a league's leaderboards for everyone at once; the field names stay the same from football to tennis.
- Match stats on every plan
- 133 football season statistics
- xG, ratings and heat maps
- Leaderboards and rankings
Football
Basketball
Ice Hockey
Tennis
American Football
BaseballThe data
Three levels of statistics
The match. Team statistics come grouped by category and split by period, so a first-half possession figure sits next to the full-time one. The line-ups add each player's rating and his own numbers for that game, and the best-players call names the man of the match. In football you can go further: every shot with its expected goals, a player's heat map and his on-ball actions placed on the pitch.
The season. For any player or team in a league season you get totals and averages, overall or split into home and away, regular season and playoffs where the competition has them. For a football player that is 133 keys, from minutes and goals to expected assists, duels and goalkeeping. Index calls tell you which leagues and seasons hold figures before you ask for them, and career tables put every season side by side.
The league. Leaderboards rank players and teams by any statistic, record performances keep the best single games of the season, rankings place one player against the rest of the league, and the team of the week and player of the season are built from the ratings. A football season also opens as one sortable table of every player.
Match statistics
Read again on a 30-second cycle during play, and final once the game is over.
- GET
/v2/fixtures/{id}/statisticsStatisticsTeam statistics by category and by period, for every sport.All plans - GET
/v2/fixtures/{id}/lineupsLineupsFormations and both squads, each player with a match rating and his own figures.All plans - GET
/v2/fixtures/{id}/best-playersBest playersPlayer of the match and the top-rated players on each side.Pro and up - GET
/v2/fixtures/{id}/shotmapShot mapEvery shot with outcome, xG and xGOT, location, body part and situation.Pro and up - GET
/v2/fixtures/{id}/heatmap/{playerId}Player heatmapWhere one football player was active during the match.Pro and up - GET
/v2/fixtures/{id}/players/{playerId}/actionsPlayer actionsPasses, take-ons, carries and defensive actions, each placed on the pitch.Pro and up
Season and league statistics
Refreshed when a match of the season finishes, starting on the next request.
- GET
/v2/players/{id}/statisticsPlayer season statisticsA player's totals and averages in one league season.All plans - GET
/v2/teams/{id}/statisticsTeam season statisticsA team's totals and averages: goals, shots, possession, clean sheets and more.All plans - GET
/v2/leagues/{id}/top-playersTop playersReady-made player leaderboards for any statistic.Pro and up - GET
/v2/leagues/{id}/top-teamsTop teamsThe same leaderboards for teams.All plans - GET
/v2/leagues/{id}/player-statisticsPlayer statistics explorerEvery player of a football season in one sortable, filterable table.Pro and up - GET
/v2/players/{id}/statistics/rankingsSeason rankingsWhere a player stands in the league for each statistic.Pro and up
First request
A player's season in one call
Season statistics are always asked for one league and one season: take the league id from the player's fixtures or from search, and the season ids from /v2/players/{id}/seasons, which also tells you which types (overall, home, away, regular season, playoffs) each season offers.
The answer is the usual { data, meta } envelope with a flat statistics object, so a key you read once, such as expectedGoals or averageRating, means the same in every league and every season.
# A player's season in one league: totals and averages
curl "https://api.datasportsapi.com/v2/players/{id}/statistics?league={leagueId}&season={seasonId}" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# The league's leaderboards for that season (Pro and up)
curl "https://api.datasportsapi.com/v2/leagues/{leagueId}/top-players?season={seasonId}&category=goals" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"{
"data": {
"team": { "id": 4438, "name": "Manchester City", "code": "MCI" },
"statistics": {
"appearances": 7, "minutesPlayed": 620, "goals": 8, "assists": 0,
"averageRating": 7.93, "totalShots": 27, "shotsOnGoal": 13,
"expectedAssists": 0.91
// … the rest of the season keys
}
},
"meta": { "league": 195828, "season": 200386, "type": "overall" }
}Statistic keys
Every match statistic, named once per sport
Each sport has its own list of match statistic keys, with a readable name, a group and whether a higher value is better, so you can build comparison bars without a lookup table of your own. These are the documented lists, counted from the data reference.
| Topic | Match statistic keys | A few of them |
|---|---|---|
| Football | 51 | Ball possession, Expected goals, Big chances, Total shots |
| MMA | 46 | Statistics time, Distance Seconds, Distance Percent, Ground Seconds |
| Tennis | 42 | Aces, Double faults, First serve, Second serve |
| Ice Hockey | 32 | Shots on goal, Penalties, Penalty minutes, Hits |
| American Football | 28 | Touchdowns, Field goals, Total yards, Turnovers |
| Baseball | 26 | Runs, Doubles, Triples, Home runs |
| Rugby | 21 | Tries, Conversions, Try assists, Penalty tries |
| Basketball | 17 | Free throws, 2 pointers, 3 pointers, Field goals |
| Handball | 16 | Shooting efficiency, Wing goals, Fastbreak goals, 7 meters |
| Table Tennis | 9 | Points won, Max points in a row, Comeback to win, Biggest lead |
| Darts | 7 | Average 3 darts, Thrown 180, Thrown over 140, Thrown over 100 |
| Badminton | 5 | Points won, Max points in a row, Match points, Comeback to win |
| Volleyball | 2 | Errors, Aces |
Freshness
When the numbers move
Statistics follow the match: live while it is played, settled when it ends, then rolled into the season and the league tables.
- Match statistics
- About 30 sRe-read while the match is in play and never more than 90 seconds behind; then they settle.
- Line-ups and ratings
- About 30 sPlayers' match figures and ratings move with the game, on the same cycle as the team statistics.
- Season totals
- After each matchA finished match of the season refreshes player and team totals from the next request onwards.
- Leaderboards
- After each matchTop players and top teams rebuild the same way; the source posts season figures with a short lag.
- Football season keys
- 133Per player and league season: playing time, attack, passing, duels, defending and goalkeeping.
- Bulk season export
- JSON · CSV · ParquetFrom Business up: a league season in one file, ready for notebooks and warehouses.
Plans
Statistics on every plan, depth from Pro
Match statistics, line-ups and season totals are part of the core every plan shares. The paid plans add volume, longer history and the advanced layers: leaderboards, rankings, shot maps and heat maps.
Free
Included$0 a month
- 1,000 requests / day
- 10 requests a minute
- Last 7 days of history
Match statistics, line-ups with ratings, player and team season totals and team leaderboards, for a prototype.
Free plan detailsStarter
Included$49 a month
- 250,000 requests / month
- 120 requests a minute
- Last 30 days of history
The same statistics with the volume to keep a season's worth of matches up to date.
Starter plan detailsPro
Included$199 a month
- 1,000,000 requests / month
- 600 requests a minute
- Last 6 months of history
Adds player leaderboards, record performances, rankings, rating graphs, shot maps with xG, heat maps and the player-statistics explorer.
Pro plan detailsBusiness
Included$1,500 a month
- 5,000,000 requests / month
- 3,000 requests a minute
- Last 12 months of history
Adds a year of history, webhooks and bulk season exports in JSON, CSV and Parquet.
Business plan detailsEnterprise
Included$2,500 a month
- 10,000,000 requests / month
- 6,000 requests a minute
- Full history
Adds the full archive and tracking data: ball, events and timelines, plus NBA player positions. Enterprise also has the most volume.
Enterprise plan details
Questions
Sports statistics API, answered
Anything else? The full FAQ covers quota, plans and the data in general.
Which sports does the statistics API cover?
Every fixture sport returns match statistics in the same envelope, and the data reference documents the keys sport by sport for 13 of them, from football's 51 down to the handful a badminton or darts match produces. Season totals, leaderboards and record performances follow the source: football has the deepest set, basketball and ice hockey come next, and tennis and MMA add their own career and calendar-year tables.
Is expected goals (xG) included?
Yes, in football. Match statistics carry expected goals for both teams on every plan. From Pro up, the shot map lists each shot with its xG and xGOT, pitch and goal-mouth coordinates, body part and situation, and a player's season statistics add expected goals and expected assists over the whole league season.
Can I rank every player in a league by one statistic?
Yes, from Pro up. /v2/leagues/{id}/top-players returns ready-made leaderboards (rating, goals, assists, xG, tackles, saves and many more), and /v2/leagues/{id}/player-statistics is a sortable table of every player in a football season, 20 to a page, ordered by any statistic and filtered by team or position. /v2/leagues/{id}/top-teams does the same for teams on every plan.
Are statistics on the free plan?
The core is: match statistics by period, line-ups with every player's match rating and figures, player and team season totals, career tables and team leaderboards all answer on Free. Leaderboards of players, record performances, rankings, ratings over a season, heat maps, shot maps and the player-statistics explorer start at Pro.
How fresh are the numbers during and after a match?
While a match is in play, its statistics, line-ups, shot map and momentum are re-read about every 30 seconds and never more than 90 seconds behind. Season totals and leaderboards refresh when a match of that season finishes, starting on the next request; the source itself publishes season figures with a short lag.
Can I download a whole season's statistics at once?
From Business up, a bulk export packs one league season into JSON, CSV or Parquet: every fixture, the standings, top players and top teams, ready for pandas, a warehouse or a model. On the other plans you page through the same data over REST.
Keep reading
More of the sports data API
Other ways in
- Live scores APIEvery match in play in one call, with score, status and clock current to the second.Read more
- Real-time sports APIA WebSocket with snapshots, deltas and replay, plus signed webhooks, from the Business plan up.Read more
- Free sports APIThe core match data for all 24 sports on the Free plan, with no card to sign up.Read more
- Betting odds APIPre-match and in-play prices per fixture from Pro, a day of markets in one call, live moves from Business.Read more
- Historical sports dataFinished seasons over REST, back to 1920 on Enterprise, or as JSON, CSV and Parquet season files.Read more
Sport by sport
In the docs
- Player season statisticsParameters, types and response fields
- League leaderboardsCategories, paging and types
- Match statisticsGroups and periods, sport by sport
- Data referenceEvery statistic key and object
- Fantasy sports APIRatings and statistics for fantasy games
- API playgroundCall the statistics endpoints in your browser
Put a season's numbers behind your product.
1,000 free requests a day during the beta. No card, no sales call.







