A season's per-game analysis aggregates

KBL-only route. Folds every final official regular-season game of the season: the text cast's coverage (a cast is complete when the points it scores add up to the final score), team turnovers and team rebounds, the clutch window (fourth quarter or overtime, five minutes or less on the clock, score within five; both teams' counting stats inside it), and the game extension's officials and official team-record scoring extras (points off turnovers, fast-break, second-chance, bench points, largest lead). An incomplete cast serves team_events and clutch as null, and a game without an extension serves scoring as null — never zero. definition.action_codes_version names the text-cast decode.

Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/kbl/games/analysis-aggregatesTry it

GETGet a KBL season's per-game analysis aggregates

GEThttps://api.sportquanta.comhttps://api-stage.sportquanta.comhttp://localhost:8082/v1/kbl/games/analysis-aggregates

Send

Get a KBL season's per-game analysis aggregates

KBL-only route. Folds every final official regular-season game of the season: the text cast's coverage (a cast is complete when the points it scores add up to the final score), team turnovers and team rebounds, the clutch window (fourth quarter or overtime, five minutes or less on the clock, score within five; both teams' counting stats inside it), and the game extension's officials and official team-record scoring extras (points off turnovers, fast-break, second-chance, bench points, largest lead). An incomplete cast serves team_events and clutch as null, and a game without an extension serves scoring as null — never zero. definition.action_codes_version names the text-cast decode.

Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

Authorization

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Bearer

Query

seasonintegerrequired

Get a KBL season's per-game analysis aggregatescURL

200Example

Reference context: KBL.

Overview · Response conventions

Get a KBL season's per-game analysis aggregates

curl --request GET \
  --url 'https://api.sportquanta.com/v1/kbl/games/analysis-aggregates?season=2000' \
  --header 'Authorization: Bearer <token>'

200 · Example

{
  "data": {
    "season": 0,
    "definition": {
      "clutch_from_period": 0,
      "clutch_last_seconds": 0,
      "clutch_max_margin": 0,
      "action_codes_version": "<string>"
    },
    "coverage": {
      "games": 0,
      "plays_complete": 0,
      "with_extension": 0,
      "with_officials": 0
    },
    "games": [
      {
        "game_id": "<string>",
        "schedule_date": "<string>",
        "home_team_id": "<string>",
        "away_team_id": "<string>",
        "venue_id": "<string>",
        "home_score": 0,
        "away_score": 0,
        "plays": {
          "count": 0,
          "complete": true,
          "points_home": 0,
          "points_away": 0,
          "periods": 0
        },
        "team_events": {
          "home": {
            "team_turnovers": 0,
            "team_rebounds": 0
          },
          "away": {
            "team_turnovers": 0,
            "team_rebounds": 0
          }
        },
        "clutch": {
          "seconds": 0,
          "home": {
            "points": 0,
            "fgm": 0,
            "fga": 0,
            "fg2m": 0,
            "fg2a": 0,
            "fg3m": 0,
            "fg3a": 0,
            "ftm": 0,
            "fta": 0,
            "oreb": 0,
            "dreb": 0,
            "tov": 0,
            "player_tov": 0,
            "team_tov": 0,
            "ast": 0,
            "stl": 0,
            "blk": 0,
            "pf": 0
          },
          "away": {
            "points": 0,
            "fgm": 0,
            "fga": 0,
            "fg2m": 0,
            "fg2a": 0,
            "fg3m": 0,
            "fg3a": 0,
            "ftm": 0,
            "fta": 0,
            "oreb": 0,
            "dreb": 0,
            "tov": 0,
            "player_tov": 0,
            "team_tov": 0,
            "ast": 0,
            "stl": 0,
            "blk": 0,
            "pf": 0
          }
        },
        "scoring": {
          "home": {
            "points_off_turnovers": 0,
            "fast_break_points": 0,
            "second_chance_points": 0,
            "bench_points": 0,
            "largest_lead": 0
          },
          "away": {
            "points_off_turnovers": 0,
            "fast_break_points": 0,
            "second_chance_points": 0,
            "bench_points": 0,
            "largest_lead": 0
          }
        },
        "officials": [
          {
            "name": "<string>",
            "role": "<string>"
          }
        ]
      }
    ]
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Query Parameters

seasonintegerrequired

Required range: 2000 <= x, x <= 2100

Response

200401403404422429500502503application/json

Per-game analysis aggregates for the season.

dataobjectrequired

data.seasonintegerrequired

data.definitionobjectrequired

data.definition.clutch_from_periodintegerrequired

data.definition.clutch_last_secondsintegerrequired

data.definition.clutch_max_marginintegerrequired

data.definition.action_codes_versionstringrequired

data.coverageobjectrequired

data.coverage.gamesintegerrequired

data.coverage.plays_completeintegerrequired

data.coverage.with_extensionintegerrequired

data.coverage.with_officialsintegerrequired

data.gamesobject[]required

data.games.game_idstringrequired

data.games.schedule_datestringrequired

data.games.home_team_idstringrequired

data.games.away_team_idstringrequired

data.games.venue_idstring | nullrequired

data.games.home_scoreinteger | nullrequired

data.games.away_scoreinteger | nullrequired

data.games.playsobjectrequired

data.games.plays.countintegerrequired

data.games.plays.completebooleanrequired

data.games.plays.points_homeintegerrequired

data.games.plays.points_awayintegerrequired

data.games.plays.periodsintegerrequired

data.games.team_eventsobject | nullrequired

data.games.team_events.homeobjectrequired

data.games.team_events.home.team_turnoversintegerrequired

data.games.team_events.home.team_reboundsintegerrequired

data.games.team_events.awayobjectrequired

data.games.team_events.away.team_turnoversintegerrequired

data.games.team_events.away.team_reboundsintegerrequired

data.games.clutchobject | nullrequired

data.games.clutch.secondsintegerrequired

data.games.clutch.homeobjectrequired

data.games.clutch.home.pointsintegerrequired

data.games.clutch.home.fgmintegerrequired

data.games.clutch.home.fgaintegerrequired

data.games.clutch.home.fg2mintegerrequired

data.games.clutch.home.fg2aintegerrequired

data.games.clutch.home.fg3mintegerrequired

data.games.clutch.home.fg3aintegerrequired

data.games.clutch.home.ftmintegerrequired

data.games.clutch.home.ftaintegerrequired

data.games.clutch.home.orebintegerrequired

data.games.clutch.home.drebintegerrequired

data.games.clutch.home.tovintegerrequired

data.games.clutch.home.player_tovintegerrequired

data.games.clutch.home.team_tovintegerrequired

data.games.clutch.home.astintegerrequired

data.games.clutch.home.stlintegerrequired

data.games.clutch.home.blkintegerrequired

data.games.clutch.home.pfintegerrequired

data.games.clutch.awayobjectrequired

data.games.clutch.away.pointsintegerrequired

data.games.clutch.away.fgmintegerrequired

data.games.clutch.away.fgaintegerrequired

data.games.clutch.away.fg2mintegerrequired

data.games.clutch.away.fg2aintegerrequired

data.games.clutch.away.fg3mintegerrequired

data.games.clutch.away.fg3aintegerrequired

data.games.clutch.away.ftmintegerrequired

data.games.clutch.away.ftaintegerrequired

data.games.clutch.away.orebintegerrequired

data.games.clutch.away.drebintegerrequired

data.games.clutch.away.tovintegerrequired

data.games.clutch.away.player_tovintegerrequired

data.games.clutch.away.team_tovintegerrequired

data.games.clutch.away.astintegerrequired

data.games.clutch.away.stlintegerrequired

data.games.clutch.away.blkintegerrequired

data.games.clutch.away.pfintegerrequired

data.games.scoringobject | nullrequired

data.games.scoring.homeobjectrequired

data.games.scoring.home.points_off_turnoversinteger | nullrequired

data.games.scoring.home.fast_break_pointsinteger | nullrequired

data.games.scoring.home.second_chance_pointsinteger | nullrequired

data.games.scoring.home.bench_pointsinteger | nullrequired

data.games.scoring.home.largest_leadinteger | nullrequired

data.games.scoring.awayobjectrequired

data.games.scoring.away.points_off_turnoversinteger | nullrequired

data.games.scoring.away.fast_break_pointsinteger | nullrequired

data.games.scoring.away.second_chance_pointsinteger | nullrequired

data.games.scoring.away.bench_pointsinteger | nullrequired

data.games.scoring.away.largest_leadinteger | nullrequired

data.games.officialsobject[]required

data.games.officials.namestringrequired

data.games.officials.rolestringrequired

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.