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/games/{event_id}/ballscreens

GETBall Screens

Predicted ball screen events for the game. Each event includes ball handler and screener player IDs, offensive and defensive action probabilities, screener location, and optional possession linkage.

Parameters

NameInTypeRequiredDescription
event_idpathstringYesID of the game event

Responses

  • 200OK
    {
      "ballscreens": [
        {
          "sessionId": "9a26193b-79f0-11e8-8cab-0242529169d5",
          "timestamp": 1530093586408,
          "type": "BALL_SCREEN",
          "eventId": "6a02e3ec-a70c-4fc8-9fb1-464c0da644f2",
          "gameId": "58bd601c-fc76-11e9-8f0b-362b9e155667",
          "teamPossessionId": "4181c488-426b-11ec-83f6-02420043683b",
          "sessionType": "GAME_ROUND",
          "period": "H1",
          "source": "VERIZON",
          "corrected": false,
          "ballHandlerPlayerId": "1",
          "ballHandlerDefenderPlayerId": "2",
          "screenerPlayerIds": [
            "3"
          ],
          "screenerDefenderPlayerIds": [
            "4"
          ],
          "offensiveActions": {
            "POP": 0.4567
          },
          "defensiveActions": {
            "SWITCH": 0.9876
          },
          "endTimestamp": 1530093586410,
          "teamId": "461",
          "defenderTeamId": "462",
          "screenerX": -123,
          "screenerY": 123,
          "wing": 1,
          "videoTimeMarkStart": "01:23",
          "startGameClock": "07:23.8",
          "endGameClock": "07:22.3",
          "startShotClock": "05.7",
          "endShotClock": "04.2"
        }
      ],
      "gameTotals": {
        "awayTeamScore": {
          "teamId": "2",
          "value": 22
        },
        "homeTeamScore": {
          "teamId": "1",
          "value": 11
        },
        "period": "H2",
        "gameClock": "00:15:00",
        "status": "ACTIVE",
        "periodTotals": [
          {
            "awayTeamScore": {
              "teamId": "2",
              "value": 2
            },
            "homeTeamScore": {
              "teamId": "1",
              "value": 10
            },
            "period": "H2",
            "sessionId": "37c2cf99-05fb-11f1-8a55-0211f60c14bb"
          },
          {
            "awayTeamScore": {
              "teamId": "2",
              "value": 20
            },
            "homeTeamScore": {
              "teamId": "1",
              "value": 1
            },
            "period": "H1",
            "sessionId": "37c2cf99-05fb-11f1-8a55-0211f60c14aa"
          }
        ]
      }
    }
  • 403Forbidden
    {
      "status": 403,
      "message": "Access denied to resource",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }
  • 500Internal Server Error
    {
      "status": 500,
      "message": "<General System Error Message>",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }