Soccer Statistics Feeds

Transcription

1 Soccer Statistics Feeds SPORTSDATA SOCCER STATISTICS FEEDS

2 Table of Contents Overview... 3 Soccer Statistics Feeds... 4 Category Information... 5 Tournament Group Information... 6 Tournament Information... 7 Match Information Venue Information Player Information Team Information Boxscore Information & Facts Match Statistics - Player Match Statistics - Team Season Statistics - Player Season Statistics - Team Frequently Asked Questions SPORTSDATA SOCCER STATISTICS FEEDS

3 Overview The Gold Standard in Real-Time Sports Stats SportsData s team of data-entry experts process 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 focus on: Accuracy. From live hole-by-hole scoring to post-round cleanup, official and final, we maintain the highest standard in data accuracy. Simplicity. We deliver your sports data feed to meet customer specifications, in any industry-standard format; our flexibility makes your transition fast and seamless. Speed. We offer 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. 3 SPORTSDATA SOCCER STATISTICS FEEDS

4 Soccer Statistics Feeds We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs: provides match information and scoring, including team statistics, for all matches played on a given day provides scheduled match information, including category, tournament, and league information, for all matches played on a given day provides match information and scoring, including team and player statistics, for all matches played on a given day - provides match information and scoring, including team statistics provides match information and scoring, including team and player statistics, lineups, and play by play provides team and player information including a player s statistics for each category, tournament, or league team provides player rankings for goals, assists, points, cards, and own goals provides scheduled match information for all categories, tournaments, and leagues provides scheduled match information for all categories, tournaments, and leagues category, tournament, league, and team identification and association information team information and statistics, including player roster information 4 SPORTSDATA SOCCER STATISTICS FEEDS

5 Category Information Country Country Code Id Name category country String category country_code String category id GUID category name String 5 SPORTSDATA SOCCER STATISTICS FEEDS

6 Tournament Group Information Id Name Season Season End Date/Time Season Start Date/Time tournament_group id GUID tournament_group name String tournament_group season String tournament_group season_end DateTime tournament_group season_start DateTime 6 SPORTSDATA SOCCER STATISTICS FEEDS

7 Tournament Information Id Leg Away Score Leg Away Team Leg Home Score Leg Home Team Leg Match Id Leg Match Status Leg Number tournament id GUID leg away_score Integer leg away_id GUID leg home_score Integer leg home_id GUID leg match_id GUID leg status String leg number Integer 7 SPORTSDATA SOCCER STATISTICS FEEDS

8 Name Round Aggregate Flag Round Loser Round Loser s Score Round Name Round Number Round d Length Round Type tournament name String round aggregate Boolean Note: Appears for cup rounds only. round loser_id GUID Note: Appears for cup rounds only. round losers_points Integer Note: Appears for cup rounds only. round name String Note: Appears for cup rounds only. round number Integer round scheduled_legs Integer Note: Appears for cup rounds only. round type Integer 8 SPORTSDATA SOCCER STATISTICS FEEDS

9 Round Week Round Winner Round Winner s Score Season Season End Date/Time Season Start Date/Time Note: Please see the FAQ section for more information. round week Integer round winner_id GUID Note: Appears for cup rounds only. round winner_points Integer Note: Appears for cup rounds only. tournament season String tournament season_end DateTime tournament season_start DateTime 9 SPORTSDATA SOCCER STATISTICS FEEDS

10 Match Information Away Team Alias away alias String Away Team Country away country String Away Team Country Code away country_code String Away Team Id away id GUID Away Team Name away name String Away Team Type away type String Coverage Corner Facts Flag coverage corner_facts Boolean Note: Please see the FAQ section for more information. Coverage Deep Facts Flag coverage deep_facts Boolean Note: Please see the FAQ section for more information. Coverage Extended Facts Flag coverage extended_facts Boolean Note: Please see the FAQ section for more information. Coverage Lineups Flag coverage lineups Integer 10 SPORTSDATA SOCCER STATISTICS FEEDS

11 Note: Please see the FAQ section for more information. Coverage Statistics Flag coverage statistics Boolean Note: Please see the FAQ section for more information. Coverage Tactical Lineups Flag coverage tactical_lineups Boolean Note: Please see the FAQ section for more information. Home Team Alias home alias String Home Team Country home country String Home Team Country Code home country_code String Home Team Id home id GUID Home Team Name home name String Home Team Type home type String Id match id GUID Period match period String 11 SPORTSDATA SOCCER STATISTICS FEEDS

12 Referee Country Referee Country Code Referee First Name Referee Id Referee Last Name d Start Scratched Flag Status Note: Please see the FAQ section for more information. referee country String referee country_code String referee first_name String referee id GUID referee last_name Sring match scheduled Date/Time match scratched Boolean Note: True means the game is not valid. match status String Note: Please see the FAQ section for more information. 12 SPORTSDATA SOCCER STATISTICS FEEDS

