Insights
Generate player insights
Starts the same run as generating team insights: the team summary and every rostered player, including this one. Returns immediately with status generating. Poll the GET until status is ready.
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.
Format
uuidmatchId*string
Match id.
Format
uuidQuery Parameters
regenerate?string
Pass true to write the insights again even when they are already up to date.
Value in
- "true"
- "false"
Response Body
application/json
application/json
application/json
curl -X POST "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}