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/sensors/locations

GETSensor Locations

Returns an array of player and ball locations. The timeframe of the request should not exceed 30 minutes.

Parameters

NameInTypeRequiredDescription
idquerystringYesId of the session; either game half or quarter, or practice drill
fromquerynumberYesThe epoch timestamp (in milliseconds)
toquerynumberYesThe epoch timestamp (in milliseconds)

Responses

  • 200OK
    [
      {
        "locations": [
          {
            "x": 5785,
            "t": 163475794089,
            "z": 45,
            "type": "PLAYER",
            "sid": "649778d4-31db-11ec-942c-0242615ec82f",
            "y": 7930,
            "tag": "65575",
            "tid": 515,
            "speed": 0.238894,
            "pid": 6844,
            "gc": "12:30.00",
            "sc": "02.00"
          }
        ]
      },
      {
        "locations": [
          {
            "x": 5785,
            "t": 163475794589,
            "z": 45,
            "type": "PLAYER",
            "sid": "649778d4-31db-11ec-942c-0242615ec82f",
            "y": 8000,
            "tag": "65575",
            "tid": 515,
            "speed": 0.238894,
            "pid": 6844,
            "gc": "12:30.00",
            "sc": "02.00"
          }
        ]
      }
    ]
  • 400Bad Request
    {
      "status": 400,
      "message": "Valid from and to timestamps are required | Locations must be requested in 30 min timeframes",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }
  • 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"
    }