Documentation

One key, one JSON shape, 21 endpoints. Start with the quick start, or go straight to an endpoint.

BASEhttps://api.basketballapi.net/v1

Quick startFrom no key to your first answer in a few minutes. Limits and quotas100 calls a day on the free key; the headers that tell you what is left. OpenAPI 3.1Generate a client in any language. Postman collectionEvery endpoint, ready to send. For AI assistantsThe whole API in one markdown file, and /llms.txt. ErrorsEvery code, and what to do about it.

Use with Claude and agents

One skill file teaches an AI agent the whole API: getting a key, the calls that answer common questions, the limits, the errors and the usual workflow. Download the agent skill, then save it as ~/.claude/skills/basketballapi/SKILL.md, or upload it as a skill in Claude's settings. For live tools inside the assistant, add the MCP server.

Games

Games, results, box scores, play by play, shots and closing prices.

GET/v1/gamesGames by day, dates, competition, season, team or status.Free key GET/v1/games/{id}One game, with the score by period.Free key GET/v1/games/{id}/boxscoreEvery player line and both team lines.Live GET/v1/games/{id}/playbyplayEvery event in order, with the clock and running score.Live GET/v1/games/{id}/shotsEvery shot, with where it was taken from and whether it went in.Live GET/v1/results/yesterdayYesterday's finished games.Free key

Players

Players: search, game logs and season averages.

GET/v1/players/{id}One player, with the teams played for.Live GET/v1/players/{id}/gamesA player's game log: one box line per game.Live GET/v1/playersFind players by name or team, with the games they played and their last team. Send q (3 letters or more) or team.Live GET/v1/players/{id}/seasonsA player's averages in each season, team and competition played.Live

Stats

Standings, leaders, head to head, team form, player splits and betting trends, worked out from the games and prices.

GET/v1/teams/{id}/formA team's last games with margin, pace and ratings.Complete GET/v1/players/{id}/splitsA player's averages split home and away, by result, month, opponent or starting role.Complete GET/v1/standingsA season's table from its regular-season final scores: played, won, lost, points for and against, home, away, last ten and streak.Live GET/v1/teams/{id}/head-to-headTwo teams' meetings: the record from the first team's side, home and away, average score and the last games.Live GET/v1/stats/leadersA season's leaders in one statistic, per game. Leave season out for the competition's latest season with box scores.Complete

Reference

Competitions, seasons and teams: the ids everything else is asked by.

GET/v1/competitionsEvery competition held, with its seasons and games.Free key GET/v1/seasonsSeasons of a competition, newest first.Free key GET/v1/teamsTeams, by competition and season.Live GET/v1/teams/{id}One team: its country, the club's city, home arena, arena capacity and founding year where known, and the competitions and seasons it played.Live GET/v1/teams/{id}/rosterEvery player who played for a team in a season, with games, starts and averages. Leave season out for the team's latest.Live

Account

Your own key: plan, calls and limits.

GET/v1/usageYour plan, calls today and this month, limits and the days your plan reaches. Not counted.Free key