Standings

Retrieve standings for a specific league, conference or division.

Refresh interval

Up to an hour after a match for the associated league and season is finished

Pagination

Not paginated

Standings refresh up to an hour after a match for the associated league and season is finished. For the score of a just finished game, use matches.

Groups

Standings come back as a list of groups, each with a name such as Regular Season and its own standings list. The same endpoint serves a league, a conference or a division.

Alongside groups, the response carries the league the table belongs to, with its id, name, season and, when present, logo.

What each row carries

Each row holds the team, its position, gamesPlayed, wins and loses, and scoredPoints and receivedPoints. The team carries an id, a name and, when present, a logo.

Parameters

Request

curl --request GET \
  --url 'https://basketball.highlightly.net/standings?leagueId=2486&season=2023' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const params = new URLSearchParams({
  leagueId: '2486',
  season: '2023'
})
const response = await fetch(`https://basketball.highlightly.net/standings?${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/standings',
    params={
        'leagueId': '2486',
        'season': '2023',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

Example response

{
  "groups": [
    {
      "name": "Regular Season",
      "standings": [
        {
          "team": {
            "id": 14400,
            "logo": "https://example.com/logos/team/14400.png",
            "name": "Monaco"
          },
          "wins": 28,
          "loses": 4,
          "position": 1,
          "gamesPlayed": 32,
          "scoredPoints": 2759,
          "receivedPoints": 2383
        }
      ]
    }
  ],
  "league": {
    "id": 2486,
    "logo": "https://example.com/logos/league/2486.png",
    "name": "LNB",
    "season": 2023
  }
}

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

Errors