NBA & NCAAB API
The Highlightly NBA & NCAAB API provides real time basketball data including live scores, video highlights, box scores, player statistics and profiles, lineups, standings, predictions, head to head data and live game events.
Coverage spans the NBA regular season, playoffs, Finals, Play-In Tournament and NBA Cup, plus NCAA Division I conferences including March Madness.
- Base URL
- nba.highlightly.net
- Endpoints
- 19
- Format
- JSON only
- Version
- 4.1.4
Also available with an All Sports API subscription at
sports.highlightly.net/nba.
See base URLs.
Where to start
Read Authentication first, since every request needs an API key. Pagination and limits covers paging and how your plan affects results.
| If you want | Start at |
|---|---|
| Dunks, three pointers and game recaps | Highlights |
| Schedules, live scores and game detail | Matches |
| Conference tables | Standings |
| Per player scoring, rebounds and assists | Box score |
NBA and college in one API
league is a closed set of two values,
NBA and NCAA. It appears on teams and
matches, and as leagueType on standings. Filter on it
when your product covers only one of them, since the same endpoints
serve both.
Base URLs
NBA and college basketball data is available two ways. An NBA & NCAAB API subscription covers this API alone. An All Sports API subscription covers it and all other Highlightly sports under one key. Either one can be bought directly from Highlightly or through RapidAPI, which gives four base URLs.
| Subscription | Platform | Base URL |
|---|---|---|
| NBA & NCAAB API | Highlightly | https://nba.highlightly.net |
| NBA & NCAAB API | RapidAPI | https://nba-ncaab-api.p.rapidapi.com |
| All Sports API | Highlightly | https://sports.highlightly.net/nba |
| All Sports API | RapidAPI |
https://sport-highlights-api.p.rapidapi.com/nba
|
Every endpoint in this reference is available on all four. On Highlightly, one API key works for every product, and the data returned depends on your subscription to that product. On RapidAPI, each product is separate and needs its own API key.
To call an endpoint, append its path to your base URL.
/matches becomes
https://nba.highlightly.net/matches with an NBA &
NCAAB API subscription and
https://sports.highlightly.net/nba/matches with an All
Sports API subscription. Parameters, responses and refresh intervals
are the same on both, and every endpoint page shows both routes.
Your plan affects the data retrieved. The Basic/Free plan might have certain restrictions on highlights, and odds and geo restrictions are not available in the Basic/Free plan. This applies with either subscription. See Pagination and limits.
What changes with an All Sports API subscription
The headers have the same names on every base URL.
x-rapidapi-key is sent with every request, and
x-rapidapi-host is sent only when calling through
RapidAPI. What changes is the path and the host header, and on
RapidAPI the key.
| NBA & NCAAB API | All Sports API | |
|---|---|---|
| Path | /matches |
/nba/matches |
x-rapidapi-key on Highlightly |
Your Highlightly API key | Your Highlightly API key |
x-rapidapi-key on RapidAPI |
Your NBA & NCAAB API key | Your All Sports API key |
x-rapidapi-host |
nba-ncaab-api.p.rapidapi.com |
sport-highlights-api.p.rapidapi.com |
On Highlightly, the same API key works on
nba.highlightly.net and
sports.highlightly.net, and the data returned depends
on your subscription to each product. On RapidAPI, the NBA &
NCAAB API and the All Sports API are separate products, so each
needs its own API key. One All Sports API quota covers every sport
you call. See
All Sports authentication.
Highlightly or RapidAPI
Both platforms give you analytics, billing settings and key management. RapidAPI does not offer custom plans or long term plan discounts.
Create an account at Highlightly or through RapidAPI. Plans and limits are listed on the NBA API page and the All Sports API page.
OpenAPI specification
Import the OpenAPI 3.0 document into Postman or Insomnia, or generate a client from it.
Download docs.jsonSupport
For feature requests, questions, private plans or business enquiries, contact [email protected]. You can also start a discussion or send a private message through RapidAPI.
