ShotTracker Developer

Unparalleled data set + realtime API = future of sports. Build with live tracking, stats, and broadcast-ready endpoints.

Event API

Base URL: https://api.shottracker.com

/v1/data/stats/{id}/possessions

GETStats Possessions

Parameters

NameInTypeRequiredDescription
idpathstringYesID of the session

Responses

  • 200OK
    {
      "teams": [
        {
          "id": 515,
          "name": "STQA",
          "team_player_details": [
            {
              "id": 3403,
              "first_name": "John",
              "last_name": "Doe",
              "profile_image_link": ""
            },
            {
              "id": 3932,
              "first_name": "Jim",
              "last_name": "Doe",
              "profile_image_link": ""
            }
          ],
          "possessions": [
            {
              "_locations": "https://api.shottracker.com/v1/data/sensors/locations?id=abc-123&from=1580408461984&to=1580408463984",
              "start_timestamp": 1580408461984,
              "end_timestamp": 1580408463984,
              "start_game_clock": "12:30.0",
              "end_game_clock": "12:25.0",
              "period": "Q1",
              "player_ids": [
                3065,
                3403,
                3531,
                3532,
                3932
              ],
              "opposing_player_ids": [
                6833,
                6835,
                6836,
                6837,
                6838
              ],
              "stats": [
                {
                  "timestamp": 1580408461984,
                  "possession_type": "DEFENSIVE_REB",
                  "details": [
                    "DEFENSIVE_REB",
                    "REB"
                  ],
                  "player_id": 3403
                },
                {
                  "timestamp": 1580408463984,
                  "game_clock": "12:30.0",
                  "shot_clock": "10.0",
                  "possession_type": "FGA",
                  "details": [
                    "FGA",
                    "FGA3",
                    "FGA_OTD",
                    "FGA3_OTD"
                  ],
                  "player_id": 3932,
                  "shot_attributes": {
                    "shot_distance_cm": 755.0178607158906,
                    "x": 4096,
                    "y": 5320,
                    "z": -1,
                    "zone": 12,
                    "advanced_zone": 18,
                    "is_3point": true
                  }
                }
              ],
              "possession_attributes": {
                "turnover": 0,
                "passes": 1,
                "half_court": false,
                "paint_touch": true,
                "ball_reversals": 1,
                "ball_screens": 1,
                "ball_screens_left_wing": 1,
                "ball_screens_middle_wing": 0,
                "ball_screens_right_wing": 0,
                "ball_screens_pick_n_pop": 1,
                "ball_screens_pick_n_roll": 0,
                "ball_screens_pick_n_short_roll": 0,
                "ball_screens_screened_shot": 0,
                "ball_screens_handoff": 0,
                "ball_screens_drag": 0,
                "ball_screens_pop": 0,
                "ball_screens_roll": 0,
                "ball_screens_slip": 0,
                "ball_screens_short_roll": 0,
                "ball_screens_reject": 0,
                "ball_screens_re_screen": 0,
                "ball_screens_stay": 0,
                "ball_screens_step_up": 0,
                "ball_screens_snake": 0,
                "ball_screens_split": 0,
                "ball_screens_other": 0
              }
            }
          ]
        }
      ]
    }
  • 403Forbidden
    {
      "status": 403,
      "message": "No access to STATS data",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }
  • 404Not Found
    {
      "status": 404,
      "message": "Invalid id",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }
  • 500Internal Server Error
    {
      "status": 500,
      "message": "<General System Error Message>",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }