Leagues

Retrieve a list of leagues.

Refresh interval

Multiple times a day

Pagination

limit and offset, 100 per page

Use the leagueName query parameter to check whether a specific league is covered, or to fetch just its record. Narrow further with countryCode or countryName, both of which come from countries.

limit sets how many leagues come back. When the number of matching leagues exceeds it, request the next page by increasing offset. See Pagination and limits.

Seasons

Each league carries a seasons list. The league information and its seasons can be used to request data from other endpoints such as standings, which requires a leagueId and a season together.

Each entry in seasons holds a numeric season, such as 2023. The same value filters matches and highlights.

Parameters

Request

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

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

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

Response

Example response

{
  "data": [
    {
      "id": 1635,
      "logo": "https://example.com/logos/league/1635.png",
      "name": "NBL",
      "country": {
        "code": "AU",
        "name": "Australia",
        "logo": "https://example.com/logos/country/AU.png"
      },
      "seasons": [
        {
          "season": 2023
        }
      ]
    }
  ],
  "pagination": {
    "totalCount": 490,
    "offset": 20,
    "limit": 100
  },
  "plan": {
    "tier": "BASIC",
    "message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
  }
}

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

Errors