NHL & NCAAH API / players

Get player by ID

GET https://nhl.highlightly.net/players/{id} NHL & NCAAH API
GET https://sports.highlightly.net/nhl/players/{id} All Sports API

Retrieve a detailed player summary.

Refresh interval
Once a day

The player id comes from players.

This is the profile view, suited to scouting, analysis and profile display.

What the profile covers

Next to id, fullName and logo, a player may carry a profile object with these fields.

Field Covers
team Current team, with id, logo, name, league, displayName and abbreviation.
fullName, birthDate, birthPlace Biography. birthDate follows the DD.MM.YYYY format.
height, weight Physical attributes, as strings such as 5' 11" and 191 lbs.
jersey, isActive Jersey number, and whether the player is active.
position A single object, with main such as Center and abbreviation such as C.
draft Draft round, year and pick.

Parameters

Parameter Type Description
idrequired numberpath Requested player id.

Request

curl --request GET \
  --url 'https://nhl.highlightly.net/players/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://nhl.highlightly.net/players/{id}', {
  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}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

idnumberrequired
fullNamestring
logostring
profileNhlNcaaDetailedPlayerSummaryProfile21 fields
fullNamestring
birthPlacestring
birthDatestringDD.MM.YYYY format
heightstring
jerseystring
weightstring
isActiveboolean
positionNhlNcaaDetailedPlayerSummaryPositionrequired2 fields
mainstring
abbreviationstring
draftNhlNcaaDetailedPlayerSummaryDraftrequired3 fields
roundnumber
yearnumber
picknumber
teamNhlNcaaDetailedPlayerSummaryTeamrequired6 fields
idnumberrequired
logostring
namestringrequired
leaguestringrequired
displayNamestringrequired
abbreviationstringrequired

Example response

200 application/json 
[
  {
    "id": 58504952,
    "fullName": "Colin White",
    "logo": "",
    "profile": {
      "fullName": "Bryan Berard",
      "birthPlace": "Boston, MA, USA",
      "birthDate": "30.01.1997",
      "height": "5' 11\"",
      "jersey": "16",
      "weight": "191 lbs",
      "isActive": true,
      "position": {
        "main": "Center",
        "abbreviation": "C"
      },
      "draft": {
        "round": 1,
        "year": 2015,
        "pick": 21
      },
      "team": {
        "id": 20,
        "logo": "https://highlightly.net/nhl/images/teams/20.png",
        "name": "Senators",
        "league": "NHL",
        "displayName": "Ottawa Senators",
        "abbreviation": "OTT"
      }
    }
  }
]

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.