NFL & NCAAF API / players

Get player by ID

GET https://american-football.highlightly.net/players/{id} NFL & NCAAF API
GET https://sports.highlightly.net/american-football/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

Each player carries an id and may also carry fullName, logo and a profile object with these fields.

Field Covers
team Current team, with id, name, displayName, abbreviation, league and logo.
height, weight Physical attributes as text, such as 6' 4" and 225 lbs.
fullName, birthDate, birthPlace Biography. birthDate uses the DD.MM.YYYY format.
position One position, with main such as Quarterback and abbreviation such as QB.
jersey Jersey number, as text.
isActive Whether the player is active.
draft Draft round, year and pick.

Parameters

Parameter Type Description
idrequired numberpath Requested player id.

Request

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

Example response

200 application/json 
[
  {
    "id": 36017,
    "fullName": "Tom Brady",
    "logo": "",
    "profile": {
      "fullName": "Tom Brady",
      "birthPlace": "San Mateo, CA, USA",
      "birthDate": "03.08.1977",
      "height": "6' 4\"",
      "jersey": "12",
      "weight": "225 lbs",
      "isActive": false,
      "position": {
        "main": "Quarterback",
        "abbreviation": "QB"
      },
      "draft": {
        "round": 6,
        "year": 2000,
        "pick": 199
      },
      "team": {
        "id": 92734,
        "logo": "https://highlightly.net/american-football/images/teams/92734.png",
        "name": "Buccaneers",
        "league": "NFL",
        "displayName": "Tampa Bay Buccaneers",
        "abbreviation": "TB"
      }
    }
  }
]

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.