Basketball API
The Basketball API covers the NBA, the WNBA and Division I men's and women's college basketball: get schedules, live scores with the period and game clock on paid plans, final scores by period with every overtime, standings with playoff seeds or conference tables, the weekly college polls, and every team's roster. Pick the league with league=nba, league=wnba, league=ncaab (men's college) or league=ncaaw (women's college). The free plan covers the current season of each league: schedules, final scores, standings and rosters.
League guides: NBA API, WNBA API, College Basketball API and Women's College Basketball API. One API key works for every sports API.
Leagues
| League | What you get | League value |
|---|---|---|
| NBA | Schedules, live and final scores by quarter, play-in and playoffs, standings, teams and rosters | nba |
| WNBA | Schedules, live and final scores by quarter, Commissioner's Cup final and playoffs, standings by conference, teams and rosters | wnba |
| College Basketball | Division I men: schedules, live and final scores by half, conference tournaments, the NCAA tournament with seeds, conference standings, AP and Coaches polls, rosters | ncaab |
| Women's College Basketball | Division I women: schedules, live and final scores by quarter, conference tournaments, the NCAA tournament with seeds, conference standings, AP and Coaches polls, rosters | ncaaw |
https://api.api-ninjas.com/v1/basketballgames
Returns schedules, live scores and final scores. Ask for one day, a team's season or one game; with only league you get today's games. Paid plans see games in progress with the score, period and clock updated throughout the game; the free plan sees their status and the final score once they end. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Parameters
Provide league, unless you pass game_id or a team id such as nba-bos.
leagueoptionalnba,wnba,ncaaborncaaw.dateoptionalGame day in the league's home time zone (YYYY-MM-DD). Defaults to today when no team or season is given.
teamoptionalTeam id, abbreviation or name (e.g.
BOS): that team's games in the season.seasonoptionalSeason, as the year it starts (
2026= the 2026-27 NBA season). Defaults to the current season. On its own, returns the season's games 50 per page; useoffsetfor the next page.season_typeoptionalOnly games of this part of the season.
statusoptionalOnly games with this status.
game_idoptionalReturn one game.
limitoptional Premium onlyGames per page (1-500). Default
50.offsetoptionalGames to skip, for paging. Default
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/basketballgames endpoint returns a JSON array of games in start order, or an error.
game_idUnique id of the game, e.g.
nba-20261022-cle-phi. It never changes, even when a game is moved to another date.leaguenba,wnba,ncaaborncaaw.sportAlways
basketball.seasonSeason, as the year it starts:
2026is the 2026-27 NBA and college seasons and the 2026 WNBA season.season_labelDisplay form of the season, e.g.
2026or2026-27.season_typepreseason,regular,cup_final(the NBA Cup championship game and the WNBA Commissioner's Cup final, which do not count in the standings),play_in(NBA),conference_tournament(college conference tournaments) orpostseason(the playoffs; the NCAA tournament, the NIT and the other college postseason tournaments).eventCollege only: the tournament, bowl or round, e.g.
SEC Championship,Rose Bowl Game,Big East Tournament - QuarterfinalorNCAA Men's Basketball Championship - West Region - 1st Round.nullfor most regular-season games.conference_gameCollege only:
truewhen the game counts in the conference standings.dateGame day in US Eastern time (YYYY-MM-DD), so a West Coast night game keeps its US date.
start_timeScheduled start in UTC (ISO 8601).
statusscheduled,in_progress,final,postponed,canceled,suspended(including abandoned soccer matches) ordelayed(e.g. a baseball rain delay).status_detailPremium onlyDuring a game:
halftimeorend_of_period. Otherwisenull. While a game is in progress, the free plan seesThis field is for premium subscribers only.periodLive values: PremiumCurrent quarter, or the last one played once the game is final. Quarters, except halves in men's college basketball (and in women's college basketball before 2015-16). Each overtime period continues the count (
5,6, ... after four quarters). While a game is in progress, the free plan seesThis field is for premium subscribers only.clockPremium onlyWhile a game is in progress: time left in the quarter, e.g.
5:33. The free plan seesThis field is for premium subscribers only.home_team, away_teamThe teams:
team_id,nameandabbreviation, named as they were that season (e.g. the New Orleans Hornets or the Charlotte Bobcats). College games add each team'srank(its Top 25 rank at game time: the AP poll, and in college football the College Football Playoff ranking once it is published) andseed(in NCAA tournament and College Football Playoff games); both arenullotherwise. Opponents from outside Division I have ateam_idand name, but the teams endpoint does not list them.home_score, away_scoreLive values: PremiumCurrent or final score (points);
nullbefore the game starts. While a game is in progress, the free plan seesThis field is for premium subscribers only.period_scoresLive values: PremiumScore per quarter (half in men's college basketball) for
homeandaway, with each overtime period. While a game is in progress, the free plan seesThis field is for premium subscribers only.decided_inFor final games:
regulationorovertime.winnerteam_idof the winner once the game is final;nullbefore that.venueWhere the game is played:
name,city,stateandcountry(ISO 3166-1 alpha-2).neutral_sitetruewhen neither team is at home, e.g. international games and most college tournament games.original_dateFor a game moved to another date: the date it was first scheduled for. Otherwise
null.updated_atWhen any field of the game last changed (UTC).
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/basketballgames?league=nba" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/basketballstandings
Returns the league table for a season, ordered by league rank, or by conference or division rank when you filter; college tables come conference by conference. For college, poll returns a weekly poll instead: the AP Top 25 or the Coaches Poll. Tables update throughout the season, shortly after each game ends. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Parameters
leaguerequirednba,wnba,ncaaborncaaw.seasonoptionalSeason, as the year it starts. Defaults to the current season.
conferenceoptionalOnly this conference, e.g.
Eastern.divisionoptionalOnly this division, e.g.
Atlantic(NBA).polloptionalCollege: return this poll instead of the table:
aporcoaches.weekoptionalWith
poll: the poll of this week of the season, orfinalfor the final poll. Defaults to the latest.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/basketballstandings endpoint returns a JSON array of team rows, or an error. Fields that do not apply to a league are left out.
league, sport, season, season_labelLeague, sport and season of the table.
teamteam_id,nameandabbreviation, named as they were that season.conference, divisionConference (
EasternorWestern) and, in the NBA, division (e.g.Atlantic). College: the conference that season, e.g.ACCorBig East.games_played, wins, lossesRecord.
win_pct, games_behindWinning percentage and games behind the leader (division leader in the NBA, conference leader in the WNBA and in college).
points_for, points_against, point_differentialPoints scored and allowed, and the difference.
streakCurrent streak, e.g.
W2orL1.home_record, away_recordHome and road records, e.g.
4-1.division_record, conference_recordRecords against division (NBA) and conference opponents.
conference_win_pctCollege: winning percentage in conference games.
last_10Record over the last 10 games.
league_rank, conference_rank, division_rankRank in the league, conference and division (NBA);
conference_rankis the playoff seed in the NBA and the conference position in the WNBA. College tables have noleague_rank: rows come conference by conference, andconference_rankis the position in the conference by conference record, then overall record (teams level on both share a position).finaltrueonce the regular season is over and the table no longer changes.poll, poll_name, week, final, dateCollege, with
poll: which poll (e.g.ap,AP Top 25), its week (nullandfinal: truefor the final poll after the postseason) and its release date.rank, team, previous_rank, points, first_place_votesCollege, with
poll: one row per ranked team, with last week's rank, voting points and first-place votes.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/basketballstandings?league=nba" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/basketballteams
Lists teams with their league, conference, division and home venue. Available on every plan.
Parameters
leagueoptionalOnly this league:
nba,wnba,ncaaborncaaw. Without it, every team of the sport is listed except college teams, which need league=ncaab or ncaaw.teamoptionalTeam id, abbreviation or name (e.g.
BOS): return one team.conferenceoptionalOnly teams in this conference (college: the short or full name, e.g.
SECorSoutheastern).divisionoptionalOnly teams in this division.
activeoptionalfalselists former teams that appear in past seasons.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/basketballteams endpoint returns a JSON array of teams, or an error.
team_idUnique id, e.g.
nba-bos,wnba-lva,ncaab-dukeorncaaw-uconn. Each league has its own ids, so a school's men's and women's teams differ (ncaab-ucla,ncaaw-ucla). Use it, the abbreviation or the name in other endpoints.leagueThe team's league.
sportAlways
basketball.abbreviation, name, cityIdentity of the team.
nickname, conference, divisionNickname, current conference and division.
school, stateCollege: the school's name as used in schedules (e.g.
Texas A&M) and the state of its home venue.venueHome venue:
name,city,state,country.activefalsefor teams that have since moved, such as the New Jersey Nets, and for schools that have left Division I, such as Hartford, which still appear in past seasons.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/basketballteams?league=nba" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/basketballplayers
Returns current rosters and player profiles, by team or by name. Rosters refresh every day. Available on every plan.
Parameters
Provide league with team or name, or a player_id.
leagueoptionalnba,wnba,ncaaborncaaw.teamoptionalTeam id, abbreviation or name: that team's current roster.
nameoptionalFull or partial player name. Case and accents are ignored.
player_idoptionalReturn one player.
positionoptionalOnly this position, e.g.
G.limitoptional Premium onlyPlayers per page (1-500). Default
50.offsetoptionalPlayers to skip, for paging. Default
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/basketballplayers endpoint returns a JSON array of players, or an error. League-specific fields are left out where they do not apply.
player_idUnique id, e.g.
nba-p-8f12176c56. It stays the same when a player changes teams.leagueLeague of the player's current roster.
teamCurrent team:
team_id,nameandabbreviation;nullfor a player whoseroster_statusisnot_on_roster.name, first_name, last_namePlayer name.
position, jersey_numberPosition abbreviation and jersey number.
height_in, height_cm, weight_lb, weight_kgHeight and weight.
birth_date, birth_placeDate of birth and birthplace (
city,state,country).roster_statusactive,suspendedornot_on_roster.college, experience_yearsProfessional leagues: college and years of professional experience, where they apply.
class_yearCollege:
freshman,sophomore,junior,seniororgraduate(a redshirt year keeps its class).
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/basketballplayers?league=nba&team=BOS" \
-H "X-Api-Key: YOUR_API_KEY"Frequently Asked Questions
Can I use the Basketball API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Basketball API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Basketball API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Basketball API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.Is there a free basketball API?
Yes. The free plan covers the current NBA and WNBA seasons: full schedules, final scores by quarter, standings, teams and rosters. Paid plans add live scores with the quarter and game clock, and past seasons.Which basketball leagues does the API cover?
The NBA (league=nba), the WNBA (league=wnba), and Division I men's and women's college basketball (league=ncaabandleague=ncaaw), with the same endpoints. League guides: NBA API, WNBA API, College Basketball API and Women's College Basketball API.How do I list every basketball team?
Call/v1/basketballteamsfor the NBA and WNBA teams, or addleague=ncaaborleague=ncaawfor the college teams of one league. Each team has itsleague, conference, division (NBA) and home venue.How are overtime periods shown?
period_scoresadds one entry per overtime period after the four quarters,periodcontinues counting (5 for the first overtime), and final games havedecided_in=overtime.How do I get today's NBA scores?
Call/v1/basketballgames?league=nba. Without a date it returns today's games in US Eastern time; on paid plans games in progress include the score, quarter and game clock.
Explore API integration use cases for recommended APIs and workflow examples.
API Ninjas is not affiliated with or endorsed by the NFL, the NBA, the NHL, the NCAA or any other league, conference, competition, school or team. League, competition and team names are trademarks of their owners and are used only to identify them.