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. That list is what makes this endpoint the entry point for most queries, since standings requires a leagueId and a season together, and this is where you learn which seasons a league has.

Seasons are years, so 2023. The same value filters matches and highlights.

Parameters

Request

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

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

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

Response

Example response

{
  "data": [
    {
      "id": 83331,
      "logo": "https://example.com/logos/league/83331.png",
      "name": "SuperLega",
      "country": {
        "code": "IT",
        "name": "Italy",
        "logo": "https://example.com/logos/country/IT.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