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}/videos

GETGame Videos

Use only the HLS-related fields for playback and alignment: hlsFile, hlsVideoStartTimestamp, hlsStartOffset, hlsVideoDelayMs, and hlsDuration. Other fields on each item are contextual or legacy; do not rely on them for video delivery.

The previous location-based video flow and poster URLs (posterLocation) are no longer supported—do not call or depend on location endpoints for game video, and do not use posterLocation.

Parameters

NameInTypeRequiredDescription
event_idpathstringYesID of the game event

Responses

  • 200OK
    {
      "videos": [
        {
          "gameId": "78cc1638-2858-11f1-a1d1-da3c0b3a7de9",
          "eventStartTimestamp": 1,
          "eventEndTimestamp": 2,
          "startGameClockMs": 3,
          "endGameClockMs": 4,
          "period": "H1",
          "videoStartTimestamp": 0,
          "videoEndTimestamp": 0,
          "sourceKey": {
            "source": "POSSESSION",
            "teamId": "1",
            "playerId": "2"
          },
          "sessionId": "00000000-0000-0000-0000-000000000000",
          "facilityId": "00000000-0000-0000-0000-000000000000",
          "location": "",
          "hlsVideoStartTimestamp": 0,
          "hlsStartOffset": 8,
          "hlsVideoDelayMs": 0,
          "hlsDuration": 0,
          "hlsFile": "https://localhost:1234",
          "externalStartTimestamp": 11,
          "externalEndTimestamp": 12,
          "posterLocation": ""
        }
      ]
    }
  • 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"
    }