NBA API

Click here to view the statistics summary.

Click here to view the extended documentation.

Click here to view our data entry workflow.

Click here to view our change log.

Note: Feeds are best viewed with Chrome, Firefox, or Internet Explorer

 

Coverage Levels

We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.

Extended Boxscore – We provide scores, time remaining, and team leaders (assists, points, and rebounds), in a timely manner, as the game progresses. We provide team- and player-level data for the game within 30 minutes of the official results being posted.

Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team- and player-level data in near real time. Full coverage is available for all regular and post season games.

Note: Pre-season coverage of NBA games will vary. Any game involving an international team will be covered via our extended boxscore coverage, with team and player statistics provided for the NBA team only.

 

___________________________________________________

Daily Change Log

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/changelog-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/league/[year]/[month]/[day]/changes.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[year] = Year in 4 digit format (YYYY)

[month] = Month in 2 digit format (MM)

[day] = Day of the month in 2 digit format (DD)

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Example

___________________________________________________

Daily Schedule 

Schema 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/schedule-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/games/[year]/[month]/[day]/schedule.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[year] = Year in 4 digit format (YYYY)

[month] = Month in 2 digit format (MM)

[day] = Day of the month in 2 digit format (DD)

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Daily Transfers

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/transfers-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/league/[year]/[month]/[day]/transfers.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[year] = Year in 4 digit format (YYYY)

[month] = Month in 2 digit format (MM)

[day] = Day of the month in 2 digit format (DD)

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Example

___________________________________________________

Free Agents

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/free-agents-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/league/free_agents.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Game Boxscore

Schema 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/game-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/games/[game_id]/boxscore.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[game_id] = ID for a given game

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Game Summary

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/game-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/games/[game_id]/summary.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[game_id] = ID for a given game

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Injuries

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/injuries-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/league/injuries.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

League Hierarchy

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/nba/hierarchy-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/league/hierarchy.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Example

___________________________________________________

League Leaders

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/statistics-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/seasontd/[season]/[nba_season]/leaders.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[season] = yyyy

[nba_season] = reg, pst

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Play-By-Play

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/pbp-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/games/[game_id]/pbp.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[game_id] = ID for a given game

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Player Profile

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/profile-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/players/[player_id]/profile.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[player_id] = ID for a given player

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Example

___________________________________________________

Rankings

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/nba/rankings-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/seasontd/[season]/[nba_season]/rankings.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[season] = yyyy

[nba_season] = reg

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Schedule

Schema 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/schedule-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/games/[season]/[nba_season]/schedule.xml?api_key=[your_api_key]

Parameter Format Notes

[season] = yyyy

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[nba_season] = pre, reg, pst

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Seasonal Statistics (Season to date)

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/statistics-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/seasontd/[season]/[nba_season]/teams/[team_id]/statistics.xml?api_key=[your_api_key]

Parameter Format Notes

[team_id] = ID for a given team

[season] = yyyy

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[nba_season] = reg, pst

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Series Schedule

Schema 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/schedule-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/series/[season]/[nba_season]/schedule.xml?api_key=[your_api_key]

Parameter Format Notes

[season] = yyyy

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[nba_season] = pst

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Series Statistics

Schema 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/statistics-v2.0.xsd?api_key=[your_api_key]

Feed 

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/series/[series_id]/statistics.xml?api_key=[your_api_key]

Parameter Format Notes

[season] = yyyy

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[series_id] = Id of a given series

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Standings

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/nba/standings-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/seasontd/[season]/[nba_season]/standings.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[season] = yyyy

[nba_season] = reg

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Format Example

___________________________________________________

Team Profile (Rosters)

Schema

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/schema/team-v2.0.xsd?api_key=[your_api_key]

Schema Example

Feed

Syntax: http(s)://api.sportradar.us/nba-[access_level][version]/[language_code]/teams/[team_id]/profile.xml?api_key=[your_api_key]

Parameter Format Notes

[access_level] = Production (p), Trial (t)

[version] = whole number (sequential, starting with the number 1)

[team_id] = ID for a given Team

[format] = xml, json

Optional Parameters

[language_code] = ru (russian), zh (simplified chinese)

Feed Example