Skip to content

NBA API

NBA (nba.com) has 4 public methods: get standings, get player by name, get scores and get box score. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

nba.com (opens in a new tab)

Unofficial. Not affiliated with or endorsed by NBA.

Methods

4

  • Get standings

    Returns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page.

    Returns season, eastern_conference and western_conference teams with rank, record, streak, last 10, home/away records, games behind, clinch status and team page URL

    Readnba.com/get_standings

  • Get player by name

    Looks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career.

    Returns name, team, jersey number, position, height, weight, age, draft, college, season and career averages

    Readnba.com/get_player

  • Get scores

    Gets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue.

    Returns date, start time, teams, scores, status, quarter, clock, TV channels, arena, city, game link, game id

    Readnba.com/get_scores

  • Get box score

    Returns the NBA box score for a game between two teams on a date; without a date, their most recent matchup, including Summer League and games in progress.

    Returns date, arena, status, score, game link, each team's points by period and player stats

    Readnba.com/get_box_score