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
coverage in seasonBreakdown.
| Coverage | Includes |
|---|---|
Entire |
Regular season and post season combined. Pre season is not included. |
Season |
Regular season only. |
Pick the one that matches the question. A season including the playoffs wants
Entire, while a regular season comparison between players wants
Season, since playoff appearances are not evenly distributed.
Statistic categories
| Category | Covers |
|---|---|
| General | Overall metrics including minutes, games, fouls, shootouts and penalties. |
| Offense | Goals, shots, shootouts, assists and faceoffs. |
| Defense | Defensive impact such as saves and hits. |
| Penalties |
Penalty related metrics, including why a penalty occurred and how often the player scored or missed from the resulting situations. |
Each stat names its category. The stats returned are the ones relevant to
the player's position.
Parameters
| Parameter | Type | Description |
|---|---|---|
idrequired
|
numberpath | Requested player id. |
Request
curl --request GET \
--url 'https://nhl.highlightly.net/players/{id}/statistics' \
--header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://nhl.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://nhl.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
perSeasonNhlNcaaDetailedPlayerStatisticsPerSeason[]required14 fields
statsNhlNcaaStatEntry[]requiredRelevant stats for player position.3 fields
namestringrequired
valuenumberrequired
categorystringrequiredGeneralDefenseOffensePenalties
teamsNhlNcaaDetailedPlayerSummaryTeam[]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": 58504952,
"fullName": "Colin White",
"logo": "",
"perSeason": [
{
"stats": [
{
"name": "Total Assists",
"value": 7,
"category": "Offense"
}
],
"teams": [
{
"id": 20,
"logo": "https://highlightly.net/nhl/images/teams/20.png",
"name": "Senators",
"league": "NHL",
"displayName": "Ottawa Senators",
"abbreviation": "OTT"
}
],
"league": "Nhl",
"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. |