13 Venue Information Capacity City Coordinates Country Country Code Id Name venue capacity Integer venue city String venue coordinates String venue country String venue country_code String venue id GUID venue name String 13 SPORTSDATA SOCCER STATISTICS FEEDS

14 Player Information Country player country String Country Code player country_code String First Name player first_name String Height ( cm ) player height_cm Integer Height ( in ) player height_in Integer Id player id GUID player Jersey Number jersey_number Integer team player Last Name player last_name String Manager Flag team is_manager Boolean On Loan Flag team is_onloan Boolean Player Flag team is_player Boolean player team position Integer Position player Note: Please see the FAQ section for more information. Preferred Foot player preferred_foot String Tactical Order player tactical_order Integer Tactical Position player tactical_position Integer Note: Please see the FAQ section for more information. Weight ( kg ) player weight_kg Integer Weight ( lb ) player weight_lb Integer 14 SPORTSDATA SOCCER STATISTICS FEEDS

15 15 SPORTSDATA SOCCER STATISTICS FEEDS

16 Team Information Alias Country Country Code Id Manager Country Manager Country Code Manager First Name Manager Id Manager Last Name Name Type team alias String team country String team country_code String team id GUID manager country String manager country_code String manager first_name String manager id GUID manager last_name String team name String team type String Note: The valid values are team and proxy 16 SPORTSDATA SOCCER STATISTICS FEEDS

17 Boxscore Information Away Team 1st Half Score Away Team 2nd Half Score Away Team Overtime Score Away Team Penalty Score Away Team Score Away Team Winner Flag Half Number Home Team 1st Half Score Home Team 2nd Half Score Home Team Overtime Score Home Team Penalty Score Home Team Score Home Team Winner Flag half points Integer half points Integer half points Integer half points Integer away score Integer away winner String Note: The valid values are true, false, and draw half number Integer half points Integer half points Integer half points Integer half points Integer home score Integer home winner String 17 SPORTSDATA SOCCER STATISTICS FEEDS

18 Note: The valid values are true, false, and draw 18 SPORTSDATA SOCCER STATISTICS FEEDS

19 & Facts Away Score Card Clock Description Draw Flag Header Flag Home Score Id Injury Time Insert Time Own Goal Flag Penalty Flag Period Player Id Player In Player Out Scratch Team Id Type Update Time Winner Id X Coordinate Y Coordinate fact away_score Integer fact card String fact clock Integer description String fact draw Boolean fact header Boolean fact home_score Integer fact id GUID fact injury_time Integer fact time DateTime fact owngoal Boolean fact penalty Boolean fact period String fact player_id GUID fact player_in_id GUID fact player_out_id GUID fact scratch Boolean fact team_id GUID fact type String Note: Please see the FAQ section for more information. fact updated_time DateTime fact winner_id GUID fact x Integer fact y Integer 19 SPORTSDATA SOCCER STATISTICS FEEDS

20 Match Statistics - Player Assists Goals Red Cards Start Substitutions In Substitutions Out Yellow Cards Yellow / Red Cards statistics goal_assist Integer statistics goal Integer statistics red_card Integer player started Boolean statistics substitution_in Integer statistics substitution_out Integer statistics yellow_card Integer statistics yellow_red_card Integer 20 SPORTSDATA SOCCER STATISTICS FEEDS

21 Match Statistics - Team Attacks Corner Kicks Dangerous Attacks Fouls Free Kicks Goal Attempts Goal Kicks Offsides Possessions Red Cards Safe Balls Saves Shots statistics attacks Integer statistics corner_kicks Integer statistics dangerous_attacks Integer statistics fouls Integer statistics free_kicks Integer statistics goal_attempts Integer statistics goal_kicks Integer statistics offsides Integer statistics possessions Integer statistics red_card Integer statistics ball_safe Integer statistics saves Integer statistics shots_total Integer 21 SPORTSDATA SOCCER STATISTICS FEEDS

22 Shots off Target Shots on Target Substitutions Throw Ins Yellow Cards Yellow/Red Cards statistics shots_off_target Integer statistics shots_on_target Integer statistics substitutions Integer statistics throw_ins Integer statistics yellow_card Integer statistics yellow_red_card Integer 22 SPORTSDATA SOCCER STATISTICS FEEDS

23 Season Statistics - Player Assists statistic goal_assists Integer Goal Frequency statistic goal_frequency Integer Goals statistic goals Integer Goals Average statistic goal_average Integer Matches Played statistic matches_played Integer Matches Started statistic matches_started Integer Minutes Played statistic minutes_played Integer Red Cards statistic red_cards Integer Substitutions In statistic substitutions_in Integer Substitutions Out statistic substitutions_out Integer Yellow Cards statistic yellow_cards Integer Yellow/Red Cards statistic yellow_red_cards Integer 23 SPORTSDATA SOCCER STATISTICS FEEDS

