NBA & NCAAB API / standings

Standings

GET https://nba.highlightly.net/standings NBA & NCAAB API
GET https://sports.highlightly.net/nba/standings All Sports API

Retrieve standings for a specific league or conference.

Refresh interval
Up to an hour after a match for the associated league and season is finished
Pagination
limit and offset

There are several ways to fetch the data. Use abbreviation or leagueName to pick the conference, leagueType to choose between NBA and NCAA, and year to choose the season.

Conferences

abbreviation is the short code and leagueName is the written out form. Either works.

Every entry carries leagueType, either NBA or NCAA. Pass leagueType to get only one of them.

League name Abbreviation
Eastern Conference EAST
Western Conference WEST
ASUN Conference A-SUN
America East Conference AEAST
American Athletic Conference AAC
Atlantic 10 Conference ATL10
Atlantic Coast Conference ACC
Big 12 Conference BIG12
Big East Conference BIGE
Big Sky Conference BSKY
Big South Conference BSOU
Big Ten Conference BIG10
Big West Conference BIGW
Coastal Athletic Association COL
Conference USA USA
Horizon League HOR
Ivy League IVY
Metro Atlantic Athletic Conference MAAC
Mid-American Conference MIDAM
Mid-Eastern Athletic Conference MEAC
Missouri Valley Conference MVC
Mountain West Conference MWEST
Northeast Conference NEAST
Patriot League PAT
Division I Independents IND
Ohio Valley Conference OVC
Pac-12 Conference PAC12
Southeastern Conference SEC
Southern Conference SOUTH
Southland Conference LAND
Southwestern Athletic Conference SWAC
Summit League SUMM
Sun Belt Conference BELT
West Coast Conference WCC
Western Athletic Conference WAC

Choosing a season

year narrows standings to a single season.

Standings rendered in a client application

Parameters

Parameter Type Description
leagueTypeoptional string No description in the spec.e.g. NCAA
limitoptional numberdefault 10 No description in the spec.e.g. 5
offsetoptional numberdefault 0 No description in the spec.e.g. 0
leagueNameoptional string No description in the spec.e.g. America East Conference
abbreviationoptional string No description in the spec.e.g. AEAST
yearoptional number No description in the spec.e.g. 2024

Request

curl --request GET \
  --url 'https://nba.highlightly.net/standings?leagueType=NCAA&leagueName=America%20East%20Conference' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const params = new URLSearchParams({
  leagueType: 'NCAA',
  leagueName: 'America East Conference'
})
const response = await fetch(`https://nba.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://nba.highlightly.net/standings',
    params={
        'leagueType': 'NCAA',
        'leagueName': 'America East Conference',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

dataNbaStandingsResponse[]required17 fields
leagueNamestringrequired
abbreviationstringrequired
dataStandingsData[]required9 fields
teamNbaTeamInfoResponserequired5 fields
idnumberrequired
displayNamestringrequired
namestringrequired
logostring
abbreviationstringrequired
statisticsStandingsStatistics[]2 fields
valuestringrequired
displayNamestringrequired
yearnumber
seasonTypestring
startDatestring
endDatestring
leagueTypestringNBANCAA
paginationPaginationResponserequired3 fields
totalCountnumberrequiredAvailable number of items, relevant to the provided query.
offsetnumberrequired
limitnumberrequired
planPlanResponserequired2 fields
tierstringrequiredYour current API subscription tier.
messagestringrequiredExplanation message regarding your current tier.

Example response

200 application/json 
{
  "data": [
    {
      "leagueName": "America East Conference",
      "abbreviation": "AEAST",
      "data": [
        {
          "team": {
            "id": 3,
            "displayName": "Denver Nuggets",
            "name": "Nuggets",
            "logo": "https://highlightly.net/nba/images/teams/3.png",
            "abbreviation": "DEN"
          },
          "statistics": [
            {
              "value": "75.0",
              "displayName": "Opponent Points Per Game"
            }
          ]
        }
      ],
      "year": 2024,
      "seasonType": "Postseason",
      "startDate": "2024-03-19T07:00:00.000Z",
      "endDate": "2024-03-19T07:00:00.000Z",
      "leagueType": "NCAA"
    }
  ],
  "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

Status Description
400 Bad request descriptive error.
500 Internal server error.