Team statistics

Retrieve a team's statistics for each league and season. The response is an array with one entry per league and season.

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. Add timezone to narrow the results based on your own location rather than UTC.

Total, home and away

Each entry holds three sets rather than one. total is the full record for that league and season, home covers games played as the home team and away covers games played as the away team.

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

Each entry also names the league and season its figures belong to through leagueId, leagueName and season.

Parameters

Request

curl --request GET \
  --url 'https://basketball.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://basketball.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://basketball.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": 42,
        "wins": 36,
        "loses": 6
      },
      "points": {
        "scored": 3722,
        "received": 3328
      }
    },
    "home": {
      "games": {
        "played": 22,
        "wins": 20,
        "loses": 2
      },
      "points": {
        "scored": 2015,
        "received": 1733
      }
    },
    "away": {
      "games": {
        "played": 20,
        "wins": 16,
        "loses": 4
      },
      "points": {
        "scored": 1707,
        "received": 1595
      }
    },
    "leagueId": 100351,
    "leagueName": "ACB",
    "season": 2023
  }
]

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

Errors