Basketball-NBA API v2 Documentation

Quick Guide

LEAGUE_ID

CONTRACT_SEASON_ID

SEASON_ID

SEASON_ID & TEAM_ID

API NBA Unlimited Access To Seasons, Teams, and Players

API Demo * Limited Results

NBA Contracts

Includes contract terms, expanded salary details, and additional player attributes
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2019-20
    LEAGUE_ID: nba
    TEAM_ID: golden-state-warriors
    TEAM_NAME: Golden State Warriors
    TEAM_CODE: GSW
    TEAM_CONFERENCE: West
    TEAM_DIVISION: Pacific

    PLAYER_NAME: Stephen Curry
    PLAYER_FIRST: Stephen
    PLAYER_LAST: Curry
    PLAYER_ID: curryst01
    PLAYER_NUMBER: None
    PLAYER_YOS: 10
    PLAYER_AGE: 31
    PLAYER_POSITION: Point Guard
    PLAYER_POSITION_CODE: PG
    PLAYER_GROUP: Guard
    PLAYER_GROUP_CODE: G
    PLAYER_COUNTRY: United States
    PLAYER_COUNTRY_ID: united-states

    CONTRACT_TOTAL: 201158790
    CONTRACT_YEARS: 5-yr
    CONTRACT_TYPE: Bird Rights
    CONTRACT_STATUS: UFA
    CONTRACT_FREEAGENT: 2022

    SALARY: 40231758
    SALARY_BASE: 40231758
    CAPHIT: 40231758
    SALARY_Y1: 40231758
    SALARY_Y2: 43006362
    SALARY_Y3: 45780966
    SALARY_Y4: 0
    SALARY_Y5: 0
    SALARY_Y6: 0
    CAPHIT_Y1: 40231758
    CAPHIT_Y2: 43006362
    CAPHIT_Y3: 45780966
    CAPHIT_Y4: 0
    CAPHIT_Y5: 0
    CAPHIT_Y6: 0
    ADJUSTED_SALARY: 40231758.0
    ADJUSTED_CAPHIT: 40231758.0

NBA Salaries

Includes basic salary details and player attributes
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2018-19
    LEAGUE_ID: nba
    TEAM_ID: golden-state-warriors
    TEAM_NAME: Golden State Warriors
    TEAM_CODE: GSW

    PLAYER_NAME: Stephen Curry
    PLAYER_FIRST: Stephen
    PLAYER_LAST: Curry
    PLAYER_ID: curryst01
    PLAYER_DOB: 1988-03-14
    PLAYER_COUNTRY: United States
    PLAYER_COUNTRY_ID: united-states
    PLAYER_GROUP: Guard
    PLAYER_GROUP_CODE: G

    ROSTER_ACTIVE: True
    ROSTER_WAIVED: False

    CONTRACT_TYPE: Bird Rights

    SALARY: 37457154
    SALARY_PCT: 0.368
    CAPHIT: 37457154
    CAPHIT_PCT: 0.368
    ADJUSTED_SALARY: 37457154.0
    ADJUSTED_CAPHIT: 37457154.0

NBA Payrolls

Includes overall figures and breakdowns by position groups
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2019-20
    LEAGUE_ID: nba
    TEAM_ID: golden-state-warriors
    TEAM_NAME: Golden State Warriors
    TEAM_CODE: GSW
    TEAM_COLOR: 29,66,138

    ROSTER_ACTIVE: 15
    ROSTER_WAIVED: 6

    SALARY: 131333204
    CAPHIT: 131326618
    CAPHIT_GUARD: 75872402
    CAPHIT_FORWARD: 48936594
    CAPHIT_CENTER: 4629630

    SALARYCAP: 109140000.0
    SALARYCAP_GUARD_PCT: 0.695
    SALARYCAP_FORWARD_PCT: 0.448
    SALARYCAP_CENTER_PCT: 0.042

    ADJUSTED_SALARYCAP: 109140000
    ADJUSTED_SALARY: 131333204
    ADJUSTED_CAPHIT: 131326618
    ADJUSTED_CAPHIT_GUARD: 75872402
    ADJUSTED_CAPHIT_FORWARD: 48936594
    ADJUSTED_CAPHIT_CENTER: 4629630

NBA Team_ID

Find all IDs and additional information for teams in this league
  • CLICK HERE TO VIEW DATA SAMPLE

    SEASON_ID: 2019-20
    LEAGUE_ID: nba
    TEAM_ID: atlanta-hawks
    TEAM_NAME: Atlanta Hawks
    TEAM_CODE: ATL

NBA Player_ID

Find all IDs and additional information for players in this league
  • CLICK HERE TO VIEW DATA SAMPLE

    PLAYER_ID: abdelal01
    PLAYER_NAME: Alaa Abdelnaby