Skip to main content

​
Base URL

https://v2.basketball.sportsapipro.com
Finding Player IDs: Use /api/search?q=lebron to find player IDs, or extract them from match lineups (/api/match/{id}/lineups) or team rosters (/api/teams/{id}/players). Example: LeBron James = 817181.

​
Player Profile

​
Player Details

GET /api/players/{playerId}
Returns player profile: name, nationality, age, height, weight, position (G/F/C), current team, and jersey number.
​
playerId
number
required
Numeric player ID (e.g., 817181 for LeBron James).

​
Player Image

GET /api/players/{playerId}/image
Returns the player’s profile photo URL.

​
Characteristics

GET /api/players/{playerId}/characteristics
Returns player traits and playing style descriptions.

​
Attribute Overviews

GET /api/players/{playerId}/attribute-overviews
Returns skill ratings for the player across various categories.

​
Last Year Summary

GET /api/players/{playerId}/last-year-summary
Returns a summary of the player’s performance over the previous season.

​
Statistics

​
Overall Statistics

GET /api/players/{playerId}/statistics
Returns career statistics: PPG, RPG, APG, FG%, 3PT%, FT%, and more.

​
Statistics Seasons

GET /api/players/{playerId}/statistics/seasons
Returns all seasons with available statistics. Use this to discover valid season IDs.

​
Career Stats by Match Type

GET /api/players/{playerId}/statistics/match-type?type={type}
Returns career statistics filtered by match type.

​
Tournament Season Statistics

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/statistics?type={type}
Returns player statistics for a specific tournament and season.
​
type
string
default:"overall"
Filter: overall, home, or away.

​
Season Ratings

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/ratings?type={type}
Returns game-by-game player ratings throughout the season.

​
Season Summary

GET /api/players/{playerId}/tournament/{tournamentId}/season/{seasonId}/summary
Returns a season summary for the player.

​
National Team Statistics

GET /api/players/{playerId}/national-team-statistics
Returns international career statistics.

​
Events

​
Last Events (Paginated)

GET /api/players/{playerId}/events/last/{page}
Returns the player’s most recent games with stats, paginated.
​
page
number
required
Page number (0-indexed).

​
Next Events (Paginated)

GET /api/players/{playerId}/events/next/{page}
Returns upcoming scheduled games for the player’s team.

​
Transfer & Career

​
Transfer History

GET /api/players/{playerId}/transfer-history
Returns complete team history: trades, signings, and contract changes.

​
Unique Tournaments

GET /api/players/{playerId}/unique-tournaments
Returns all competitions the player has participated in.

​
Media

​
Media

GET /api/players/{playerId}/media
Returns media content associated with the player.

​
Media Videos

GET /api/players/{playerId}/media/videos
Returns video highlights and clips featuring the player.

​
Example Requests

curl -X GET "https://v2.basketball.sportsapipro.com/api/players/817181/statistics" \
  -H "x-api-key: YOUR_API_KEY"