Get league by ID
GET
https://soccer.highlightly.net/leagues/{id}
Football API
Retrieve one league by its id.
Use this to check whether a league you have stored still exists, or whether its information has been updated since you fetched it.
The response includes the league's seasons, which standings needs alongside the id.
Parameters
| Parameter | Type | Description |
|---|---|---|
idrequired
|
numberpath | Requested league id. |
Request
curl --request GET \
--url 'https://soccer.highlightly.net/leagues/{id}' \
--header 'x-rapidapi-key: YOUR_API_KEY'const response = await fetch('https://soccer.highlightly.net/leagues/{id}', {
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://soccer.highlightly.net/leagues/{id}',
headers={
'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
},
timeout=10,
)
response.raise_for_status()
data = response.json()Response
idnumberrequired
logostring
namestringrequired
countryCountryResponserequired3 fields
codestringrequiredCountry code specified by the ISO 3166 standard.
namestringrequired
logostringrequired
seasonsSeasonResponse[]required1 field
seasonnumberrequired
Example response
200 application/json
[
{
"id": 104,
"logo": "https://example.com/logos/league/104.png",
"name": "UEFA Champions League",
"country": {
"code": "FR",
"name": "France",
"logo": "https://example.com/logos/country/FR.png"
},
"seasons": [
{
"season": 2022
}
]
}
]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. |
Using a league id
League ids come from leagues. These endpoints accept one.
| Endpoint | Parameter |
|---|---|
| Highlights | leagueId |
| Matches | leagueId |
| Odds | leagueId |
| Standings | leagueId |
