NBA Statistics Feeds - Sportradar · PDF file1 SPORTSDATA NBA STATISTICS FEEDS ! NBA Statistics Feeds 2011-12 Season . DRAFT 04.17.12 ! 2!SPORTSDATA NBA STATISTICS FEEDS ... Type “RESULTS

DRAFT 04.17.12

1 SPORTSDATA NBA STATISTICS FEEDS

NBA Statistics Feeds

2011-12 Season

DRAFT 04.17.12


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


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


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


Stats List – Play-by-Play


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


Stats List – Player


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


Stats List – Team


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


Stats List – Player Information


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


Stats List – Sport Information


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


Stats List – Team Information


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


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


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


Roster Feed – Details

This feed provides player information for each team, including height/weight, jersey number and position


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


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


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



Delivery Timing

This feed will be continually updated as events occur.

Copyright


DRAFT 04.17.12


Play-by-Play Feed – Details

This feed provides a real-time log of every game event.


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


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



Delivery Timing This feed will be continually updated as events occur.

Copyright


DRAFT 04.17.12


Statistics Feed – Details

This feed provides detailed game stats at the player and team level, including extensive offense and defense breakouts.


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


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


“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


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


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



http://api.sportsdatallc.org/nba-[access_level][version]/statistics?game_id=[game_id]&api_key=[your_api_key]




Delivery Timing


Copyright


DRAFT 04.17.12


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


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


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



http://api.sportsdatallc.org/nba-[access_level][version]/standings?season_id=[season]&api_key=[your_api_key]




Delivery Timing


Copyright


DRAFT 04.17.12


Season Statistics Feed – Details

This feed provides detailed game stats at the player and team level, including extensive offense, defense and special teams breakouts.


File Breakdown – Season Statistics Feed Element Attribute Values Description

SeasonStatistics competition_name Dynamic Name of 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


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



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



Delivery Timing


Copyright


DRAFT 04.17.12


Events Glossary Feed – Details

This feed provides a real-time log of every game event.


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



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)


Delivery Timing

This feed will be continually updated as events are updated.

Copyright


Documents

NBA Statistics Feeds - Sportradar · PDF file1 SPORTSDATA NBA STATISTICS FEEDS ! NBA Statistics Feeds 2011-12 Season . DRAFT 04.17.12 ! 2!SPORTSDATA NBA STATISTICS FEEDS ... Type “RESULTS