24 Season Statistics - Team Cards statistic cards Integer Corner Kicks statistic corner_kicks Integer Free Kicks statistic free_kicks Integer Matches Played statistic matches Integer Possessions statistic possessions Integer Shots Blocked statistic shots_blocked Integer Shots Off Target statistic shots_off_target Integer Shots On Target statistic shots_on_target Integer 24 SPORTSDATA SOCCER STATISTICS FEEDS

25 Assists team assists Integer Goals team goals Integer Matches Played team matches Integer Own Goals team own_goals Integer Player Rank player rank Integer Points team points Integer Red Cards team red_cards Integer Substitutions In team substituted_in Integer Total Assists total assists Integer Total Goals total goals Integer Total Matches Played total matches Integer Total Own Goals total own_goals Integer Total Points total points Integer Total Red Cards total red_cards Integer Total Substitutions In total substituted_in Integer Total Yellow Cards total yellow_cards Integer Total Yellow/Red Cards total yellowred_cards Integer Yellow Cards team yellow_cards Integer Yellow/Red Cards team yellowred_cards Integer 25 SPORTSDATA SOCCER STATISTICS FEEDS

26 Change team change String Draws team draw Integer Goals Against team goals_against Integer Goals For team goals_for Integer Losses team loss Integer Points team points Integer Rank team rank Integer Wins team win Integer 26 SPORTSDATA SOCCER STATISTICS FEEDS

27 Frequently Asked Questions Q: What leagues or tournaments do you cover for soccer? A: We cover numerous leagues and tournaments. We break the information out into specific packages. Here is a table with the groups and leagues currently covered: Package Name Package Abbr Category Tournament Group Canada Canadian Soccer League North American NA Mexico Primera Division United States Major League Soccer Austria Bundesliga Belgium Pro League Denmark Superligaen England FA Cup League Cup Premier League France Ligue 1 Germany Bundesliga Greece Super League International International Friendlies UEFA UE UEFA Champions League International Clubs UEFA Europa League Italy Serie A Netherlands Eredivisie Portugal Primeira Liga Russia Premiere League Spain Primera Division Switzerland Super League Turkey Super Lig Ukraine Premier League World Cup WC International World Championship Q: What time zone are the date time fields presented in? A: All of our DateTime attributes are in UTC, presented in the ISO 8601 standard format. ex: T18:15:00+00:00 For more information: Q: What are the valid match period values? A: Here are the valid match period values and their definitions: P1 = Period one H = Halftime P2 = Period two PX1 = Pre-extra time one X1 Extra time one PX2 = Pre-extra time two 27 SPORTSDATA SOCCER STATISTICS FEEDS

28 X2 = Extra time two PP = Pre-penalty P = Penalty Q: What are the valid match status values? A: Here are the valid match status values and their definitions: scheduled The match is scheduled to be played inprogress The match is currently in progress postponed The match has been postponed to a future date delayed The match has been temporarily delayed and will be continued canceled The match has been canceled and will not be played closed The match is over Q: What are the valid player position values? A: Here are the valid player position values and their definitions: G = Goalie D = Defender M = Midfielder F = Forward Q: What are the valid player tactical position values? A: Here are the valid player tactical position values and their definitions: 0 = Unknown 1 = Goalkeeper 2 = Right back 3 = Central defender 4 = Left back 5 = Right winger 6 = Central midfielder 7 = Left winger 8 = Forward Q: What do each of the 5 coverage elements mean as far as the data I can expect to receive based on the coverage flags? A: Here are the coverage flags and what their values mean: Lineups 0 = Lineups have not been created yet 1 = Lineups have been created and are pending confirmation 2 = Lineups have been confirmed Tactical Lineups true = You get detailed position information Corner Facts true = You get corner facts in the summary feeds 28 SPORTSDATA SOCCER STATISTICS FEEDS

29 Extended Facts true = You will get all cards, free kicks, throw ins, and penalty time facts in the summary feeds Deep Facts true = You get X and Y coordinates included with all facts in the summary feeds Statistics true = You get team and player statistics for the match Q: What are the valid round types? A: Here are the valid round types: cup standard table Q: What are the possible fact types logged? A: Here are all of the possible fact types we log: card corner_kick free_kick game_resumed goal goal_kick injury injury_return injury_time keeper_save match_ended match_started offside penalty_awarded penalty_missed period_over period_started shot_blocked shot_off_target shot_on_target substitution throwin 29 SPORTSDATA SOCCER STATISTICS FEEDS