MLB & NCAA API / players

Get player by ID

GET https://baseball.highlightly.net/players/{id} MLB & NCAA API
GET https://sports.highlightly.net/baseball/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 profile object gives a structured view of a player's personal and professional standing.

Field Covers
team Current team affiliation, as one team object.
height, weight Physical attributes, as display strings.
fullName, birthDate, birthPlace Biography. birthDate is in DD.MM.YYYY format.
jersey Jersey number.
isActive Whether the player is active.
debut Debut year.
position One object with the main position and its abbreviation.

Parameters

Parameter Type Description
idrequired numberpath Requested player id.

Request

curl --request GET \
  --url 'https://baseball.highlightly.net/players/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://baseball.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://baseball.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
profileBaseballDetailedPlayerSummaryProfile18 fields
fullNamestring
birthPlacestring
birthDatestringDD.MM.YYYY format
heightstring
jerseystring
weightstring
isActiveboolean
debutnumberPlayer debut year
positionBaseballDetailedPlayerSummaryPositionrequired2 fields
mainstring
abbreviationstring
teamBaseballDetailedPlayerSummaryTeamrequired6 fields
idnumberrequired
logostring
namestringrequired
leaguestringrequired
displayNamestringrequired
abbreviationstringrequired

Example response

200 application/json 
[
  {
    "id": 342182,
    "fullName": "Reese Albert",
    "logo": "",
    "profile": {
      "fullName": "Reese Albert",
      "birthPlace": "Jupiter, FL, United States",
      "birthDate": "10.07.1999",
      "height": "6' 2\"",
      "jersey": "",
      "weight": "190 lbs",
      "isActive": true,
      "debut": 0,
      "position": {
        "main": "Unknown",
        "abbreviation": "UN"
      },
      "team": {
        "id": 10291561,
        "logo": "https://highlightly.net/baseball/images/teams/10291561.png",
        "name": "Seminoles",
        "league": "MLB",
        "displayName": "Florida State",
        "abbreviation": "FSU"
      }
    }
  }
]

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.