ShotTracker Developer

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

ShotTracker Broadcast Game Day Service

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

Authentication (Broadcast API)

An API key is required on all Broadcast API endpoints. Pass it as a query parameter or HTTP header.

→ Authentication

Games

Schedule and active game data (schedule, active game colors).

  • GET/broadcast/v1/games/scheduleSchedule

    Requests the ShotTracker game schedule. If from and to are not provided the endpoint will return all games from the time of the request to 1 day into the future. If from and to are provided the endpoint will return only the games during the timeframe. The intention of a from/to search would be in the future as the broadcast service is live and upcoming scheduled games.

  • GET/broadcast/v1/games/active/{schedule_id}/colorsActive Game Colors

    Returns the team colors for the active game. This endpoint only works with games in an ACTIVE status. It is possible to subscribe to a game before it is active which means once a game marker message is received this endpoint could be called to get the current colors set by ShotTracker game success group. The base team color (color_rgb) is returned under the teams endpoint and can be used to represent the team color however this endpoint represents the exact jersey color each team is wearing at the time of the active game.

Teams

Teams, rosters, officials, conference CSV report, and team/player images.

Stats

Game stats (test pattern, live SSE, snapshot), and player season stats.

Locomotion

Locomotion metrics and live metric stream.

  • GET/broadcast/v1/locomotionMetrics

    This endpoint returns player locomotion metrics for the game and the given team id.

    • Parameters

    • schedule_id (string) - ID of the scheduled game

    • team_id (number) - ID of the team

    • apikey (string) - The authentication key

    • Response 200 (application/json)

    {"metrics": [{"pid": "1","tid": "461","gid": "860e825e-38c2-11ea-9d3b-02422f8cbade","metrics": {"DIST_TOTAL": 167.5,"DIST_SPRINT": 56.9,"DIST_JOG": 80.4,"DIST_WALK": 30.2,"DIST_SPRINT_COUNT": 3.0,"DIST_JOG_COUNT": 5.0,"DIST_WALK_COUNT": 8.0,"ACCEL_HIGH_COUNT": 3.0,"ACCEL_MED_COUNT": 2.0,"ACCEL_LOW_COUNT": 1.0,"DECEL_HIGH_COUNT": 3.0,"DECEL_MED_COUNT": 2.0,"DECEL_LOW_COUNT": 1.0,"VELOCITY_CURR_AVG": 10.2,"VELOCITY_TOP": 12.6 } }]}

  • GET/broadcast/v1/locomotion/metric-streamLive Locomotion Metrics SSE

    Opens a Server Sent Events (SSE) connection that will remain open as long as the connection persists. This endpoint will push updated live locomotion metrics to the consumer as they occur. The schedule_id is required. If the connection drops during the game, after reconnecting, the latest locomotion metrics file will be pushed.

    See Code examples (JavaScript and Go) for connecting to this SSE endpoint.

Fan Experience

Live fan experience item stream.

Utilities

Graphics and other utility endpoints (e.g. graphic metrics).