Team statistics

GET https://volleyball.highlightly.net/teams/statistics/{id} Volleyball API
GET https://sports.highlightly.net/volleyball/teams/statistics/{id} All Sports API

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

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 down based on your location.

One entry per league and season

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.

Total, home and away

Each entry splits its statistics into three blocks. total is the full record for that league and season, home covers matches played as the home team and away covers matches played as the away team.

Each block 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 and no arithmetic on your side.

Parameters

Parameter Type Description
idrequired numberpath Requested team id.
fromDaterequired string Date that follows the YYYY-MM-DD format.e.g. 2023-08-06
timezoneoptional stringdefault Etc/UTC Valid timezone identifier.e.g. Europe/London

Request

curl --request GET \
  --url 'https://volleyball.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://volleyball.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://volleyball.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

totalVolleyballTeamTotalStatsResponserequiredTotal game and points statistics corresponding to specific league-season.7 fields
gamesVolleyballTeamTotalGameStatsResponserequiredNumber of games team has played, won, and lost during a specific league-season.3 fields
playednumberrequiredNumber of games team has played during a specific league-season.
winsnumberrequiredNumber of games team has won during a specific league-season.
losesnumberrequiredNumber of games team has lost during a specific league-season.
pointsVolleyballTeamTotalPointsStatsResponserequiredNumber of points team has scored, and received during a specific league-season.2 fields
scorednumberrequiredNumber of points team has scored during a specific league-season.
receivednumberrequiredNumber of points team has received during a specific league-season.
homeVolleyballTeamHomeStatsResponserequiredGame and point statistics corresponding to specific league-season, where the team has played as a home team.7 fields
gamesVolleyballTeamHomeGameStatsResponserequiredNumber of games team has played, won, and lost during a specific league-season, whilst playing as home team.3 fields
playednumberrequiredNumber of games team has played as home team during a specific league-season.
winsnumberrequiredNumber of games team has won as home team during a specific league-season.
losesnumberrequiredNumber of games team has lost as home team during a specific league-season.
pointsVolleyballTeamHomePointsStatsResponserequiredNumber of points team has scored and received, during a specific league-season, whilst playing as away team.2 fields
scorednumberrequiredNumber of points team has scored whilst playing as home team during a specific league-season.
receivednumberrequiredNumber of points team has received whilst playing as home team during a specific league-season.
awayVolleyballTeamAwayStatsResponserequiredGame and point statistics corresponding to specific league-season, where the team has played as an away team.7 fields
gamesVolleyballTeamAwayGameStatsResponserequiredGame related statistics team has played as away team, during a specific league-season.3 fields
playednumberrequiredNumber of games team has played as away team during a specific league-season.
winsnumberrequiredNumber of games team has won as away team during a specific league-season.
losesnumberrequiredNumber of games team has lost as away team during a specific league-season.
pointsVolleyballTeamAwayPointsStatsResponserequiredNumber of points team has scored and received as away team, during a specific league-season.2 fields
scorednumberrequiredNumber of points team has scored as away team, during a specific league-season.
receivednumberrequiredNumber of points team has received as away team, during a specific league-season.
leagueIdnumberrequiredLeague id to which team statistics are associated.
leagueNamestringrequiredLeague name to which team statistics are associated.
seasonnumberrequiredSeason year to which team statistics are associated.

Example response

200 application/json
[
  {
    "total": {
      "games": {
        "played": 31,
        "wins": 13,
        "loses": 18
      },
      "points": {
        "scored": 47,
        "received": 13
      }
    },
    "home": {
      "games": {
        "played": 14,
        "wins": 8,
        "loses": 6
      },
      "points": {
        "scored": 26,
        "received": 28
      }
    },
    "away": {
      "games": {
        "played": 17,
        "wins": 5,
        "loses": 12
      },
      "points": {
        "scored": 21,
        "received": 45
      }
    },
    "leagueId": 83331,
    "leagueName": "SuperLega",
    "season": 2023
  }
]

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.