NHL Statistics Feeds

Size: px

Start display at page:

Download "NHL Statistics Feeds"

Robyn Cox
5 years ago
Views:

1 NHL Statistics Feeds Season 1 SPORTSDATA NHL STATISTICS FEEDS

2 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 Schedule Feed Details Roster Feed Details Play-by-Play Feed Details Statistics Feed Details Standings Feed Details Season Statistics Feed Details Event Feed Details SPORTSDATA NHL STATISTICS FEEDS

and delivery using new technology that results in the fastest updates in the industry.

From instant play-by-play to in-game clean up, official and final we maintain the highest standard in data accuracy. Simplicity.

seamless. Speed. We offer true real-time delivery of data using highly-optimized publishing techniques. Service.

NHL Statistics Feeds We package our comprehensive stats collection into seven main feeds, each focused on serving specific information needs.

level statistics including wins, losses, points, and various win/loss splits Statistics detailed game stats at the player and team level,

3 DRAFT 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. NHL 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 Event provides a translation of the play by play events into a more meaningful text string 3 SPORTSDATA NHL STATISTICS FEEDS

4 Stats List Game Information Stat Schedule Standings Statistics 3 Stars Away Team Id Away Team Name Play by Play Date & Time End Time Ending Game Attendance Head Coaches Home Team Id Home Team Name Linesman Match Day Match Id Match Type Period (Status) Period Count Referee Round Type Score Shootout Score Side Start Time Team Id Team Name Team Rotation Number Team Score (Game) Team Side Time Remaining Venue Id Venue Location Venue Name Season Statistics Roster 4 SPORTSDATA NHL STATISTICS FEEDS

5 Stats List Play-by-Play Stat Schedule Standings Statistics Play by Play Season Statistics Roster Create Timestamp Event Id Minutes Period Id Player Id Seconds Team Id Type Id Update Timestamp 5 SPORTSDATA NHL STATISTICS FEEDS

6 Stats List Player Stat Schedule Standings Statistics Play by Play Season Statistics +/- Assists Attempts Blocked Average Time on Ice Blocked Shots Did Not Play DNP Reason Even Strength Time on Ice Face Off Percentage Face Offs Lost Face Offs Won Games Played Giveaways Goalie Loss Goalie Win Goals Hits Misses Penalties Penalty Minutes Points Power Play Time on Ice Save Percentage Saves Shifts Short Handed Time on Ice Shots Against Shots on Goal Shutouts Takeaways Time on Ice Total Time on Ice Roster 6 SPORTSDATA NHL STATISTICS FEEDS

7 Stats List Team Stat Schedule Standings Statistics Play by Play Season Statistics Assists Attempts Blocked Blocked Shots Face Off Percentage Face Offs Lost Face Offs Won Giveaways Goals Hits Misses Penalties Penalty Minutes Points Shots on Goal Takeaways Team Penalties Team Penalty Minutes Roster 7 SPORTSDATA NHL STATISTICS FEEDS

8 Stats List Player Information College Date of Birth Dominant Hand Stat Schedule Standings Statistics Play by Play Season Statistics First Name First Year Pro Height (cm) Height (in) Id Jersey Number Last Name Place of Birth Player Id Player Known Name Position Weight (kg) Weight (lbs) Roster 8 SPORTSDATA NHL STATISTICS FEEDS

9 Stats List Sport Information Stat Schedule Standings Statistics Play by Play Season Statistics Competition Id Competition Name Game Id MatchDay Season Id Season Name Sport Id Sport Name Roster 9 SPORTSDATA NHL STATISTICS FEEDS

10 Stats List Team Information Conference Conference Id Division Division Id Games Lost Games Played Games Won Goal Differential Home Record Last 10 Record Overtime Losses Points Points Against Points For Position Regulation Wins Road Record Shootout Record Stadium Name Streak Stat Schedule Standings Statistics Play by Play Season Statistics Team Id Team Name Team Nickname Winning Percentage Roster 10 SPORTSDATA NHL STATISTICS FEEDS

11 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 OptaDocument Child Element: 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 Integer identifier for season season_name Dynamic Sportsdata s season name timestamp Dynamic Timestamp of creation of data snapshot sport_id sport_name Dynamic Dynamic Child Element: MatchData MatchData uid Dynamic Unique identifier for this game Child Elements: MatchInfo, Stat, TeamData MatchInfo Period FullTime This game has officially finished PreMatch This game has yet to begin Appears if the game has been postponed. The period will remain like this until a new date is Postponed 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 SO The game ended in this overtime period The game ended in a shootout Venue_id Dynamic Unique Id for the game venue roundtype Dynamic The part of season or play-offs the game occurs in. 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. Score Dynamic The score for the described side. TeamData Side Home or Away team_id Dynamic The unique id for the team seed_position Dynamic For tournaments or playoffs, this is the seed the team has earned rotation Dynamic The unique rotation number for that team and game 11 SPORTSDATA NHL STATISTICS FEEDS

12 uid Dynamic The unique id for a team Team Child Element: Name Name N/A Dynamic The name of the team 12 SPORTSDATA NHL STATISTICS FEEDS

