Team statistics

Retrieve a team's statistics for each 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 location. It defaults to Etc/UTC.

One entry per league and season

The response is a list with one entry for every league and season the team has statistics in. Each entry names its league through leagueId, leagueName and season, so a team playing a domestic league and a cup comes back as separate entries.

Total, home and away

Each entry splits its statistics into three sets. total covers every game in 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, loses and draws, and points holds scored and received. So a home and away split needs no second request and no arithmetic on your side.

points here are match points, the figures that make up a scoreline, not competition table points.

Parameters

Request

curl --request GET \
  --url 'https://rugby.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://rugby.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://rugby.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": 16,
        "wins": 11,
        "loses": 5,
        "draws": 0
      },
      "points": {
        "scored": 463,
        "received": 344
      }
    },
    "home": {
      "games": {
        "played": 8,
        "wins": 5,
        "loses": 0,
        "draws": 3
      },
      "points": {
        "scored": 229,
        "received": 172
      }
    },
    "away": {
      "games": {
        "played": 8,
        "wins": 5,
        "draws": 0,
        "loses": 3
      },
      "points": {
        "scored": 234,
        "received": 172
      }
    },
    "leagueId": 38228,
    "leagueName": "Major League Rugby",
    "season": "Major League Rugby"
  }
]

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

Errors