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 has a league, a season, the teams the player played for, its stats, and a seasonBreakdown giving its coverage.

Pick the one that matches the question. A season including playoffs wants Entire, while a regular season comparison between players wants Season.

Statistics depend on position

Each entry in stats has a name, a value and a category. The nine categories below are not all populated for every player. Which ones appear depends on the position they play, so a quarterback carries passing and a kicker carries kicking.

Build a profile around the categories that are present rather than assuming a fixed set, otherwise a running back's page shows empty passing and kicking sections.

Parameters

Request

curl --request GET \
  --url 'https://american-football.highlightly.net/players/{id}/statistics' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const response = await fetch('https://american-football.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://american-football.highlightly.net/players/{id}/statistics',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

Example response

[
  {
    "id": 36017,
    "fullName": "Tom Brady",
    "logo": "",
    "perSeason": [
      {
        "stats": [
          {
            "name": "Total Rushing Yardage",
            "value": 4693,
            "category": "Rushing"
          }
        ],
        "teams": [
          {
            "id": 92734,
            "logo": "https://highlightly.net/american-football/images/teams/92734.png",
            "name": "Buccaneers",
            "league": "NFL",
            "displayName": "Tampa Bay Buccaneers",
            "abbreviation": "TB"
          }
        ],
        "league": "NFL",
        "season": 2022,
        "seasonBreakdown": "Entire"
      }
    ]
  }
]

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors