APIInsights

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}

GET

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

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/player-insights/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

Authorization

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

Parameters

playerId
string<uuid>
path
required
Player id from the team roster.
matchId
string<uuid>
path
required
Match id.

Response

application/json

Success

data
MatchInsights
required
error
object | null
required

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

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

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/player-insights/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

{
  "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 player insights - Superstat Help Center | Productlane

APIInsights

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}

GET

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

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/player-insights/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

Authorization

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

Parameters

playerId
string<uuid>
path
required
Player id from the team roster.
matchId
string<uuid>
path
required
Match id.

Response

application/json

Success

data
MatchInsights
required
error
object | null
required

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

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

curl -X GET "https://api.superstatsport.com/v1/matches/3fa85f64-5717-4562-b3fc-2c963f66afa6/player-insights/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer $SUPERSTAT_API_KEY"

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