Feed Information
Detail | Info |
---|---|
Update Interval | As data is updated |
Atom feed keyword | /basketball/play-by-play |
HTTP NBA |
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
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 |