Skip to content
datasportsAPI

FixturesBest players

Documentation

/

Type to filter the docs by title or path.

FixturesEndpoint 12 of 116

Best players

GET

/v2/fixtures/{id}/best-players

Plan
Pro + Business
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
BestPlayers
Try in Playground

The player of the match together with the top-rated players on each team.

Plan access

Requires a Pro or Business plan; every other plan receives 403 endpoint_not_in_plan.

Worth knowing

  • Filled once ratings exist, which in covered leagues means during or after the match.
  • Until then the answer is 200, with playerOfTheMatch set to null and the lists empty.
  • label tells you what value is: a rating in football, points in basketball and ice hockey, goals in handball, yards in American football.
  • In basketball there is one player per side, with statistics holding his line (points, rebounds, assists, steals, blocks, rating).
  • In baseball (since 2026-11-04) the list holds the players the source rates best, each placed with his team, with role (pitcher or batter) and the stat line, pitching or batting, behind the choice; value and label are null because the source does not document its figure for them, and the ordering is the source’s, best first.
  • Other sports have statistics set to null, and role is null in every sport except baseball.

01Parameters

  • idpathRequired

    fixture id issued by DataSportsAPI, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/best-players"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
BestPlayers
ObjectsBestPlayers
Example response
{ "data": { "playerOfTheMatch": { "player": { "id": 4120, "name": "Gabriel Magalhães", … }, "value": 8.0, "label": "rating" },
    "home": [ { "player": { "id": 4188, "name": "Liam Delap", … }, "value": 7.5, "label": "rating" }, … ],
    "away": [ … ] } }

// Basketball:
{ "data": { "playerOfTheMatch": null,
    "home": [ { "player": { "id": 817, "name": "Trae Young", … }, "value": 31, "label": "points",
                "statistics": { "points": 31, "rebounds": 4, "assists": 11, "steals": 2, "blocks": 0, "rating": 8.9 }, "role": null } ],
    "away": [ … ] } }

// Baseball:
{ "data": { "playerOfTheMatch": null, "home": [],
    "away": [ { "player": { "id": 912, "name": "Yandy Díaz", … }, "value": null, "label": null, "role": "batter",
                "statistics": { "battingHits": 2, "battingAtBats": 5, "battingHomeRuns": 1, "battingRbi": 2, "battingRuns": 2 } },
              { "player": { "name": "Nick Martinez", … }, "value": null, "label": null, "role": "pitcher",
                "statistics": { "pitchingInningsPitched": 5.1, "pitchingWins": 1, "pitchingHitsAllowed": 2 } }, … ] } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code