Player statistics
Retrieve detailed statistics for one player.
- Refresh interval
- Once a day
- Aggregation
- Per season
The player id comes from players.
Per season
Statistics are aggregated per season in perSeason. Each entry names its
league and season, lists the teams the player
played for, and states its coverage in seasonBreakdown.
| Coverage | Includes |
|---|---|
Entire |
Regular season and post season combined. Pre season is not included. |
Season |
Regular season only. |
Each entry covers a single season.
Statistic categories
Each entry in stats carries a name, a numeric
value and a category. The statistics returned are the ones
relevant to the player's position.
| Category | Covers |
|---|---|
General |
Minutes, games, fouls, rebounds, ratios such as assist to turnover and steal to foul, player rating, and per game or per 48 minute averages. |
Offense |
Points, assists, field goals, three pointers, free throws, turnovers, efficiency ratings and offensive rebound measures. |
Defense |
Steals, blocks, defensive rebounds, and their per game and per 48 minute rates. |
Parameters
| Parameter | Type | Description |
|---|---|---|
idrequired
|
numberpath | Requested player id. |
Request
curl --request GET \
--url 'https://nba.highlightly.net/players/{id}/statistics' \
--header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://nba.highlightly.net/players/{id}/statistics', {
headers: {
'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
}
})
if (!response.ok) {
throw new Error(`Highlightly responded ${response.status}`)
}
const data = await response.json()
import os
import requests
response = requests.get(
'https://nba.highlightly.net/players/{id}/statistics',
headers={
'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
},
timeout=10,
)
response.raise_for_status()
data = response.json()
Response
idnumberrequired
fullNamestring
logostring
perSeasonNbaNcaaDetailedPlayerStatisticsPerSeason[]required14 fields
statsNbaNcaaStatEntry[]requiredRelevant stats for player position.3 fields
namestringrequired
valuenumberrequired
categorystringrequiredGeneralDefenseOffense
teamsNbaNcaaDetailedPlayerSummaryTeam[]requiredTeams for which the player played in a given season.6 fields
idnumberrequired
logostring
namestringrequired
leaguestringrequired
displayNamestringrequired
abbreviationstringrequired
leaguestringrequired
seasonnumberrequired
seasonBreakdownstringrequiredRepresents the coverage for the stored statistics. Pre-season is never
included.EntireSeason
Example response
[
{
"id": 36827,
"fullName": "Dwight Howard",
"logo": "",
"perSeason": [
{
"stats": [
{
"name": "Total Fouls",
"value": 115,
"category": "Offense"
}
],
"teams": [
{
"id": 4,
"logo": "https://highlightly.net/nba/images/teams/4.png",
"name": "Lakers",
"league": "NBA",
"displayName": "Los Angeles Lakers",
"abbreviation": "LAL"
}
],
"league": "NBA",
"season": 2022,
"seasonBreakdown": "Entire"
}
]
}
]
Values are the examples declared in the OpenAPI spec, not a captured live response.
Errors
| Status | Description |
|---|---|
400 |
Bad request descriptive error. |
500 |
Internal server error. |