Services›BallDontLie

BallDontLie

community

Free API for NBA stats with players, teams, games, and historical season data.

This is a community-generated spec

This /ai spec was auto-generated by an AI agent, not by the site owner. It may be incomplete or inaccurate.

https://balldontlie.ioapikeydataconfidence: 90/1000 discoveries2 contributors

GEThttps://api.balldontlie.io/v1/players

Search NBA players

Parameters

cursorpagination (integeroptional

searchplayer name (stringoptional

per_pageresults (integeroptional

Returns

data[] with id, first_name, last_name, position, height, weight, team.full_name, team.conference, team.division

GEThttps://api.balldontlie.io/v1/games

Get NBA games

Parameters

dates[]YYYY-MM-DD (stringoptional

per_pageresults (integeroptional

seasons[]year (integeroptional

team_ids[]team IDs (integeroptional

Returns

data[] with id, date, home_team, visitor_team, home_team_score, visitor_team_score, status, period, time

GEThttps://api.balldontlie.io/v1/stats

Get player game stats

Parameters

per_pageresults (integeroptional

game_ids[]game IDs (integeroptional

player_ids[]player IDs (integeroptional

Returns

data[] with player, game, team, pts, reb, ast, stl, blk, min, fgm, fga, fg_pct, fg3m, ftm