NBA & NCAAB API / players

Get player by ID

GET https://nba.highlightly.net/players/{id} NBA & NCAAB API
GET https://sports.highlightly.net/nba/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, useful for scouting, analysis and profile display.

What the profile covers

The response is a list holding the player. Alongside id, each entry may carry fullName, logo and a profile object with the following.

Section Fields
Team team, the current team with its id, name, display name, abbreviation, league and logo.
Physical attributes height and weight.
Biography fullName, birthDate in DD.MM.YYYY format, and birthPlace.
Position position, a single object with main and abbreviation.
Draft draft, with round, year and pick.
Status jersey and isActive.

Parameters

Parameter Type Description
idrequired numberpath Requested player id.

Request

curl --request GET \
  --url 'https://nba.highlightly.net/players/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://nba.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://nba.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
profileNbaNcaaDetailedPlayerSummaryProfile21 fields
fullNamestring
birthPlacestring
birthDatestringDD.MM.YYYY format
heightstring
jerseystring
weightstring
isActiveboolean
positionNbaNcaaDetailedPlayerSummaryPositionrequired2 fields
mainstring
abbreviationstring
draftNbaNcaaDetailedPlayerSummaryDraftrequired3 fields
roundnumber
yearnumber
picknumber
teamNbaNcaaDetailedPlayerSummaryTeamrequired6 fields
idnumberrequired
logostring
namestringrequired
leaguestringrequired
displayNamestringrequired
abbreviationstringrequired

Example response

200 application/json 
[
  {
    "id": 36827,
    "fullName": "Dwight Howard",
    "logo": "",
    "profile": {
      "fullName": "Dwight Howard",
      "birthPlace": "Atlanta, GA, USA",
      "birthDate": "08.12.1985",
      "height": "6' 10\"",
      "jersey": "39",
      "weight": "265 lbs",
      "isActive": false,
      "position": {
        "main": "Center",
        "abbreviation": "C"
      },
      "draft": {
        "round": 1,
        "year": 2004,
        "pick": 1
      },
      "team": {
        "id": 4,
        "logo": "https://highlightly.net/nba/images/teams/4.png",
        "name": "Lakers",
        "league": "NBA",
        "displayName": "Los Angeles Lakers",
        "abbreviation": "LAL"
      }
    }
  }
]

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.