View
236
Download
3
Category
Preview:
Citation preview
DRAFT 04.17.12
2 SPORTSDATA NBA STATISTICS FEEDS
Table of Contents
Overview ...................................................................................................................................... 3 Stats List – Game Information ................................................................................................... 4 Stats List – Play-by-Play ............................................................................................................. 5 Stats List – Player ....................................................................................................................... 6 Stats List – Team ........................................................................................................................ 7 Stats List – Player Information .................................................................................................. 8 Stats List – Sport Information .................................................................................................... 9 Stats List – Team Information .................................................................................................. 10 Schedule Feed – Details ........................................................................................................... 11 Roster Feed – Details ............................................................................................................... 13 Play-by-Play Feed – Details ..................................................................................................... 16 Statistics Feed – Details ........................................................................................................... 18 Standings Feed – Details .......................................................................................................... 24 Season Statistics Feed – Details ............................................................................................. 27 Events Glossary Feed – Details ............................................................................................... 30
DRAFT 04.17.12
3 SPORTSDATA NBA STATISTICS FEEDS
Overview The Gold Standard in Real-time Sports Stats SportsData’s team of data-entry experts crunch play-by-play information for packaging and delivery using new technology that results in the fastest updates in the industry. And because our clients demand depth, no statistic is too small. We are focused on:
Accuracy. From instant play-by-play to in-game clean up, official and final we maintain the highest standard in data accuracy.
Simplicity. We deliver your sports data feed to customer specifications, or in any industry-standard format; our flexibility makes your transition fast and seamless.
Speed. We offer true real-time delivery of data using highly-optimized publishing techniques.
Service. We approach every client relationship as an opportunity for a long-term partnership, and will work tirelessly for you from Day 1.
NBA Statistics Feeds
We package our comprehensive stats collection into seven main feeds, each focused on serving specific information needs.
Schedule – provides the date, time, location and other event details for every match-up
Standings – provides team level information as well as team level statistics including wins, losses, points, and various win/loss splits
Statistics – detailed game stats at the player and team level, including extensive offense and defense breakouts
Play-by-Play – detailed, real-time stats on every game event
Seasonal Statistics – detailed seasonal stats at the player and team level, including extensive offense and defense breakouts
Rosters – player information for each team, including height/weight, jersey number and position
Events Glossary – provides a translation of the play by play events into a more meaningful text string
DRAFT 04.17.12
4 SPORTSDATA NBA STATISTICS FEEDS
Stats List – Game Information
Stat Schedule Standings Game Stats
Play by Play
Season Stats Roster
Away Team Id X Away Team Name X Date & Time X X X Duration X Ending X X Fixture Name X Game Attendance X Home Team Id X Home Team Name X Lead Changes X Match Day X Match Id X X Match Type X Period X X Period Count X Result Type X Round Type X Stat Type X Team Id X X Team Name X Team Rotation Number X Team Score (Game) X X Team Score (Period) X Team Side X X Times Tied X Venue Id X Venue Location X Venue Name X Winning Team Id X
DRAFT 04.17.12
5 SPORTSDATA NBA STATISTICS FEEDS
Stats List – Play-by-Play
Stat Schedule Standings Game Stats
Play by Play
Season Stats Roster
Create Timestamp X Event Id X Event Number X Event Type X Game Event Uid X Goal Period X Minutes X Period Id X Player Id X Qualifier Id X Seconds X Team Id X Time X Type Id X Update Timestamp X
DRAFT 04.17.12
6 SPORTSDATA NBA STATISTICS FEEDS
Stats List – Player
Stat Schedule Standings Game Stats
Play by Play
Season Stats Roster
3 Point Shots Attempted X X 3 Point Shots Made X X Assists X X Blocked Attempts X X Blocked Shots X X Defensive Rebounds X X Did Not Play X X Field Goals Attempted X X Field Goals Made X X Fouls X X Free Throws Attempted X X Free Throws Made X X Game Played X X Game Started X X Minutes X X Offensive Rebounds X X Plus/Minus X Points X X Steals X X Total Rebounds X X Turnovers X X
DRAFT 04.17.12
7 SPORTSDATA NBA STATISTICS FEEDS
Stats List – Team
Stat Schedule Standings Game Stats
Play by Play
Season Stats Roster
3 Point Shots Attempted X X 3 Point Shots Made X X Assists X X Blocked Attempts X X Blocked Shots X X Defensive Rebounds X X Fast Break Points X Field Goals Attempted X X Field Goals Made X X Free Throws Attempted X X Free Throws Made X X Offensive Rebounds X X Player Fouls X X Points X X Points in the Paint X Points Off Turnovers X Steals X X Team Rebounds X Team Turnovers X Total Rebounds X X Turnovers X X
DRAFT 04.17.12
8 SPORTSDATA NBA STATISTICS FEEDS
Stats List – Player Information
Stat Schedule Standings Game Stats
Play by Play
Season Stats Roster
College X Date of Birth X Dominant Hand X First Name X X First Year Pro X Height (cm) X Height (in) X Jersey Number X X Last Name X X Place of Birth X Player Id X Player Known Name X Player Ref X Position X X Weight (kg) X Weight (lbs) X
DRAFT 04.17.12
9 SPORTSDATA NBA STATISTICS FEEDS
Stats List – Sport Information
Stat Schedule Standings Game Stats
Play by Play
Season Stats Roster
Competition Code X Competition Id X X X X X X Competition Name X X X X X X Game Id X MatchDay X Season Id X X X X X X Season Name X Sport Id X X X X X Sport Name X X X X X
DRAFT 04.17.12
10 SPORTSDATA NBA STATISTICS FEEDS
Stats List – Team Information
Stat Schedule Standings Game Stats
Play by Play
Season Stats Roster
Conference X Conference Id X Conference Record X Division X Division Id X Division Record X Games Back X Games Lost X Games Won X Home Record X Last 10 Record X Position X Road Record X Stadium X Streak X Team Id X X Team Name X X X Team Nickname X Winning Percentage X
DRAFT 04.17.12
11 SPORTSDATA NBA STATISTICS FEEDS
Schedule Feed – Details
This feed provides the date, time, location and other event details for every match-up.
Element/Attribute/Value Descriptions
File Breakdown – Schedule Feed Element Attribute Values Description
OptaFeed N/A N/A Root Element Child Element: OptaDocument
OptaDocument Type “RESULTS Latest” This value at time of writing will always be set to this text.
competition_id Dynamic Competition Short Code competition_name Dynamic Competition Official Name season_id Dynamic The Id of the season in the competition season_name Dynamic Sportsdata’s season name timestamp Dynamic Timestamp of creation of data snapshot sport_id “7” Unique id for the sport sport_name “Basketball” Name of the sport Child Element: MatchData
MatchData uID Dynamic Unique identifier for this game Child Elements: MatchInfo, Stat, Stat, TeamData
MatchInfo Period “FullTime” This game has officially finished “PreMatch” This game has yet to begin
“Postponed”
Appears if the game has been postponed. The period will remain like this until a new date is announced for the game, at which point this new date will appear and the old one shall be removed.
Ending “REG” The game ended in Regulation time “OTx” The game ended in this overtime period
Venue_id Dynamic Unique Id for the game venue roundtype Dynamic The round of the playoffs of the game
fixture_name Dynamic This is used for the playoffs. This will denote which game in the series this is.
Child Elements: Date, TZ
Date N/A N/A Date & time of the game are in the format of “YYYY-MM-DDTHH:MM:SS-HH:MM”.
TZ N/A EST Specifies that the Date attribute is showing time/date as Eastern Standard Time.
Stat Type Venue The name of the venue hosting the game. Stat Type City The city where the venue is located. TeamData Score Dynamic The score for the described side. Side “Home” or “Away” team_id Dynamic The unique id for the team
rotation Dynamic The unique rotation number for that team and game
Team uID Dynamic The unique id for a team Name Dynamic The official name of the team
DRAFT 04.17.12
12 SPORTSDATA NBA STATISTICS FEEDS
File Naming Convention http://api.sportsdatallc.org/nba-[access_level][version]/schedule?season_id=[season]&api_key=[your_api_key]
Parameter Format Notes [season] = yyyy
[access_level] = Premium (p), Standard (s), Basic (b), Trial (t)
[version] = whole number (sequential, starting with the number 1)
Delivery Timing
This feed will be continually updated as games go complete.
Copyright
The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.
DRAFT 04.17.12
13 SPORTSDATA NBA STATISTICS FEEDS
Roster Feed – Details
This feed provides player information for each team, including height/weight, jersey number and position
Element/Attribute/Value Descriptions
File Breakdown – Roster Feed Element Attribute Values Description
OptaFeed timestamp Dynamic Date and time the file was created (YYYY-MM-DDTHH:MM:SST-HH:MM)
Child Element: OptaDocument OptaDocument type “SQUADS Latest” This value at time of writing will always be set
to this text. competition_id Dynamic Unique id of the competition competition_name Dynamic Name of the competition season_id Dynamic The Id of the season in the competition sport_id “7” Unique id for the sport sport_name “Basketball” Name of the sport Child Element: Team
Team uID Dynamic Unique id of the team
Child Elements: name, Stadium, Player
name N/A Dynamic Name of the team
Stadium name Dynamic Name of the team’s home venue
Player uID Dynamic Unique id of the player
Child Elements: Name, Position, Stat
Name N/A Name of the player
Position N/A “G” The players position
“G-F”
“F-G”
“F”
“F-C”
“C”
“C-F”
Stat type first_name Player’s first name
Stat type last_name Player’s last name
Stat type birth_date Player’s date of birth
Stat type birth_place Player’s place of birth
Stat type weight Player’s weight in kg
Stat type iw Player’s weight in pounds
Stat type height Player’s height in cm
Stat type ih Player’s height in inches
DRAFT 04.17.12
14 SPORTSDATA NBA STATISTICS FEEDS
Stat type jersey_num Player’s jersey number
Stat type college Player’s college
Stat type first_year_pro Player’s rookie year
Stat type hand Player’s dominant hand
DRAFT 04.17.12
15 SPORTSDATA NBA STATISTICS FEEDS
File Naming Convention http://api.sportsdatallc.org/nba-[access_level][version]/roster?season_id=[season]&api_key=[your_api_key]
Parameter Format Notes [season] = yyyy
[access_level] = Premium (p), Standard (s), Basic (b), Trial (t)
[version] = whole number (sequential, starting with the number 1)
Delivery Timing
This feed will be continually updated as events occur.
Copyright
The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.
DRAFT 04.17.12
16 SPORTSDATA NBA STATISTICS FEEDS
Play-by-Play Feed – Details
This feed provides a real-time log of every game event.
Element/Attribute/Value Descriptions
File Breakdown – Play-by-Play Feed Element Attribute Values Description
Games timestamp Dynamic Date and time the file was created (YYYY-MM-DDTHH:MM:SST-HH:MM)
Child elements: game
game id Dynamic Unique id for the game
sport_id “7” Unique id for the sport
sport_name “Basketball” Name of the sport
away_team_id Dynamic Unique id for the visiting team
away_team_name Dynamic Name of the visiting team
competition_name Dynamic Name of the competition
competition_id Dynamic Unique id of the competition
game_date Dynamic Scheduled start date and time for the game (YYYY-MM-DDTHH:MM:SST-HH:MM)
home_team_id Dynamic Unique id for the home team
home_team_name Dynamic Name of the home team
season_id Dynamic The Id of the season in the competition
Child elements: Event
Event id Dynamic Unique id of the event within the competition
event_id Dynamic Unique id of the event within the game
type_id Dynamic Unique id for the game event
period_id Dynamic Unique id of the quarter the event took place in
min Dynamic Number of minutes on the clock when the event occurred
sec Dynamic Number of seconds on the clock when the event occurred
team_id Dynamic Unique id of the team associated with the game event
player_id Dynamic Unique id of the player associated with the game event
timestamp Dynamic The date and time the game event was created (YYYY-MM-DDTHH:MM:SST-HH:MM)
last_modified Dynamic The date and time the game event was modified (YYYY-MM-DDTHH:MM:SST-HH:MM)
DRAFT 04.17.12
17 SPORTSDATA NBA STATISTICS FEEDS
File Naming Convention
http://api.sportsdatallc.org/nba-[access_level][version]/pbp?game_id=[game_id]&api_key=[your_api_key]
Parameter Format Notes [game_id] = integer
[access_level] = Premium (p), Standard (s), Basic (b), Trial (t)
[version] = whole number (sequential, starting with the number 1)
Delivery Timing This feed will be continually updated as events occur.
Copyright
The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.
DRAFT 04.17.12
18 SPORTSDATA NBA STATISTICS FEEDS
Statistics Feed – Details
This feed provides detailed game stats at the player and team level, including extensive offense and defense breakouts.
Element/Attribute/Value Descriptions
File Breakdown – Statistics Feed Element Attribute Values Description
OptaFeed timestamp Dynamic Date and time the file was created (YYYY-MM-DDTHH:MM:SST-HH:MM)
Child Element: OptaDocument
OptaDocument type “Latest” The game has not started or is in progress
“Result” The game is over and the statistics have been validated
uID Dynamic Unique id of the game
sport_id “7” Unique id of the sport
sport_name “Basketball” Name of the sport
Child Elements: Competition, MatchData, Team, Venue
Competition uID Dynamic Unique id of the competition
Child Elements: Country, Name, Stat
Country N/A Dynamic The home country of the competition
Name N/A Dynamic The name of the competition
Stat Type season_id The Id of the season in the competition
MatchData Child Elements: MatchInfo, TeamData
MatchInfo period “FullTime” This game has officially finished
“PreMatch” This game has yet to begin
“Postponed”
Appears if the game has been postponed. The period will remain like this until a new date is announced for the game, at which point this new date will appear and the old one shall be removed.
“FirstPeriod” The game is in the first quarter
“SecondPeriod” The game is in the second quarter
“ThirdPeriod” The game is in the third quarter
“FourthPeriod” The game is in the fourth quarter
“Overtime” The game is in overtime
matchtype “Regular” This value will always be set to this value
time_remaining Dynamic This is the time remaining in the quarter
Ending “REG” The game ended in regulation time
“OTx” The game ended in this particular overtime
DRAFT 04.17.12
19 SPORTSDATA NBA STATISTICS FEEDS
Child Elements: Date, Result,Stat
Date N/A Dynamic The date and time the game was scheduled (YYYY-MM-DDTHH:MM:SST-HH:MM)
Result type “NormalResult” The game ended in regulation time
“Overtime” The game ended in overtime
“Abandoned” The game was abandoned before completion
“PostPoned” The game was postponed
winner Dynamic The unique id of the winning team
Stat type “Game Attendance” The attendance of the game
Stat type “Duration” The length of time it took to complete the game
Stat type “Lead Changes” The number of lead changes in the game
Stat type “Times Tied” The number of times the game was tied
Stat type “Period Count” The length of the game in quarters, including overtime
Stat type “Officials” The officials who worked the game
Stat type “Fact of the Match” An interesting fact about the game
TeamData score Dynamic The total number of points the team scored in the game
side “Home” Displays which team was the home team and which one was the away “Away”
team_id Dynamic The unique id of the team
Child element: Stat, Goal, PlayerLineUp
Stat type “Inactive” The players marked as in active for the game
Stat type “Technical Fouls” The players or team who received a technical foul in the game
Stat type “Team Rebounds” The number of rebounds credited to the team and not an individual player
Stat type “Fast Break Points” The number of fast break points the team scored in the game
Stat type “Points in the Paint” The number of points in the paint the team scored in the game
Stat type “Team Turnovers” The number of turnovers credited to the team and not an individual player
Stat type “Points off Turnovers” The number of points the team scored off of turnovers in the game
Goal period “FirstPeriod” The scoring event occurred in the first period
“SecondPeriod” The scoring event occurred in the second period
DRAFT 04.17.12
20 SPORTSDATA NBA STATISTICS FEEDS
“ThirdPeriod” The scoring event occurred in the third period
“FourthPeriod” The scoring event occurred in the fourth period
“Overtime” The scoring event occurred in overtime
player_id Dynamic The unique id of the player
eventid Dynamic The unique id of the event
type Dynamic The type of event
eventnumber Dynamic Unique within the game. The first digit is the period, the last indicates the event number in the game for the period. The middle digits indicate the minute. So 259 would be 2nd period, 5 mins, 9th event.
time Dynamic The minute the event occurred
uID Dynamic The score of the game after this event
Stat type “Score” Always set to “Score”
period “1-x” The team’s points scored each quarter
Stat type “FGM” The number of field goals made by the team
Stat type “FGA” The number of field goals attempted by the team
Stat type “3PM” The number of 3 point shots made by the team
Stat type “3PA” The number of 3 point shots attempted by the team
Stat type “FTM” The number of free throws made by the team
Stat type “FTA” The number of free throws attempted by the team
Stat type “OFF” The number of offensive rebounds for the team
Stat type “DEF” The number of defensive rebounds for the team
Stat type “TOT” The total number of rebounds for the team (Does not include “Team Rebounds”)
Stat type “AST” The total number of assists for the team
Stat type “PF” The total number of players fouls for the team
Stat type “ST” The totals number of steals for the team
Stat type “TO” The total number of turnovers by the team (Does not include “Team Turnovers”)
Stat type “BS” The total number of blocked shots by the team
Stat type “BA” The totals number of attempts blocked for the team
DRAFT 04.17.12
21 SPORTSDATA NBA STATISTICS FEEDS
Stat type “PTS” The number of points scored by the team
PlayerLineUp Child element: MatchPlayer
MatchPlayer player_id Dynamic The unique id of the player
position Dynamic The position assigned to the player
jersey_num Dynamic The jersey number assigned to the player
ingame “Yes” The player started the game
“No” The player did not start the game
Child element: Stat
Stat type “GS” Did the player start the game (1 for yes)
Stat type “GP” Did the player play in the game (1 for yes)
Stat type “DNP” Was the player scratched from the game (1 for yes)
Stat type “DNP Reason” If a player was marked as DNP, the reason why
Stat type “MIN” The number of minutes the player played in the game
Stat type “FGM” The number of fields goals made by the player
Stat type “FGA” The number of field goals attempted by the player
Stat type “3PM” The number of 3 point shots made by the player
Stat type “3PA” The number of 3 point shots attempted by the player
Stat type “FTM” The number of free throws made by the player
Stat type “FTA” The number of free throws attempted by the player
Stat type “+/-“ The players +/- total for the game
Stat type “OFF” The number of offensive rebounds for the player
Stat type “DEF” The number of defensive rebounds for the player
Stat type “TOT” The total number of rebounds for the player
Stat type “AST” The number of assists for the player
Stat type “PF” The number of fouls for the player
Stat type “ST” The number of steals for the player
Stat type “TO” The number of turnovers for the player
Stat type “BS” The number of blocked shots for the player
Stat type “BA” The number of shot attempts the player had blocked
Stat type “PTS” The number of points the player scored
DRAFT 04.17.12
22 SPORTSDATA NBA STATISTICS FEEDS
Team uID Dynamic The teams unique id
Child Element: Name, Player
Name N/A N/A The name of the team
Player position “G” The players position
“G-F”
“F-G”
“F”
“F-C”
“C”
“C-F”
uID Dynamic The unique id of the player
Child element: PersonName
PersonName Child elements: First, Last
First N/A Dynamic The player’s first name
Last N/A Dynamic The player’s last name
DRAFT 04.17.12
23 SPORTSDATA NBA STATISTICS FEEDS
File Naming Convention
http://api.sportsdatallc.org/nba-[access_level][version]/statistics?game_id=[game_id]&api_key=[your_api_key]
Parameter Format Notes [game_id] = integer
[access_level] = Premium (p), Standard (s), Basic (b), Trial (t)
[version] = whole number (sequential, starting with the number 1)
Delivery Timing
This feed will be continually updated as events occur.
Copyright
The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.
DRAFT 04.17.12
24 SPORTSDATA NBA STATISTICS FEEDS
Standings Feed – Details
This feed provides team level information as well as team level statistics including wins, losses, points, and various win/loss splits.
Element/Attribute/Value Descriptions File Breakdown – Summary Feed
Element Attribute Values Description OptaFeed N/A N/A Root Element
Child Element: OptaDocument OptaDocument type “STANDINGS Latest” This value will always be set to this text
competition_id Dynamic The unique id of the competition
competition_name Dynamic The name of the competition
season_id Dynamic The Id of the season in the competition
timestamp Dynamic Date and time the file was created (YYYY-MM-DDTHH:MM:SST-HH:MM)
sport_id “7” The unique id of the sport
sport_name “Basketball” The name of the sport
status “live” Games within this competition currently live and being played
NULL No games are currently being played at the time of feed production
Competition Child element: TeamStandings
TeamStandings Child element: TeamRecord
TeamRecord team_id Dynamic The unique id of the tem
position Dynamic The team’s ranking within the conference
conference Dynamic The name of the team’s conference
conference_id Dynamic The unique id of the conference
division Dynamic The name of the team’s division
division_id Dynamic The unique id of the division
Child element: Standing
Standing type “Full” This will always be set to “Full”
name Dynamic The name of the team
conference Dynamic The name of the team’s conference
conference_id Dynamic The unique id of the conference
division Dynamic The name of the team’s division
division_id Dynamic The unique id of the division
Child elements: Won, Lost, PCT, GB, Conf, Div, HomeRecord, AwayRecord, LastTen, Streak
Won N/A Dynamic The number of games the team has won
DRAFT 04.17.12
25 SPORTSDATA NBA STATISTICS FEEDS
Lost N/A Dynamic The number of games the team has lost
PCT N/A Dynamic The team’s winning percentage
GB N/A Dynamic The number of games the team is out of first place in the division
Conf N/A Dynamic The team’s conference record
Div N/A Dynamic The team’s division record
HomeRecord N/A Dynamic The team’s record at home
AwayRecord N/A Dynamic The team’s record on the road
LastTen N/A Dynamic The team’s record over the last 10 games
Streak N/A Dynamic The number of games in a row the team has won or lost
DRAFT 04.17.12
26 SPORTSDATA NBA STATISTICS FEEDS
File Naming Convention
http://api.sportsdatallc.org/nba-[access_level][version]/standings?season_id=[season]&api_key=[your_api_key]
Parameter Format Notes [game_id] = integer
[access_level] = Premium (p), Standard (s), Basic (b), Trial (t)
[version] = whole number (sequential, starting with the number 1)
Delivery Timing
This feed will be continually updated as events occur.
Copyright
The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.
DRAFT 04.17.12
27 SPORTSDATA NBA STATISTICS FEEDS
Season Statistics Feed – Details
This feed provides detailed game stats at the player and team level, including extensive offense, defense and special teams breakouts.
Element/Attribute/Value Descriptions
File Breakdown – Season Statistics Feed Element Attribute Values Description
SeasonStatistics competition_name Dynamic Name of the competition
season_id Dynamic The Id of the season in the competition
competition_id Dynamic The unique id of the competition
timestamp Dynamic Date and time the file was created (YYYY-MM-DDTHH:MM:SST-HH:MM)
sport_id “7” The unique id of the sport
sport_name “Basketball” The name of the sport
Child Element: Team
Team name Dynamic The name of the team
Child Element: Stat, Player
Stat type “FGM” The number of field goals made by the team
Stat type “FGA” The number of field goals attempted by the team
Stat type “3PM” The number of 3 point shots made by the team
Stat type “3PA” The number of 3 point shots attempted by the team
Stat type “FTM” The number of free throws made by the team
Stat type “FTA” The number of free throws attempted by the team
Stat type “OFF” The number of offensive rebounds for the team
Stat type “DEF” The number of defensive rebounds for the team
Stat type “TOT” The total number of rebounds for the team (Does not include “Team Rebounds”)
Stat type “AST” The total number of assists for the team
Stat type “PF” The total number of players fouls for the team
Stat type “ST” The totals number of steals for the team
Stat type “TO” The total number of turnovers by the team (Does not include “Team Turnovers”)
Stat type “BS” The total number of blocked shots by the
DRAFT 04.17.12
28 SPORTSDATA NBA STATISTICS FEEDS
team
Stat type “BA” The totals number of attempts blocked for the team
Stat type “PTS” The number of points scored by the team
Player position Dynamic The position assigned to the player
player_id Dynamic The unique id of the player
jersey_num Dynamic The jersey number assigned to the player
last_name Dynamic The player’s last name
first_name “Yes” The player’s first name
Child element: Stat
Stat type “GS” Did the player start the game (1 for yes)
Stat type “GP” Did the player play in the game (1 for yes)
Stat type “DNP” Was the player scratched from the game (1 for yes)
Stat type “MIN” The number of minutes the player played in the game
Stat type “FGM” The number of fields goals made by the player
Stat type “FGA” The number of field goals attempted by the player
Stat type “3PM” The number of 3 point shots made by the player
Stat type “3PA” The number of 3 point shots attempted by the player
Stat type “FTM” The number of free throws made by the player
Stat type “FTA” The number of free throws attempted by the player
Stat type “+/-“ The players +/- total for the game
Stat type “OFF” The number of offensive rebounds for the player
Stat type “DEF” The number of defensive rebounds for the player
Stat type “TOT” The total number of rebounds for the player
Stat type “AST” The number of assists for the player
Stat type “PF” The number of fouls for the player
Stat type “ST” The number of steals for the player
Stat type “TO” The number of turnovers for the player
Stat type “BS” The number of blocked shots for the player
Stat type “BA” The number of shot attempts the player had blocked
Stat type “PTS” The number of points the player scored
DRAFT 04.17.12
29 SPORTSDATA NBA STATISTICS FEEDS
File Naming Convention
http://api.sportsdatallc.org/nba-[access_level][version]/seasontd?team=[team_id]&season_id=[season_id]&api_key=[your_api_key]
Parameter Format Notes [team_id] = integer
[season] = yyyy
[access_level] = Premium (p), Standard (s), Basic (b), Trial (t)
[version] = whole number (sequential, starting with the number 1)
Delivery Timing
This feed will be continually updated as events occur.
Copyright
The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.
DRAFT 04.17.12
30 SPORTSDATA NBA STATISTICS FEEDS
Events Glossary Feed – Details
This feed provides a real-time log of every game event.
Element/Attribute/Value Descriptions
File Breakdown – Play-by-Play Feed Element Attribute Values Description
EventTypes Child element: EventType
EventType type_id Dynamic Unique id of the event within the sport
name Dynamic The name of the game event
description Dynamic The description of the event
points_value Dynamic The number of points attributed to the event
set_timer Dynamic The number of seconds attributed to the event
DRAFT 04.17.12
31 SPORTSDATA NBA STATISTICS FEEDS
File Naming Convention
http://api.sportsdatallc.org/nba-[access_level][version]/events?api_key=[your_api_key]
Parameter Format Notes [access_level] = Premium (p), Standard (s), Basic (b), Trial (t)
[version] = whole number (sequential, starting with the number 1)
Delivery Timing
This feed will be continually updated as events are updated.
Copyright
The contents of this document may not be distributed, duplicated or made public in any way in parts or as a whole without prior written consent of SportsData LLC. This does not apply to copies solely intended for internal purposes.
Recommended