Generate team insights
Writes the team insights and every rostered player’s insights for this match. Returns immediately with status generating; poll the GET until status is ready. Usually takes one to two minutes. Does nothing if insights are already up to date, unless regenerate is true. A match that is not complete returns status unavailable.
Authorization
apiKey Club API key, for example ss_live_…. Create one in the Superstat app under Settings → API keys.
In: header
Path Parameters
Match id.
uuidQuery Parameters
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/insights"{ "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}Get team insights GET
The written insights and ratings for your team in this match. Check status: ready means summary and ratings are included, not_generated means you should POST this URL, generating means a run is in progress and you should poll, failed means the last run failed, and unavailable means the match is not complete yet.
Get player insights GET
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.