Player attributes

GET

https://api.datasportsapi.com/v2/players/{id}/attributes

Plan: Pro + Business
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: PlayerAttributes

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.

Plan access

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

Worth knowing

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.

01Parameters

Name	In	Required	Description
`id`	path	Required	DataSportsAPI player id, a positive integer

idpathRequired
DataSportsAPI player id, 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/players/{id}/attributes"

03Response

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

data: PlayerAttributes

ObjectsPlayerAttributes

Example response

7 lines

{ "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": {} }

04Errors

404no_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 key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code