Skip to main content

​
Base URL

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

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

​
Player Image

Returns the player’s profile photo URL.

​
Characteristics

Returns player traits and playing style descriptions.

​
Last Year Summary

Returns a summary of the player’s performance over the previous season.

​
Statistics

​
Seasonal Aggregate Statistics

Returns seasonal aggregate statistics: one entry per season, per competition, and per stage (regular season and playoffs are separate entries), each with the team, uniqueTournament and season attached. For LeBron James (817181) this returns 45 season entries covering his career. Fields per entry:
  • Volume: appearances, secondsPlayed, points, assists, rebounds, offensiveRebounds, defensiveRebounds, steals, blocks, turnovers, personalFouls, plusMinus
  • Shooting: fieldGoalsMade / fieldGoalAttempts, twoPointsMade / twoPointAttempts, threePointsMade / threePointAttempts, freeThrowsMade / freeThrowAttempts, plus fieldGoalsPercentage, twoPointsPercentage, threePointsPercentage, freeThrowsPercentage
  • Advanced: effectiveFieldGoalPercentage, trueShootingPercentage, usage, possession, individualOffensiveRating, individualDefensiveRating, playerEfficiencyRating, assistTurnoverRatio, doubleDoubles, tripleDoubles, rating
Values are season totals, not averages. Derive per-game numbers with appearances:
  • PPG = points / appearances
  • RPG = rebounds / appearances
  • APG = assists / appearances
Verified example — NBA 2025/26 regular season, LeBron James: 60 appearances, 1,256 points, 432 assists, 364 rebounds → 20.9 PPG, 7.2 APG, 6.1 RPG.

​
Statistics Seasons

Returns every competition and season with available statistics. Use this to discover valid season IDs.

​
Career Stats by Match Type

Returns career aggregate statistics filtered by match type.
​
string
default:"overall"
Filter: overall, home, or away.

​
Season Ratings

Returns game-by-game player ratings throughout one season (seasonRatings, each entry linked to its eventId).
Basketball V2 has no per-tournament/per-season player statistics endpoint and no season-wide leaderboard. Use /api/players/{playerId}/statistics, which already breaks results down per competition and season.For league stat leaders in one request, use V1 instead: GET /v1/basketball/competition/{competitionId}/stats returns seven player leader tables (top 20 each) plus ten team tables. See V1 Competitions — basketball stat leaders.

​
National Team Statistics

Returns international career statistics.

​
Events

​
Last Events (Paginated)

Returns the player’s most recent games with stats, paginated.
​
number
required
Page number (0-indexed).

​
Next Events (Paginated)

Returns upcoming scheduled games for the player’s team.

​
Transfer & Career

​
Transfer History

Returns complete team history: trades, signings, and contract changes.

​
Unique Tournaments

Returns all competitions the player has participated in.

​
Media

​
Media

Returns media content associated with the player.

​
Media Videos

Returns video highlights and clips featuring the player.

​
Example Requests

Last modified on September 23, 2026