Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

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
Baseball
One statistics contract, sport by sport

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

Season and league statistics

Refreshed when a match of the season finishes, starting on the next request.

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"
200 OK · trimmed
{
  "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.

TopicMatch statistic keysA few of them
Football51Ball possession, Expected goals, Big chances, Total shots
MMA46Statistics time, Distance Seconds, Distance Percent, Ground Seconds
Tennis42Aces, Double faults, First serve, Second serve
Ice Hockey32Shots on goal, Penalties, Penalty minutes, Hits
American Football28Touchdowns, Field goals, Total yards, Turnovers
Baseball26Runs, Doubles, Triples, Home runs
Rugby21Tries, Conversions, Try assists, Penalty tries
Basketball17Free throws, 2 pointers, 3 pointers, Field goals
Handball16Shooting efficiency, Wing goals, Fastbreak goals, 7 meters
Table Tennis9Points won, Max points in a row, Comeback to win, Biggest lead
Darts7Average 3 darts, Thrown 180, Thrown over 140, Thrown over 100
Badminton5Points won, Max points in a row, Match points, Comeback to win
Volleyball2Errors, 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.

  1. 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 details
  2. Starter

    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 details
  3. Pro

    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 details
  4. Business

    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 details
  5. Enterprise

    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.

Put a season's numbers behind your product.

1,000 free requests a day during the beta. No card, no sales call.