Team statistics

Retrieve a team's statistics for each league and season it has played.

Refresh interval

Immediately once a match is finished

The team id comes from teams.

fromDate is required and must follow the YYYY-MM-DD format. timezone is optional, defaults to Etc/UTC, and narrows the results based on your location.

Total, home and away

Statistics arrive in three sets rather than one. total is the team's record for that league and season, home covers games played as the home team and away games played as the away team.

Each set is shaped the same way. games holds played, wins and loses, and goals holds scored and received. So a home and away split needs no second request and no arithmetic on your side.

The response is a list with one entry per league and season. Each entry names the league its figures belong to through leagueId, leagueName and season.

Parameters

Request

curl --request GET \
  --url 'https://hockey.highlightly.net/teams/statistics/{id}?fromDate=2023-08-06' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const params = new URLSearchParams({
  fromDate: '2023-08-06'
})
const response = await fetch(`https://hockey.highlightly.net/teams/statistics/{id}?${params}`, {
  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://hockey.highlightly.net/teams/statistics/{id}',
    params={
        'fromDate': '2023-08-06',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

Example response

[
  {
    "total": {
      "games": {
        "played": 114,
        "wins": 72,
        "loses": 42
      },
      "goals": {
        "scored": 366,
        "received": 283
      }
    },
    "home": {
      "games": {
        "played": 58,
        "wins": 38,
        "loses": 20
      },
      "goals": {
        "scored": 186,
        "received": 141
      }
    },
    "away": {
      "games": {
        "played": 56,
        "wins": 34,
        "loses": 22
      },
      "goals": {
        "scored": 180,
        "received": 142
      }
    },
    "leagueId": 49291,
    "leagueName": "NHL",
    "season": 2023
  }
]

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

Errors