Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Players

Player attributes

GET

/v2/players/{id}/attributes

Pro and up

View as MarkdownTry in Playground →

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, anticipation, ball distribution, aerial and tactical. Includes current and earlier-year values, the average for players in the same position, strengths and weaknesses, and the detailed positions the player covers.

Keys belonging to the other profile are null — a goalkeeper, for example, has no attacking rating. history starts with the current values (yearsAgo 0, 1, 2, …). strengths / weaknesses draw from a closed set (PlayerCharacteristic) and can be empty.

Parameters

id

pathrequired

DataSportsAPI player id, a positive integer

Response

errors
404 no_data — the source has no rating for this player, as with other sports and many lower leagues; 404 not_found — DataSportsAPI has never assigned this id

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/players/{id}/attributes"
Example
{ "data": {
    "current": { "yearsAgo": 0, "position": "forward", "attacking": 76, "technical": 67, "tactical": 59, "defending": 46, "creativity": 76,
                 "saves": null, "anticipation": null, "ballDistribution": null, "aerial": null },
    "history": [ { "yearsAgo": 0, … }, { "yearsAgo": 1, "attacking": 81, … }, … ],
    "positionAverage": { "yearsAgo": 0, "position": "forward", "attacking": 61, "technical": 54, "tactical": 43, "defending": 32, "creativity": 45, … },
    "strengths": ["penaltyTaking", "positioning", "highPressing"], "weaknesses": [], "positions": ["rightWinger"] },
  "meta": {} }