13 File Naming Convention [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. 13 SPORTSDATA NHL STATISTICS FEEDS

14 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 Date and time the file was created (YYYYtimestamp Dynamic MM-DDTHH:MM:SST-HH:MM) Child Element: OptaDocument OptaDocument This value at time of writing will always be set type SQUADS Latest to this text. competition_id Dynamic Unique id of the competition competition_name Dynamic Name of the competition season_id Dynamic Id for the season sport_id 13 Unique id for the sport sport_name Ice Hockey Name of the sport Child Element: Team Team uid Dynamic Unique id of the team Child Elements: name, SYMID, Nickname, Stadium, Player name N/A Dynamic Name of the team SYMID N/A Dynamic Internal key for a team Nickname N/A Dynamic Nickname 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 Dynamic Name of the player Position N/A C The players position D G LW RW 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 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 Stat type jersey_num Player s jersey number 14 SPORTSDATA NHL STATISTICS FEEDS

15 Stat type place_of_birth Player s place of birth Stat type first_year_pro Player s rookie year Stat type dominant_hand Player s dominant hand Stat type College Player s college alma mater 15 SPORTSDATA NHL STATISTICS FEEDS

16 File Naming Convention [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. 16 SPORTSDATA NHL STATISTICS FEEDS

17 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 13 Unique id for the sport sport_name Ice Hockey 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 Unique id for the season 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) 17 SPORTSDATA NHL STATISTICS FEEDS

18 File Naming Convention 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. 18 SPORTSDATA NHL STATISTICS FEEDS

19 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 13 Unique id of the sport sport_name Ice Hockey Name of the sport Child Elements: Competition, MatchData, Team, Venue Competition uid Dynamic Unique id of the competition Child Elements: Name, Stat 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 Postponed FirstPeriod SecondPeriod ThirdPeriod Overtime Shootout This game has yet to begin 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. The game is in the first quarter The game is in the second quarter The game is in the third quarter The game is in overtime The game is in a shootout matchtype Regular This value will always be set to this value Ending REG The game ended in regulation time OTx SO Child Elements: Date, Result The game ended in this particular overtime The game ended in a shootout 19 SPORTSDATA NHL STATISTICS FEEDS

20 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 Shootout Abandoned PostPoned The game ended in overtime The game ended in a shootout The game was abandoned before completion The game was postponed winner Dynamic The unique id of the winning team Stat type Attendance The attendance of the game Stat type Referees The referees who worked the game Stat type Linesmen The linesmen who worked the game Stat type Headcoachs The head coaches of each team Stat type 3 Stars The 3 stars of the game Stat type Start Time The start time of the game Stat type End Time The end time of the game Stat type Period Count The length of the game in periods, including OT and Shootout periods TeamData score Dynamic The total number of points the team scored in the game side Home Displays which team was the home team Away and which one was the away team_id Dynamic The unique id of the team shootoutscore Dynamic The number of goals scored in a Shootout Child element: Goal, Stat, PlayerLineUp Goal period FirstPeriod The scoring event occurred in the first period SecondPeriod ThirdPeriod Overtime Shootout The scoring event occurred in the second period The scoring event occurred in the third period The scoring event occurred in overtime The scoring event occurred in a shootout 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 The number of the 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 20 SPORTSDATA NHL STATISTICS FEEDS

21 period 1-x The team s points scored each period Stat type G The number of goals by the team Stat type A The number of assists by the team Stat type P The number of points by the team Stat type PEN The number of penalties by the team Stat type PIM The number of penalty minutes for the team Stat type SOG The number of shots on goal for the team Stat type A/B The number of shot attempts that were blocked for the team Stat type MS The number of number of missed shots for the team Stat type HT The number of hits by the team Stat type GV The number of giveaways for the team Stat type TK The number of takeaways for the team Stat type BS The number of blocked shots for the team Stat type FW The number of face offs won by the team Stat type FL The number of face offs lost by the team Stat type F% The face off percentage for 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 goalie is in the game. Child element: Stat No The goalie is not in the game. Default value for skaters. 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 G The number of goals for the player Stat type A The number of assists for the player Stat type P The number of points for the player Stat type +/- The +/- for the player Stat type PEN The number of penalties for the player Stat type PIM The number penalty minutes for the player Stat type TOT The total time on ice for the player Stat type SHF The number of shifts for the player 21 SPORTSDATA NHL STATISTICS FEEDS

22 Stat type AVG The average time on ice for the player Stat type PP The power play time on ice for the player Stat type SH The short handed time on ice for the player Stat type EV The even strength time on ice for the player Stat type SOG The shots on goal for the player Stat type A/B The number of shot attempts blocked for the player Stat type MS The missed shots for the player Stat type HT The number of hits for the player Stat type GV The number of giveaways for the player Stat type TK The number of takeaways for the player Stat type BS The number of blocked shots for the player Stat type FW The number of face offs won Stat type FL The number of face offs lost Stat type F% The players face off percentage Stat type ShotsAgainst The number of shots the goalie faced Stat type Saves The number of saves by the goalie Stat type SV% The goalies save percentage Stat type SO Did the goalie post a shutout (1 for yes) Stat type WIN Did the goalie get the win (1 for yes) Stat type LOSS Did the goalie get the loss (1 for yes) Team uid Dynamic The teams unique id Child Element: Name, Player Name N/A N/A The name of the team Player position C The players position PersonName D G LW RW uid Dynamic The unique id of the player Child element: PersonName Child elements: First, Last First N/A Dynamic The player s first name Last N/A Dynamic The player s last name 22 SPORTSDATA NHL STATISTICS FEEDS

23 File Naming Convention [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. 23 SPORTSDATA NHL STATISTICS FEEDS

24 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 TeamStandings 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 timestamp Dynamic Date and time the file was created (YYYY- MM-DDTHH:MM:SST-HH:MM) sport_id 13 The unique id of the sport sport_name Ice Hockey The name of the sport Child element: TeamStandings Child element: TeamRecord TeamRecord team_id Dynamic The unique id of the tem position Dynamic The team s ranking within the conference Child element: Standing Standing type Full The value 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: Played, Won, Lost, OverTimeLosses, Points, RegulationWins, For, Against, GoalDifferential, HomeRecord, AwayRecord, Shootout, LastTen, Streak Played N/A Dynamic The number of games played Won N/A Dynamic The number of games the team has won Lost N/A Dynamic The number of games the team has lost OverTimeLosses N/A Dynamic The number of overtime losses Points N/A Dynamic The number of points by the team RegulationWins N/A Dynamic The number of games won in regulation For N/A Dynamic The number of goals scored Against N/A Dynamic The number of goals allowed 24 SPORTSDATA NHL STATISTICS FEEDS

25 GoalDifferential N/A Dynamic The delta of for and against HomeRecord N/A Dynamic The team s record at home AwayRecord N/A Dynamic The team s away record Shootout N/A Dynamic The teams record in shootouts LastTen N/A Dynamic The teams record over the last 10 games Streak N/A Dynamic The teams current win/loss streak 25 SPORTSDATA NHL STATISTICS FEEDS

26 File Naming Convention [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. 26 SPORTSDATA NHL STATISTICS FEEDS

27 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 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 13 The unique id of the sport sport_name Ice Hockey The name of the sport Child Element: Team Team name Dynamic The name of the team Child Element: Stat, Player Stat type G The number of goals by the team Stat type A The number of assists by the team Stat type P The number of points by the team Stat type PEN The number of penalties by the team Stat type PIM The number of penalty minutes for the team Stat type SOG The number of shots on goal for the team Stat type A/B The number of shot attempts that were blocked for the team Stat type MS The number of number of missed shots for the team Stat type HT The number of hits by the team Stat type GV The number of giveaways for the team Stat type TK The number of takeaways for the team Stat type BS The number of blocked shots for the team Stat type FW The number of face offs won by the team Stat type FL The number of face offs lost by the team Stat type F% The face off percentage for 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 27 SPORTSDATA NHL STATISTICS FEEDS

28 first_name Yes The player s first name Child element: Stat Stat type GP The number of games played Stat type DNP The number of games not played Stat type G The number of goals for the player Stat type A The number of assists for the player Stat type P The number of points for the player Stat type +/- The +/- for the player Stat type PEN The number of penalties for the player Stat type PIM The number penalty minutes for the player Stat type TOT The total time on ice for the player Stat type SHF The number of shifts for the player Stat type AVG The average time on ice for the player Stat type PP The power play time on ice for the player Stat type SH The short handed time on ice for the player Stat type EV The even strength time on ice for the player Stat type SOG The shots on goal for the player Stat type A/B The number of shot attempts blocked for the player Stat type MS The missed shots for the player Stat type HT The number of hits for the player Stat type GV The number of giveaways for the player Stat type TK The number of takeaways for the player Stat type GV The number of giveaways for the player Stat type TK The number of takeaways for the player Stat type BS The number of blocked shots for the player Stat type FW The number of face offs won Stat type FL The number of face offs lost Stat type F% The players face off percentage Stat type ShotsAgainst The number of shots the goalie faced Stat type Saves The number of saves by the goalie Stat type SV% The goalies save percentage Stat type SO The goalies number of wins Stat type WIN The goalies number of wins Stat type LOSS The goalies number of losses 28 SPORTSDATA NHL STATISTICS FEEDS

29 File Naming Convention [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. 29 SPORTSDATA NHL STATISTICS FEEDS

30 Event 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 points_value Dynamic The number of points attributed to the event parent_event_type_id Dynamic The unique id of the parent event within the sport description Dynamic The description of the event event_duraton Dynamic The length of time attributed to the event set_timer Dynamic The number of seconds attributed to the event 30 SPORTSDATA NHL STATISTICS FEEDS

31 File Naming Convention 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. 31 SPORTSDATA NHL STATISTICS FEEDS

NBA Statistics Feeds

NBA Statistics Feeds 2012-13 Season 1 SPORTSDATA NBA STATISTICS FEEDS Table of Contents Overview... 3 Schedule, Game & Venue Information... 4 Player & Team Information... 5 Play-by-Play Information...