NBA API

Live

Complete NBA data including teams, players, games, box scores, injuries, standings, advanced statistics (PER, TS%, Usage Rate), clutch performance, trending stats, home/away splits, shot zones, play-by-play data, game flow analysis, matchups, rest stats, monthly breakdowns, team advanced metrics (ORtg, DRtg, Pace), Four Factors analysis, win/loss splits, player comparisons, and team leaders. All endpoints are free with an API key.

Base URL

https://api.cappersapi.com/v1/nba

Endpoints

GET/v1/nba/teamsFree

Get all NBA teams

GET/v1/nba/teams/:idFree

Get a specific team by ID

Parameters

Name	Type	Required	Description
id	integer	Yes	Team ID

GET/v1/nba/playersFree

Get all players (paginated, ?active=true for active only)

Parameters

Name	Type	Required	Description
cursor	integer	No	Pagination cursor
per_page	integer	No	Results per page (max 100)
search	string	No	Search by player name
team_id	integer	No	Filter by team
active	boolean	No	Filter active players only

GET/v1/nba/players/:idFree

Get a specific player by ID

Parameters

Name	Type	Required	Description
id	integer	Yes	Player ID

GET/v1/nba/gamesFree

Get games (filter by ?date, ?team_id, ?season)

Parameters

Name	Type	Required	Description
date	string	No	Filter by date (YYYY-MM-DD)
start_date	string	No	Start date range
end_date	string	No	End date range
season	integer	No	Season year (e.g., 2026)
team_id	integer	No	Filter by team
cursor	string	No	Pagination cursor
per_page	integer	No	Results per page (max 100)

GET/v1/nba/games/:idFree

Get a specific game

Parameters

Name	Type	Required	Description
id	integer	Yes	Game ID

GET/v1/nba/statsFree

Get player game statistics

Parameters

Name	Type	Required	Description
game_id	integer	No	Filter by game
player_id	integer	No	Filter by player
season	integer	No	Filter by season
team_id	integer	No	Filter by team

GET/v1/nba/stats/boxscore/:gameIdFree

Get full box score for a game

Parameters

Name	Type	Required	Description
gameId	integer	Yes	Game ID

GET/v1/nba/injuriesFree

Get current player injuries

Parameters

Name	Type	Required	Description
team_id	integer	No	Filter by team
player_id	integer	No	Filter by player

GET/v1/nba/standingsFree

Get team standings

Parameters

Name	Type	Required	Description
season	integer	No	Season year
conference	string	No	East or West

GET/v1/nba/leadersFree

Get league leaders (?category=points|rebounds|assists|etc.)

Parameters

Name	Type	Required	Description
category	string	No	points, rebounds, assists, steals, blocks, etc.
season	integer	No	Season year

GET/v1/nba/lineupsFree

Get starting lineups (?game_id=required)

Parameters

Name	Type	Required	Description
game_id	integer	Yes	Game ID

GET/v1/nba/stats/advancedFree

Get advanced player statistics (PER, TS%, eFG%, Usage Rate)

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/averagesFree

Get player season averages

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
season	integer	No	Season year

GET/v1/nba/stats/team-averagesFree

Get team season averages

Parameters

Name	Type	Required	Description
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/clutchFree

Get clutch performance stats (last 5 min of close games)

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/trendingFree

Get trending stats (last 5/10 games, hot/cold streaks)

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/splitsFree

Get home/away splits

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/shot-zonesFree

Get shot zone analysis (paint, midrange, 3-point)

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/restFree

Get rest/back-to-back performance stats

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/rest/playersFree

Get player rest stats

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
season	integer	No	Season year

GET/v1/nba/stats/rest/teamsFree

Get team rest stats

Parameters

Name	Type	Required	Description
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/monthlyFree

Get monthly performance breakdown

Parameters

Name	Type	Required	Description
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/monthly/player/:playerIdFree

Get player's month-by-month stats

Parameters

Name	Type	Required	Description
playerId	integer	Yes	Player ID
season	integer	No	Season year

GET/v1/nba/playsFree

Get play-by-play data

Parameters

