Teams

Retrieve the teams supported by the API.

Coverage

NBA and NCAA Division I

Pagination

Not paginated

Each filter works on its own and matches the whole value, ignoring case, so den finds DEN.

Ids and abbreviations

Matches and highlights accept homeTeamAbbreviation and awayTeamAbbreviation, so those two can be filtered by abbreviation without resolving an id first.

Head to head, last five games, team statistics and get team by ID take the team id, so resolve it once here and store it.

Parameters

Request

curl --request GET \
  --url 'https://nba.highlightly.net/teams?name=Nuggets&displayName=Denver%20Nuggets' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const params = new URLSearchParams({
  name: 'Nuggets',
  displayName: 'Denver Nuggets'
})
const response = await fetch(`https://nba.highlightly.net/teams?${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://nba.highlightly.net/teams',
    params={
        'name': 'Nuggets',
        'displayName': 'Denver Nuggets',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

Example response

[
  {
    "id": 28,
    "logo": "https://highlightly.net/nba/images/teams/28.png",
    "name": "Rockets",
    "displayName": "Houston Rockets",
    "abbreviation": "HOU",
    "league": "NBA"
  }
]

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

Errors