Player statistics

GET https://nba.highlightly.net/players/{id}/statistics NBA & NCAAB API
GET https://sports.highlightly.net/nba/players/{id}/statistics All Sports API

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.

Player statistics rendered in a client application

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

200 application/json
[
  {
    "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.