API
Insights

Get player insights

Insights for one of your players in this match. playerId comes from the team roster. status works the same way as team insights. Player insights are written together with the team insights.

GET
/v1/matches/{matchId}/player-insights/{playerId}

Authorization

apiKey
AuthorizationBearer <token>

Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.

In: header

Path Parameters

playerId*string

Player id from the team roster.

Formatuuid
matchId*string

Match id.

Formatuuid

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/matches/497f6eca-6276-4993-bfeb-53cbbbba6f08/player-insights/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "data": {    "status": "ready",    "message": "Insights are up to date.",    "stale": false,    "recordedBy": "team",    "summary": {      "whatsWorking": [        "Paint touches created open threes."      ],      "focusAreas": [        "Live-ball turnovers came in transition."      ],      "suggestions": [        "Run the drag screen earlier in the shot clock."      ]    },    "ratings": {      "shotMix": {        "value": 42,        "comment": "More of the offence came from the paint."      },      "pointsPerShot": {        "value": 42,        "comment": "More of the offence came from the paint."      },      "assistRate": {        "value": 42,        "comment": "More of the offence came from the paint."      },      "turnovers": {        "value": 42,        "comment": "More of the offence came from the paint."      },      "rebounds": {        "value": 42,        "comment": "More of the offence came from the paint."      },      "defensiveImpact": {        "value": 42,        "comment": "More of the offence came from the paint."      }    },    "generatedAt": "2026-03-14T07:02:11.000Z"  },  "error": null}