basketballapi.net
NewTry it in the docs Sign in Get a free keyFree key

Documentation / Guides

Players

Finding a player, their details and honours, their game log and their averages season by season.

What it covers

  • Finding players by part of a name (3 letters or more) or by team, with the games each played and their last team.
  • One player: birth date, height, weight and country where known, the teams played for and their honours.
  • Their game log, one box line per game, and their averages in each season, team and competition.
  • Splits: averages home and away, by result, month, opponent or starting role.

Players are on Live and up.

How the records link

  • A player id (pl_) comes from Find players, a box score or a roster.
  • Each game log line names its game (gm_), which opens the full box score and play by play.

Common jobs

Find a player

GET https://api.basketballapi.net/v1/players?q=smith

Their last games

GET https://api.basketballapi.net/v1/players/{id}/games

Season by season

GET https://api.basketballapi.net/v1/players/{id}/seasons

Home and away

GET https://api.basketballapi.net/v1/players/{id}/splits?by=venue

Endpoints in this guide

/v1/playersFind players by name or team, with the games they played and their last team. Send q (3 letters or more) or team. /v1/players/{id}One player, with the teams played for. /v1/players/{id}/gamesA player's game log: one box line per game. /v1/players/{id}/seasonsA player's averages in each season, team and competition played. /v1/players/{id}/splitsA player's averages split home and away, by result, month, opponent or starting role.