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/teams/{team_id},{reference}

GETTeam Roster

The current active players on the team. The game_event_id parameter can be used to look up all of the players on the team at the time of a game. Players who are no longer on the team will have an 'is_active' false. The special_services field returns items for specific special events; possible type values are MIC, VIDEO.

Basketball Player Positions

AbbreviationDescription
GGUARD
FFORWARD
CCENTER

Parameters

NameInTypeRequiredDescription
team_idpathnumberYesID of the team
game_event_idquerystringNoID of the game
referencepathstringYesindicates the system of origin for IDs passed in the query; default: SHOTTRACKER

Responses

  • 200OK
    {
      "id": 46,
      "name": "Test Team",
      "gender": "MEN",
      "conference_name": "ACC",
      "league_name": "NCAA",
      "sport": "BASKETBALL",
      "reference_id": "938104592",
      "logo_image_link": "...",
      "team_images": {
        "logo_small_light": "...",
        "logo_small_dark": "...",
        "logo_small_light_transparent": "...",
        "logo_small_dark_transparent": "...",
        "logo_light": "...",
        "logo_dark": "...",
        "logo_light_transparent": "...",
        "logo_dark_transparent": "..."
      },
      "players": [
        {
          "id": 1,
          "first_name": "john",
          "last_name": "doe",
          "jersey_number": 1,
          "jersey_number_str": "1",
          "position": "center",
          "profile_image_link": "...",
          "display_name": "john doe",
          "is_active": true,
          "special_services": [
            {
              "type": "MIC",
              "value": "mic6"
            }
          ],
          "reference_id": "42589513",
          "sensor": 100630,
          "is_starter": true,
          "is_scout": false,
          "team_player_images": {
            "image_light": "...",
            "image_dark": "...",
            "image_light_transparent": "...",
            "image_dark_transparent": "...",
            "headshot_light": "...",
            "headshot_dark": "...",
            "headshot_transparent": "...",
            "image_profile": "..."
          }
        }
      ]
    }
  • 403Forbidden
    {
      "status": 403,
      "message": "Restricted resource",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }
  • 404Not Found
    {
      "status": 404,
      "message": "Game not found | Team not found in game",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }
  • 500Internal Server Error
    {
      "status": 500,
      "message": "<General System Error Message>",
      "shottrackerRequestId": "f1e80480-e1d5-4684-a619-402984b5c9ba"
    }