Name	Type	Required	Description
game_id	integer	No	Filter by game
player_id	integer	No	Filter by player
season	integer	No	Season year

GET/v1/nba/plays/game/:gameIdFree

Get all plays for a specific game

Parameters

Name	Type	Required	Description
gameId	integer	Yes	Game ID

GET/v1/nba/game-flow/gamesFree

Get game flow stats (lead changes, runs, comebacks)

Parameters

Name	Type	Required	Description
game_id	integer	No	Filter by game
season	integer	No	Season year

GET/v1/nba/game-flow/teamsFree

Get team game flow aggregates

Parameters

Name	Type	Required	Description
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/game-flow/comebacksFree

Get biggest comeback games

Parameters

Name	Type	Required	Description
season	integer	No	Season year
limit	integer	No	Number of results (default 10)

GET/v1/nba/matchups/teamsFree

Get team vs team matchup history

Parameters

Name	Type	Required	Description
team1_id	integer	No	First team ID
team2_id	integer	No	Second team ID
season	integer	No	Season year

GET/v1/nba/matchups/playersFree

Get player vs team matchup stats

Parameters

Name	Type	Required	Description
player_id	integer	No	Player ID
team_id	integer	No	Team ID
season	integer	No	Season year

GET/v1/nba/matchups/teams/:team1Id/vs/:team2IdFree

Get head-to-head matchup

Parameters

Name	Type	Required	Description
team1Id	integer	Yes	First team ID
team2Id	integer	Yes	Second team ID
season	integer	No	Season year

GET/v1/nba/stats/team-advancedFree

Get team advanced metrics (PER, TS%, ORtg, DRtg, Pace)

Parameters

Name	Type	Required	Description
team_id	integer	No	Filter by team
season	integer	No	Season year
cursor	string	No	Pagination cursor
per_page	integer	No	Results per page (max 100)

GET/v1/nba/stats/four-factorsFree

Get Four Factors analysis (Shooting, Turnovers, Rebounding, Free Throws)

Parameters

Name	Type	Required	Description
type	string	No	player or team (default: player)
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/stats/win-loss-splitsFree

Get performance in wins vs losses

Parameters

Name	Type	Required	Description
type	string	No	player or team (default: player)
player_id	integer	No	Filter by player
team_id	integer	No	Filter by team
season	integer	No	Season year

GET/v1/nba/players/compareFree

Compare 2+ players side-by-side (max 10)

Parameters

Name	Type	Required	Description
player_ids	string	Yes	Comma-separated player IDs (e.g., "1,2,3")
season	integer	No	Season year (default: 2026)

GET/v1/nba/teams/:id/leadersFree

Get team statistical leaders by category

Parameters

Name	Type	Required	Description
id	integer	Yes	Team ID
season	integer	No	Season year (default: 2026)

Code Examples

javascript

const response = await fetch(
  'https://api.cappersapi.com/v1/nba/players?search=LeBron',
  {
    headers: {
      'Authorization': 'cap_your_api_key'
    }
  }
);

const { data, meta } = await response.json();
console.log(data[0]); // { id: 237, first_name: "LeBron", last_name: "James", ... }

python

import requests

response = requests.get(
    'https://api.cappersapi.com/v1/nba/players',
    params={'search': 'LeBron'},
    headers={'Authorization': 'cap_your_api_key'}
)

data = response.json()
print(data['data'][0])  # {'id': 237, 'first_name': 'LeBron', 'last_name': 'James', ...}

curl

curl -X GET "https://api.cappersapi.com/v1/nba/players?search=LeBron" \
  -H "Authorization: cap_your_api_key"

Response Example

GET /v1/nba/players/237

{
  "data": {
    "id": 237,
    "first_name": "LeBron",
    "last_name": "James",
    "position": "F",
    "height": "6-9",
    "weight": "250",
    "jersey_number": "23",
    "active": true,
    "college": "None",
    "country": "USA",
    "draft_year": 2003,
    "draft_round": 1,
    "draft_number": 1,
    "team": {
      "id": 23,
      "name": "Lakers",
      "city": "Los Angeles",
      "abbreviation": "LAL",
      "conference": "West",
      "division": "Pacific"
    }
  }
}