APIInsights
Get team insights
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
/v1/matches/{matchId}/insightscurl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/insights" \
-H "Authorization: Bearer $SUPERSTAT_API_KEY"Authorization
AuthorizationstringheaderrequiredClub API key, for example
ss_live_…. Create one in the Superstat app under Settings → API keys.
Parameters
matchIdstring<uuid>pathrequiredMatch id.
Response
application/json
Success
dataMatchInsightsrequirederrorobject | nullrequired
{
"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
}