API v2116 endpoints16 groups
API reference
data envelope, so the row tells you what changes: the method, the path and the plan it needs.- 112 GET
- 3 POST
- 1 WS
Base URL and authentication
export BASE="https://api.datasportsapi.com"
export DATASPORTSAPI_API_KEY="dsa_live_…"
curl -H "Authorization: Bearer $DATASPORTSAPI_API_KEY" "$BASE/v2/sports"Plan tiers
Open to every key: Free, Starter, Pro and Business.
its colour in the group barsPro and Business keys. A Free or Starter key gets 403 endpoint_not_in_plan.
Business keys only. Covers Bulk exports, Webhooks and WebSocket.
its colour in the group barsEach plan also reads only as far back as its history window. Prices, quotas and windows are on Pricing; how requests are counted is in Plans, quota & rate limits.
16 groups
Jump to a group. The bar under each count is its split across the tiers above.
01 · 1 endpoint
Catalog
The starting point: which sports the API covers, which endpoint family serves each of them, and how many of its matches are being played right now.
02 · 1 endpoint
Live scores
Fixtures that are in play right now. If you are building a live feature, the WebSocket is the better fit: it delivers the same objects and then pushes deltas.
03 · 28 endpoints
Fixtures
Look up fixtures by date, or fetch one match together with its detail sub-resources.
- GET
Fixtures by date/
v2/ fixtures Lists the fixtures that start on a given UTC date.
All plans - GET
Fixture counts/
v2/ fixtures/ counts Fixture totals for a UTC date, without paging through the list.
All plans - GET
Fixture/
v2/ fixtures/ {id} Everything we hold on one fixture.
All plans - GET
Lineups/
v2/ fixtures/ {id}/ lineups Team lineups and formations plus unavailable players, with every player carrying a match rating and statistics.
All plans - GET
Statistics/
v2/ fixtures/ {id}/ statistics Team statistics for the match, organised by period and by category.
All plans - GET
Events/
v2/ fixtures/ {id}/ events The match’s incidents in chronological order, oldest first: goals, cards, substitutions, period markers and added-time announcements.
All plans - GET
Play by play/
v2/ fixtures/ {id}/ play-by-play Text commentary from our data source, one entry per action, oldest first.
Pro + Business - GET
Head to head/
v2/ fixtures/ {id}/ h2h The two teams’ head-to-head record as tallied by the source, seen from this fixture’s home / away point of view.
All plans - GET
Head-to-head fixtures/
v2/ fixtures/ {id}/ h2h/ fixtures Past and scheduled meetings of the two teams, returned as fixtures sorted by kick-off (oldest first); the fixture you asked about is excluded.
All plans - GET
Best players/
v2/ fixtures/ {id}/ best-players The player of the match together with the top-rated players on each team.
Pro + Business - GET
Momentum/
v2/ fixtures/ {id}/ momentum Attack-momentum curve with a point for every minute: positive values mean home pressure, negative values away pressure.
Pro + Business - GET
Win probability/
v2/ fixtures/ {id}/ win-probability Win probabilities for a football fixture from DataSportsAPI’s in-house model: the pre-match estimate, the live home / draw / away split and the full curve.
Pro + Business - GET
Source win probability/
v2/ fixtures/ {id}/ win-probability/ source In-game win probability as published by our data source (not DataSportsAPI’s model): home and away values for each minute of play.
Pro + Business - GET
AI commentary/
v2/ fixtures/ {id}/ commentary AI-written commentary on a football fixture, ordered oldest first by seq and capped at the latest 100 entries.
Pro + Business - GET
Shot map/
v2/ fixtures/ {id}/ shotmap All shots in chronological order (oldest first), each with its outcome and expected goals.
Pro + Business - GET
Pre-match form/
v2/ fixtures/ {id}/ form Pre-match form for both teams: recent results in this competition (oldest first), table position, the numeric table figure (points in football; wins, draws and losses in…
All plans - GET
Streaks/
v2/ fixtures/ {id}/ streaks Pre-match streaks: each team’s current run (wins, unbeaten, over 2.5 goals, …) plus streaks drawn from their head-to-head meetings.
All plans - GET
Player heatmap/
v2/ fixtures/ {id}/ heatmap/ {playerId} A single player’s activity map for the fixture — each recorded position sample, expressed as percentages of the pitch.
Pro + Business - GET
Player actions/
v2/ fixtures/ {id}/ players/ {playerId}/ actions A pitch-located log of one player’s on-ball involvement in the fixture: passes and crosses (start → end, completion, key pass, long ball), take-ons, ball carries and def…
Pro + Business - GET
Playoff series/
v2/ fixtures/ {id}/ series Ids of every fixture in the playoff series that contains this fixture (NBA, NHL, MLB postseason …), including this one.
All plans - GET
Average positions/
v2/ fixtures/ {id}/ average-positions Average position of every player during the fixture, grouped by side.
Pro + Business - GET
Point by point/
v2/ fixtures/ {id}/ points A point-by-point breakdown of the match.
Pro + Business - GET
Scorecard/
v2/ fixtures/ {id}/ scorecard Complete cricket scorecard, broken down per innings.
All plans - GET
Umpires/
v2/ fixtures/ {id}/ umpires Baseball only: the umpiring crew, giving each umpire’s name, years of experience and position (homePlate, firstBase, secondBase, thirdBase, leftField, rightField, other).
All plans - GET
Weather/
v2/ fixtures/ {id}/ weather Baseball only: ballpark weather in metric units (°C, %, km/h), with the observed conditions listed before the forecast.
All plans - GET
Esports games/
v2/ fixtures/ {id}/ games Esports only: a game-by-game view of the series.
All plans - GET
Pitches/
v2/ fixtures/ {id}/ at-bats/ {atBatId}/ pitches Baseball only: every pitch of a single at-bat in sequence, with pitch type (MLB Statcast categories: four-seam fastball, sinker, cutter, slider, sweeper, curveball, chan…
Pro + Business - GET
Highlights/
v2/ fixtures/ {id}/ highlights Match highlight videos, each with a title, its URL on the hosting platform (YouTube, X), the host name, the host’s thumbnail, a flag for the source’s main highlight and…
All plans
04 · 20 endpoints
Teams
A team is whoever takes part: a club, a national side, a tennis player, a fighter, a driver or a constructor. Profiles, fixtures, squads, transfers, season numbers, trophies and rankings live here.
- GET
Team/
v2/ teams/ {id} Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding d…
All plans - GET
Team fixtures/
v2/ teams/ {id}/ fixtures Returns one page of a team’s fixtures, either recent or upcoming.
All plans - GET
Squad/
v2/ teams/ {id}/ squad Lists the team’s present roster, giving each player’s profile together with their contract expiry and any ongoing injury.
All plans - GET
Team transfers/
v2/ teams/ {id}/ transfers Roughly the past year of player movement into the team (arrivals) and out of it (departures), most recent first.
All plans - GET
Team season statistics/
v2/ teams/ {id}/ statistics Season totals and averages for a team within a single league — goals for and against, shots, possession, rating, clean sheets and more.
All plans - GET
Goal distribution/
v2/ teams/ {id}/ goal-distribution Football: shows at which stage of a match a team scores and concedes across one league season, counting goals in 15-minute bands for all matches, home matches and away m…
All plans - GET
Race career/
v2/ teams/ {id}/ race-career For race sports, the career of a driver or constructor: aggregate totals (races started, wins, podiums, poles, titles) plus one row per series season with championship p…
All plans - GET
Season races/
v2/ teams/ {id}/ races For race sports, how a driver or constructor finished in every race of one series season.
All plans - GET
Statistics seasons/
v2/ teams/ {id}/ statistics/ seasons An index of the leagues and seasons with team season statistics, giving the league and season values that /v2/teams/{id}/statistics accepts along with the statistics typ…
All plans - GET
Squad statistics seasons/
v2/ teams/ {id}/ top-players/ seasons Lists the leagues and seasons where squad (player) statistics exist for the team — the inputs for /v2/teams/{id}/top-players.
All plans - GET
Table seasons/
v2/ teams/ {id}/ standings/ seasons Lists every league and season where the team appears in a standings table, ready to pass to /v2/leagues/{id}/standings.
All plans - GET
Tennis year statistics/
v2/ teams/ {id}/ year-statistics Breaks down one calendar year of a tennis player’s season by surface, one row each: matches and wins, tournaments entered and won, aces and double faults, break points,…
All plans - GET
Grand Slam results/
v2/ teams/ {id}/ grand-slams Shows, year by year, how far a tennis player went at each Grand Slam.
All plans - GET
Team leagues/
v2/ teams/ {id}/ leagues All competitions the team takes part in now or has taken part in before: domestic league, cups, European competitions and friendly tournaments.
All plans - GET
Trophies/
v2/ teams/ {id}/ trophies Everything the team has won: each competition with its type (domestic league, domestic cup, international cup, other), a flag for major titles, the number of wins and th…
All plans - GET
Position history/
v2/ teams/ {id}/ position-history Tracks a team’s league position week by week through one season, starting at week 1: the position at the end of each week and the fixtures played in it.
All plans - GET
Career statistics/
v2/ teams/ {id}/ career-statistics Career-long numbers for an MMA fighter: strikes landed and absorbed per round, split by target (head, body, legs) and by position (distance, clinch, ground); accuracy an…
All plans - GET
Team rankings/
v2/ teams/ {id}/ rankings Gives a team’s or competitor’s place in each ranking table DataSportsAPI serves: the ATP / WTA rankings and live rankings for tennis players (career high included) plus…
All plans - GET
Team top players/
v2/ teams/ {id}/ top-players Season leaderboards limited to one team’s players within a league — highest-rated players, leading scorers, top assisters and so on — paginated like the league-wide lead…
Pro + Business - GET
Featured fixture/
v2/ teams/ {id}/ featured-fixture Returns the match the source highlights for a team, which is normally its next fixture or the one it is playing right now.
All plans
05 · 13 endpoints
Players
The people in a squad: profile, transfer history, the seasons they have numbers for, career tables, match ratings and heatmaps.
- GET
Player/
v2/ players/ {id} Returns a player’s profile — position plus detailed positions (goalkeeper, centreBack, leftWinger, striker, …; an empty array if the source gives none), team, nationalit…
All plans - GET
Player transfers/
v2/ players/ {id}/ transfers Every move in the player’s career, most recent first, returned as the same Transfer objects that team transfer lists use.
All plans - GET
Latest transfers/
v2/ transfers A feed of the newest football transfers from all leagues, 50 per page, built from the same Transfer objects as team transfer lists.
All plans - GET
Player seasons/
v2/ players/ {id}/ seasons Lists each league and season for which the player has statistics, together with the statistics types offered in each (overall, home, away, regularSeason, playoffs).
All plans - GET
Player fixtures/
v2/ players/ {id}/ fixtures One page of the player’s most recent fixtures, across every team they appeared for; since 2026-10-24 each page lists the newest first.
All plans - GET
Player season statistics/
v2/ players/ {id}/ statistics Season totals and averages for a player within a single league — goals, minutes, averageRating, expected goals, passes, duels and more.
All plans - GET
Season rankings/
v2/ players/ {id}/ statistics/ rankings For every statistic, shows how the player compares with the rest of the league in one season: their value, their place (tied values share a place), how many players are…
Pro + Business - GET
Penalties/
v2/ players/ {id}/ penalties Football penalty record for a player across one league season: totals scored and taken, plus each kick: its fixture, its outcome (goal, save, miss, post), its xG and whe…
Pro + Business - GET
Player attributes/
v2/ players/ {id}/ attributes Attribute ratings (0–100) for a football player from the source’s scouting model: attacking, technical, tactical, defending and creativity, or for a goalkeeper saves, an…
Pro + Business - GET
National team/
v2/ players/ {id}/ national-team Caps, goals and debut date for every national side the player has represented, at senior and youth level.
All plans - GET
Career/
v2/ players/ {id}/ career The player’s career table, newest season first: statistics for each competition and season played at club and international level, either overall or split into regular s…
All plans - GET
Season heatmap/
v2/ players/ {id}/ heatmap Football: a player’s match heatmaps summed over one league season to show where they were active — each point with the number of samples recorded on it — plus the matche…
Pro + Business - GET
Season ratings/
v2/ players/ {id}/ ratings Match-by-match ratings for a player across one league season, oldest first, forming the points of a rating graph; each point gives the match, its kick-off, the player’s…
Pro + Business
06 · 22 endpoints
Leagues
A competition and everything inside one of its seasons: the table, rounds and fixtures, leaderboards, knockout brackets, team of the week and the season awards.
- GET
League/
v2/ leagues/ {id} Returns a league’s profile: its tier (where it sits in the national pyramid), gender, the reigning champion with its title count, the clubs holding the most titles, the…
All plans - GET
Seasons/
v2/ leagues/ {id}/ seasons Lists the league’s seasons, most recent first.
All plans - GET
Champions/
v2/ leagues/ {id}/ champions Recent title winners of the league, most recent first — each entry gives the season, the year in which it finished and the champion.
All plans - GET
Season venues/
v2/ leagues/ {id}/ venues Lists every venue where matches of a league season are played.
All plans - GET
Season calendar/
v2/ leagues/ {id}/ calendar Returns each UTC day of a league season on which fixtures are scheduled, together with the number of fixtures — handy for drawing a season calendar or linking straight t…
All plans - GET
Players of the season/
v2/ leagues/ {id}/ player-of-the-season/ history A season-by-season record of the league’s player of the season — an award our data source bases on match ratings — giving the winner, his club, his average rating and hi…
Pro + Business - GET
Season teams/
v2/ leagues/ {id}/ teams Lists the participants of a single league season; works just as well for cups and other competitions that have no table.
All plans - GET
Season/
v2/ leagues/ {id}/ seasons/ {seasonId} Key figures for a season — running totals such as goals, home and away wins, draws and cards — plus the teams new to the division, whether relegated into it from above o…
All plans - GET
Standings/
v2/ leagues/ {id}/ standings League tables for a single season.
All plans - GET
Rounds/
v2/ leagues/ {id}/ rounds Lists every round of a season and indicates which one is current.
All plans - GET
League fixtures/
v2/ leagues/ {id}/ fixtures Returns all fixtures in a single round of a season.
All plans - GET
Top players/
v2/ leagues/ {id}/ top-players Per-statistic player leaderboards for a season — rating, goals, xG, assists, tackles, saves and more, each holding up to 50 players at our data source.
Pro + Business - GET
Top match performances/
v2/ leagues/ {id}/ top-performances Record individual match performances in a league season.
Pro + Business - GET
Draft/
v2/ leagues/ {id}/ draft Returns a single round of a league’s draft — the NBA, the NFL and any other league whose draft our data source tracks.
All plans - GET
Top teams/
v2/ leagues/ {id}/ top-teams Per-statistic team leaderboards for a season — average rating, goals scored, clean sheets, possession and more — paged the same way as top-players.
All plans - GET
Player statistics explorer/
v2/ leagues/ {id}/ player-statistics A sortable player-statistics table for a football season: every player in the league, 20 per page, ordered by any statistic and returned with one column set — summary, a…
Pro + Business - GET
Cup trees/
v2/ leagues/ {id}/ cup-trees Knockout brackets for a season, such as a cup’s knockout phase, a playoff tree or a tennis draw.
All plans - GET
Team of the week periods/
v2/ leagues/ {id}/ team-of-the-week/ periods Every period in the season for which a team of the week exists, newest first — rounds in football and other round-based leagues, weeks in the NBA.
All plans - GET
Team of the week/
v2/ leagues/ {id}/ team-of-the-week The team of the week for a single round or week, laid out as a line-up of the top-rated players: the formation, then each player with his club, his position, the rating…
Pro + Business - GET
Featured fixtures/
v2/ leagues/ {id}/ featured-fixtures Matches our data source highlights for a league, typically the standout game of the round.
All plans - GET
Player of the season/
v2/ leagues/ {id}/ player-of-the-season Player of the season for a completed league season as chosen by our data source — the highest average match rating among players with enough appearances — together with…
Pro + Business - GET
Player of the season race/
v2/ leagues/ {id}/ player-of-the-season/ race The ongoing contest for player of the season: the front-runners ranked by average rating, highest first.
Pro + Business
07 · 5 endpoints
Discovery
Starting points for finding ids: world rankings, plus the full set of a sport’s leagues by country or by category.
- GET
Rankings/
v2/ rankings Lists every ranking DataSportsAPI provides: FIFA (men), UEFA coefficients for countries and clubs, World Rugby (men), ATP and WTA singles in both official and live form,…
All plans - GET
Ranking/
v2/ rankings/ {type} Returns one ranking, leaders first.
All plans - GET
Categories/
v2/ categories Returns the categories of a sport — the buckets our data source sorts leagues into: countries, regions (Europe, International), tours (ATP) and esports titles.
All plans - GET
League directory/
v2/ leagues Directory of leagues: all leagues within a category, or all leagues of a given sport in a given country.
All plans - GET
Popular leagues/
v2/ leagues/ popular Our data source’s selection of a sport’s most popular leagues for a visitor from a given country, kept in the source’s order: domestic leagues and the major internationa…
All plans
08 · 9 endpoints
Race sports
Motorsport and cycling — the sports with kind races in /v2/sports. Here a series takes the place of a league (Formula 1, MotoGP; in cycling, the full men’s or women’s calendar). Each race is either a Grand Prix weekend or one cycling race, split into sessions — the timed parts such as practice, qualifying, a sprint, the race itself or a cycling stage. Drivers and riders, like their teams, are TeamRefs, which /v2/teams/{id} resolves. Times are always in milliseconds and distances in metres. The WebSocket does not carry these sports yet; while a session runs, poll /v2/races/{id} and its /results.
- GET
Races/
v2/ races Returns every race that has a session beginning on a given UTC day, with all of each race’s sessions included.
All plans - GET
Race/
v2/ races/ {id} Full detail for a single race — series, season, round, status, dates, winner, circuit (motorsport: name, city, country, lap length), host country, laps and distance, and…
All plans - GET
Race results/
v2/ races/ {id}/ results Classification of a race.
All plans - GET
Race laps/
v2/ races/ {id}/ laps Lap-by-lap progress of a race session: every driver’s position at the end of each lap (lap 0 is the starting grid), his tyre compound, his pit stops (recorded on the in-…
Pro + Business - GET
Series/
v2/ series Lists the series that belong to a race-sport category.
All plans - GET
One series/
v2/ series/ {id} Basic details of a racing series — its name, slug and sport.
All plans - GET
Series seasons/
v2/ series/ {id}/ seasons Lists a series’ seasons, most recent first.
All plans - GET
Series races/
v2/ series/ {id}/ races Lists the races in one season of a series.
All plans - GET
Series standings/
v2/ series/ {id}/ standings A season’s championship standings, either for drivers / riders (type=competitors, the default) or for teams (type=teams), with points, wins, podiums, pole positions, fas…
All plans
09 · 4 endpoints
Referees & managers
Fixture.referee carries referee ids; TeamDetail.manager and Fixture.homeManager / awayManager carry manager ids. Both kinds can also be found through /v2/search.
- GET
Referee/
v2/ referees/ {id} Referee profile with country, sport, career totals (matches plus yellow, red and second-yellow cards) and a per-competition breakdown of appearances, cards and penalties…
All plans - GET
Referee fixtures/
v2/ referees/ {id}/ fixtures Returns one page of matches the referee has officiated (recent) or has been assigned to (upcoming), split by the same rule as team fixtures.
All plans - GET
Manager/
v2/ managers/ {id} Profile of a manager or head coach: country, date of birth, favoured formation, present team, career totals (games, wins, draws, losses, goals, points) and each job held…
All plans - GET
Manager fixtures/
v2/ managers/ {id}/ fixtures One page of the matches a manager has recently had or has coming up, divided by the same rule as team fixtures.
All plans
10 · 2 endpoints
Venues
Venue ids appear on Fixture.venue and TeamDetail.venue, and /v2/search can look venues up too.
- GET
Venue/
v2/ venues/ {id} Everything about one stadium or arena: where it is (city, country, coordinates), how many it holds, a photo, and which teams play their home games there.
All plans - GET
Venue fixtures/
v2/ venues/ {id}/ fixtures Returns one page of past or scheduled matches at a venue in a single sport, split by the same rule as team fixtures.
All plans
11 · 1 endpoint
Search
One query across teams, players, leagues, managers, referees, series, races, fixtures and venues. The quickest way to the ids every other endpoint asks for.
12 · 3 endpoints
Betting odds
Prices from a single bookmaker (bet365, supplied through our data source), both before kick-off and in play, available since 2026-11-04. Odds live exclusively on dedicated endpoints and a dedicated WebSocket channel: fixtures, lists and deltas never include betting fields, so your match data contains no odds unless you request them. Included in the Pro and Business plans, with live prices on odds:{id} for Business. Odds are third-party prices provided for information only — neither betting advice nor an offer to place a bet; make sure you follow the rules on displaying betting odds wherever your users are.
- GET
Fixture odds/
v2/ fixtures/ {id}/ odds All markets the bookmaker offers on a fixture — result (1X2), double chance, draw no bet, winner, first to score, both teams to score, Asian handicap, handicap / point s…
Pro + Business - GET
Winning odds/
v2/ fixtures/ {id}/ odds/ winning Winning odds set each side’s win price against two figures: the probability that price implies, and how often sides priced that way have really won.
Pro + Business - GET
Odds by day/
v2/ odds Returns the headline market for every fixture of a sport that the bookmaker prices on a given day — the three-way result in sports with draws, otherwise the winner.
Pro + Business
13 · 1 endpoint
Widgets
For Pro and Business plans. Two lines of HTML put live scores, a match centre or league tables on any web page — no backend needed, and the widgets carry no DataSportsAPI branding. Generate a widget key under the dashboard’s Widgets tab and register the sites allowed to use it.
14 · 3 endpoints
Bulk exports
For the Business plan. Get a whole league season as files: create an export, poll its status, then download. Exports are generated in the background from the same data the endpoints above serve; each account may create up to 20 per UTC day, and each one is kept for 7 days.
15 · 1 endpoint
Webhooks
For the Business plan. Add your https:// endpoints under the dashboard’s Webhooks tab and every event is sent to them as a JSON POST, so there is no socket to maintain. You can filter by event type, sport, league id and fixture id; every filter is optional, and they are combined with AND.
16 · 2 endpoints
WebSocket
Live deltas for scores and statuses. Obtain a single-use ticket via REST and then open the connection, so your API key never appears in a WebSocket URL. Available only on the Business plan (Full grade), with up to five simultaneous connections per account.