XML Feed Customer Documentation

XML Basketball Play-by-Play Feed

This feed includes play-by-play data for pre-season, regular season, playoff and all-star games for NBA.

Feed Information

Detail

Info

Update Interval

As data is updated

Atom feed keyword

/basketball/play-by-play

HTTP NBA

http://xml.sportsdirectinc.com/sport/v2/basketball/NBA/play-by-play/(season-name)/play_by_play_NBA_(competition-id).xml

(warning) Note that the URLs listed above are not valid; keywords in parentheses must be replaced with real values.

Common Data

League Data

Item

 

Notes

Sport Id

 

Sport Name

 

League Id

 

League Name

 

League Short Name

 

Season Data

Item

 

Notes

Id

 

Name

 

Start Date

 

End Date

 

Team Data

(warning) Included for both home and visitor teams.

Item

 

Notes

Id

 

Display Name

 

Game Data

Item

 

Notes

Id

 

Start date/time

 

Status

Scheduled, etc.

Name

Custom name. (optional)

Play-by-Play Data

Play-by-play data consists of a sequence of elements describing game events in order of when they occurred during the game.

Play

Item

NBA

Notes

Id

 

Sequence Number

indicates cronological order
Event Time

period-number, time

Team

 

Play events

see Play Event description below

Description

 

Official Timeout

Item

NBA

Notes

Id

 

Sequence Number

indicates cronological order
Event Time

period-number, time

Team Timeout

Item

NBA

Notes

Id

 

Sequence Number

indicates cronological order
Event Time

period-number, time
Team

team who called the timeout
Type

short/full

Play Event

Item

NBA

Notes

Type

see Play Event Type list below

sequence-number

indicates cronological order
Points

optional: only for scoring plays

Player

if the Play Event involves a player

Team

if the Play Event involves a team
Description

 

Player

Item

 

Notes

Id

 

First Name

 

Last Name

 

City

 

State

For Canada, USA only.

Country

 

Team

Item

 

Notes

Id

 

Display Name

 

Play Event Types

Type
foul_flagrant
foul_personal
foul_team_technical
foul_technical
possession_jump_ball_lost
possession_jump_ball_won
possession_steal
possession_team_turnover
possession_turnover
rebound_defensive
rebound_offensive
rebound_team_defensive
rebound_team_offensive
shot_made_assist
shot_made_dunk
shot_made_free_throw
shot_made_layup
shot_made_three_pointer
shot_made_two_pointer
shot_missed_block
shot_missed_dunk
shot_missed_free_throw
shot_missed_layup
shot_missed_three_pointer
shot_missed_two_pointer
starter_in_center
starter_in_forward
starter_in_guard

substitution_in

substitution_out
timeout_full
timeout_official
timeout_twenty_second