Tennis Statistics Feeds - Sportradar US · kaz Kazakh sqi Albanian br Brazilian Portuguese srl...

Updated 08.28.17

1 SPORTRADAR TENNIS STATISTICS FEEDS

Tennis Statistics Feeds

2017

Updated 08.28.17


Table of Contents

Tennis Statistics Feeds..................................................................................................................................................3

Coverage Levels................................................................................................................................................................4

Language Support............................................................................................................................................................5

Sport & Category Information.....................................................................................................................................6

Tournament Information................................................................................................................................................8

Competitor Information...............................................................................................................................................13

Venue Information.........................................................................................................................................................18

Probability Information................................................................................................................................................20

Sport Event Information..............................................................................................................................................21

Statistics Information...................................................................................................................................................24

Timeline Information.....................................................................................................................................................25

Standings Information.................................................................................................................................................26

Frequently Asked Questions.....................................................................................................................................27

Document Change History.........................................................................................................................................31

Updated 08.28.17


Tennis Statistics Feeds We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs:

Daily Results - Returns a list of results for all tournaments given a specific date: yyyy-mm-dd Daily Schedule - Returns a schedule of upcoming matches for all tournaments given a specific date: yyyy-mm-dd Deleted Matches - Returns a list of all events that have been removed from coverage Doubles Head-To-Head - returns past and upcoming matches between two doubles teams given 2 competitor IDs Doubles Team Profile - Lists profile information for a doubles team such as form, information about the players comprising the team Doubles Team Race Rankings - Rankings for the ATP/WTA finals Doubles Team Rankings - Rankings in order ascending order for doubles teams Doubles Team Results - Results given a doubles team competitor ID Doubles Team Schedule - Returns all scheduled matches for a given doubles team competitor ID Match Probabilities - Returns to 3-way outrights pre-match given a matchID Match Summary - Returns information for a match including live updates and statistics Match Timeline - Returns information for a given match ID including a timeline of events, (point-by-point or Game-by-Game depending on the coverage) and some basic stats. Player Head-To-Head - Provided past and upcoming match details between two singles players given two competitor IDs Player Profile - Provides stats and information pertaining to a single player Player Race Rankings - Returns a list in ascending order for the race to the ATP/WTA finals Player Rankings - Returns a list in ascending order of ATP/WTA world rankings Player Results - Returns a listing of results given a single player ID Player Schedule - Returns a schedule of upcoming matches for a given player ID Tournaments - Lists all tournaments in the API Tournament Info - Returns key information for a given tournament ID Tournament Ongoing - Returns a list of currently ongoing tournaments Tournament Results - Returns a list of results for a given tournament ID Tournament Schedule - Returns a schedule for a given tournament ID Tournament Seasons - Returns a list of seasons, the IDs of which can be used interchangeably with "tournament_id" to access historical results

Updated 08.28.17


Coverage Levels

Coverage levels are done both on a tournament-by-tournament basis and a match-by-match basis. Meaning that there is variance between matches covered in tournaments, and between tournaments themselves.

All ITF, Hopman, Davis and Fed Cup matches are covered in a point-by-point basis. For Grand slams, ATP and WTA and Challenger tournaments, not all matches are able to be covered point-by-point. Point-by-point coverage usually begins at round 1 of tournaments, and in the case of Grand Slams, from the qualifying stages.

Where matches can’t be covered in point-by-point fashion, game-by-game coverage is provided near-live. In the case of Olympics and Exhibition matches, the point-by-point coverage is largely determined by the availability of reliability of broadcasts.

In general, when covering matches point-by-point, priority is given to important matches, higher seeds, and major courts to ensure that the majority of matches carrying the highest interest are covered. All others are provided by in game-by-game live or near-live.

Where a match is provided live, point-by-point, key match stats are also provided:

• games won • max games in a row • points won • max points in a row • aces • first serve successful • first serve points won • double faults • second serve points won • breakpoints won

Updated 08.28.17


Language Support We provide support for a large set of languages. The language support primarily affects names of players, teams, tournaments etc. Different languages are obtained through different endpoints where the only difference is the language part of the path. The language part is any valid ISO-646 language code. For languages we don’t provide specific translations for we return back the names in English. Code Language it Italian en English de German fr French se Swedish es Spanish ru Russian zh Chinese (simplified) zht Chinese (traditional) ja Japanese hr Croatian tr Turkish sk Slovak sl Slovenian no Norwegian da Danish nl Dutch pl Polish pt Portuguese cs Czech fi Finnish th Thai hu Hungarian bg Bulgarian ek Greek ro Romanian ukr Ukrainian et Estonian lv Latvian bs Bosnian sr Serbian ml Macedonian lt Lithuanian id Indonesian vi Vietnamese ko Korean aa Arabic aze Azerbaijan ka Georgian heb Hebrew kaz Kazakh sqi Albanian br Brazilian Portuguese srl Serbian Latin

Updated 08.28.17


Sport & Category Information

Stat Feeds Element Attribute Format

Category Id

Daily Results

category id String

Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Profile Player Results Player Schedule Tournaments Tournament Info Tournament Ongoing Tournament Results Tournament Schedule Tournament Season

Category Name

Daily Results

category name String


Sport Id

Daily Results

sport id String

Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Profile Player Results Player Schedule Tournaments

Updated 08.28.17


Tournament Info Tournament Ongoing Tournament Results Tournament Schedule Tournament Season

Sport Name

Daily Results

sport name String


Updated 08.28.17


Tournament Information


Current Season End Date Tournaments

current_season end_date Date Tournament Info Tournament Ongoing

Current Season Id Tournaments

current_season id Id Tournament Info Tournament Ongoing

Current Season Name Tournaments

current_season name String Tournament Info Tournament Ongoing

Current Season Start Date Tournaments

current_season start_date Date Tournament Info Tournament Ongoing

Current Season Year Tournaments

current_season year String Tournament Info Tournament Ongoing

Info Number of Competitors Tournament Info info number_of_competitors Integer Info Prize Money Tournament Info info prize_money Integer Info Prize Money Currency Tournament Info info prize_currency String Info Surface Type Tournament Info info surface String

Season End Date

Daily Results

season end_date Date

Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results Player Schedule Tournament Results Tournament Schedule Tournament Season

Season Id

Daily Results

season id Id


Season Name

Daily Results

season name String Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule

Updated 08.28.17


Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results Player Schedule Tournament Results Tournament Schedule Tournament Season

Season Start Date

Daily Results

season start_date Date


Season Tournament Id

Daily Results

season tournament_id Id


Season Year

Daily Results

season year String


Stage Type Tournament Info stage type String

Tournament Gender

Daily Results

tournament gender String Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Results

Updated 08.28.17


Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Profile Player Results Player Schedule Tournaments Tournament Info Tournament Ongoing Tournament Results Tournament Schedule Tournament Season

Tournament Id

Daily Results

tournament id Id


Tournament Name

Daily Results

tournament name String


Tournament Parent Id

Daily Results

tournament parent_id Id Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Results

Updated 08.28.17


Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Profile Player Results Player Schedule Tournaments Tournament Info Tournament Ongoing Tournament Results Tournament Schedule Tournament Season

Tournament Type

Daily Results

tournament type String


Tournament Round Name

Daily Results

tournament_round name String

Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results Player Schedule Tournament Info Tournament Results Tournament Schedule

Tournament Round Number

Daily Results

tournament_round number Integer

Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results

Updated 08.28.17


Player Schedule Tournament Info Tournament Results Tournament Schedule

Tournament Round Type

Daily Results

tournament_round type String


Winner Last Season Abbreviation Tournament Info winner_last_season abbreviation String Winner Last Season Id Tournament Info winner_last_season id Id Winner Last Season Name Tournament Info winner_last_season name String

Updated 08.28.17


Competitor Information


Player Abbreviation

Daily Results

player abbreviation String

Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Race Ranking Doubles Team Rankings Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Profile Player Race Rankings Player Rankings Player Results Player Schedule Tournament Info Tournament Results Tournament Schedule

Player Bracket Number

Daily Results

player bracket_number Integer

Daily Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results Player Schedule Tournament Info Tournament Results Tournament Schedule

Player Country Code

Daily Results

player country_code String

Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Race Ranking Doubles Team Rankings Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Profile Player Race Rankings Player Rankings Player Results Player Schedule Tournament Results Tournament Schedule

Player Date of Birth Player Profile player date_of_birth Date Player Handedness Player Profile player handedness String

Updated 08.28.17


Player Id

Daily Results

player id Id


Player Name

Daily Results

player name String


Player Nationality

Daily Results

player nationality String

Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Race Ranking Doubles Team Rankings Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Profile Player Race Rankings Player Rankings Player Results Player Schedule

Updated 08.28.17


Tournament Info Tournament Results Tournament Schedule

Player Pro Year Player Profile player pro_year String Player Qualification Path Tournament Info player qualification_path String

Player Qualifier

Daily Results

player qualifier String


Player Seed

Daily Results

player seed Integer


Doubles Team Abbreviation

Daily Results

doubles_team abbreviation String

Daily Schedule Doubles Team Head-To-Head Doubles Team Profile Doubles Team Race Rankings Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Tournament Info Tournament Results Tournament Schedule

Doubles Team Bracket Number

Daily Results

doubles_team bracket_number Integer

Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Tournament Info Tournament Results

Updated 08.28.17


Tournament Schedule

Doubles Team Country Code

Daily Results

doubles_team country_code String


Doubles Team Id

Daily Results

doubles_team id Id


Doubles Team Name

Daily Results

doubles_team name String


Doubles Team Qualifier

Daily Results

doubles_team qualifier String

Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Tournament Info Tournament Results Tournament Schedule

Doubles Team Seed Daily Results doubles_team seed Integer Daily Schedule

Updated 08.28.17


Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Tournament Info Tournament Results Tournament Schedule

Team Abbreviation Match Summary team abbreviation String Match Timeline

Team Id Match Summary team id Id Match Timeline

Team Name Match Summary team name String Match Timeline

Team Qualifier Match Summary team qualifier Boolean Match Timeline

Updated 08.28.17


Venue Information


City Name

Daily Results

venue city_name String

Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results Player Schedule Tournament Results Tournament Schedule

Country Name

Daily Results

venue country_name String


Country Code

Daily Results

venue country_code String


Id

Daily Results

venue id Id


Updated 08.28.17


Name

Daily Results

venue name String


Updated 08.28.17


Probability Information


Away Team Win Probability Match Probability outcome probabilitiy String Home Team Win Probability Match Probability outcome probabilitiy String Market Name Match Probability market name String Outcome Name Match Probability outcome name String

Updated 08.28.17


Sport Event Information


Coverage Info Detailed Serve Outcomes Match Timeline coverage_info detailed_serve_outcomes String Coverage Info Live Coverage Match Timeline coverage_info live_coverage String Coverage Info Play-By-Play Match Timeline coverage_info play_by_play String

Period Score Away Score

Daily Results

period_score away_score Integer

Doubles Team Head-To-Head Doubles Team Results Match Summary Match Timeline Player Head-To-Head Player Results Tournament Results

Period Score Away Tiebreak Score

Daily Results

period_score away_tiebreak_score Integer


Period Score Home Score

Daily Results

period_score home_score Integer


Period Score Home Tiebreak Score

Daily Results

period_score home_tiebreak_score Integer


Period Score Number

Daily Results

period_score number Integer


Period Score Type Daily Results

period_score type String Doubles Team Head-To-Head

Updated 08.28.17


Doubles Team Results Match Summary Match Timeline Player Head-To-Head Player Results Tournament Results

Sport Event Conditions Match Mode

Daily Results

sport_event_conditions match_mode String


Sport Event Id

Daily Results

sport_event id Id

Daily Schedule Deleted Matches Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results Player Schedule Tournament Results Tournament Schedule

Sport Event Scheduled

Daily Results

sport_event scheduled Date/Time


Sport Event Start Time To Be Determined

Daily Results

sport_event start_time_tbd Boolean

Daily Schedule Doubles Team Head-To-Head Doubles Team Results Doubles Team Schedule Match Probabilities Match Summary Match Timeline Player Head-To-Head Player Results Player Schedule Tournament Results

Updated 08.28.17


Tournament Schedule

Sport Event Status Daily Schedule sport_event status String Tournament Schedule

Sport Event Status Away Score

Daily Results

sport_event_status away_score Integer


Sport Event Status Home Score

Daily Results

sport_event_status home_score Integer


Sport Event Status – Status

Daily Results

sport_event_status status String


Sport Event Status Winner Id

Daily Results

sport_event_status winner_id Id


Sport Event Status Winning Reason

Daily Results

sport_event_status winning_reason String


Weather Info – Weather Conditions

Daily Results

weather_info weather_conditions String

Match Summary Match Timeline Player Head-To-Head Player Results Tournament Results

Updated 08.28.17


Statistics Information


Aces Match Summary statistics aces Integer Match Timeline

Breakpoints Won Match Summary statistics breakpoints_won Integer Match Timeline

Double Faults Match Summary statistics double_faults Integer Match Timeline

First Serve Points Won Match Summary statistics first_serve_points_won Integer Match Timeline

First Serve Successful Match Summary statistics first_serve_successful Integer Match Timeline

Games Won Match Summary statistics games_won Integer Match Timeline

Matches Played Doubles Team Profile statistics played Integer Player Profile

Matches Won Doubles Team Profile statistics won Integer Player Profile

Max Games in a Row Match Summary statistics max_games_in_a_row Integer Match Timeline

Max Points in a Row Match Summary statistics max_points_in_a_row Integer Match Timeline

Period Year Doubles Team Profile period year String Player Profile

Points Won Match Summary statistics points_won Integer Match Timeline

Receiver Points Won Match Summary statistics receiver_points_won Integer Match Timeline

Second Serve Points Won Match Summary statistics second_serve_points_won Integer Match Timeline

Second Serve Successful Match Summary statistics second_serve_successful Integer Match Timeline

Service Games Won Match Summary statistics service_games_won Integer Match Timeline

Service Points Won Match Summary statistics service_points_won Integer Match Timeline

Surface Type Doubles Team Profile surface type String Player Profile

Tiebreaks Won Match Summary statistics tiebreaks_won Integer Match Timeline

Tournaments Played Doubles Team Profile statistics played Integer Player Profile

Tournaments Won Doubles Team Profile statistics won Integer Player Profile

Updated 08.28.17


Timeline Information


Event Away Score Match Timeline event away_score Integer Event First Serve Fault Match Timeline event first_serve_fault Boolean Event Home Score Match Timeline event home_score Integer Event Id Match Timeline event id Id Event Period Match Timeline event period Integer Event Period Name Match Timeline event period_name String Event Reason Match Timeline event reason String Event Result Match Timeline event result String Event Server Match Timeline event server String Event Team Match Timeline event team String Event Time Match Timeline event time Date/Time Event Type Match Timeline event type String

Updated 08.28.17


Standings Information


Doubles Team Ranking – Rank Doubles Team Race Rankings doubles_team rank Integer Doubles Team Ranking – Points Doubles Team Race Rankings doubles_team points Integer

Player Ranking – Rank Doubles Team Race Rankings

player rank Integer Player Race Rankings Player Rankings

Player Ranking – Points Doubles Team Race Rankings

player points Integer Player Race Rankings Player Rankings

Ranking Category Id

Doubles Team Race Rankings

ranking category_id Id Doubles Team Rankings Player Race Rankings Player Rankings

Ranking Name

Doubles Team Profile

ranking name String

Doubles Team Race Rankings Doubles Team Rankings Player Profile Player Race Rankings Player Rankings

Ranking Player Id Doubles Team Profile ranking player_id Id Player Profile

Ranking Points Doubles Team Profile ranking points Integer Player Profile

Ranking Race Ranking Doubles Team Profile ranking race_ranking Boolean Player Profile

Ranking Rank Doubles Team Profile ranking rank Integer Player Profile

Ranking Type

Doubles Team Profile

ranking type String

Doubles Team Race Rankings Doubles Team Rankings Player Profile Player Race Rankings Player Rankings

Ranking Week


ranking week Integer Doubles Team Rankings Player Race Rankings Player Rankings

Ranking Year


ranking year Integer Doubles Team Rankings Player Race Rankings Player Rankings

Updated 08.28.17


Frequently Asked Questions

Q: What leagues or tournaments do you cover for Tennis?

A: We cover the following tours:

ATP Singles ATP Doubles Olympic Tournament Challenger Tournaments Singles Challenger Tournaments Doubles Davis Cup Exhibition Match for Africa Fed Cup Hopman Cup IPTL ITF Singles ITF Doubles ITF Women Singles ITF Women Doubles WTA Singles WTA Doubles Olympic Tournament, Women WTA 125K Singles WTA 125K Doubles

Q: What is the Date format? A: When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03 We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601

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: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601

Updated 08.28.17


Q: What are the valid match status values?

A: Here are the valid match status values and their definitions:

not_started – The match is scheduled to be played delayed – The match has been temporarily delayed and will be continued live – The match is currently in progress 1st_set – First set 2nd_set – Second set 3rd_set – Third set 4th_set – Fourth set 5th_set – Fifth set ended – The match is over interrupted – The match began, but is stopped for a short time suspended – The match began, but has been suspended to a later time canceled – The match has been canceled and will not be played closed – The match results have been confirmed. postponed – The match has been postponed to a future date delayed – The match has been temporarily delayed and will be continued

abandoned – The match began, but was then canceled closed – The match results have been confirmed.

Q: What are the valid match modes? A: bo5 (best of 5 sets), bo3 (Best of 3 sets) Q: What are the valid outcomes for probabilities? A: Here are the valid outcome probabilities:

home_team_winner away_team_winner

Q: How do I find out the coverage for a particular match? A: Find the node called: coverage_info. The attribute live_coverage reports whether Sportradar has live coverage of

the match or not. The level can be gold, silver or bronze. Bronze includes basic_score. Silver includes basic_score and key_events. Gold includes everything in silver and detailed events and lineups.

Q: What are the possible surface values? A: Here are the possible surface values: red_clay hardcourt_indoor hardcourt_outdoor grass

Updated 08.28.17


Q: What are the possible weather conditions? A: Here are the possible weather conditions: indoor good medium bad extreme

Q: What are the possible event types logged?

A: Here are all of the possible event types we log: coin_toss_win deciding_team match_started match_called period_start point period_score match_suspended match_resumed match_ended

Q: What are the point event possible values?

A: Here are the possible values for a point event: ace receiver_won server_won double_fault

Q: What are the valid tournament types?

A: Here are the valid tournament types:

group playoff qualifier variable

Q: What are markets and what are the different markets? A: Markets is something you can bet on that we provide probabilities for. Over time we intend to provide more and

more markets in the API. Currently the only market we provide is 3-way (will the home team win? Or the away team? Or will it be a draw?)

Updated 08.28.17


Q: What are the possible outcomes? A: Different markets have different outcomes. The available markets are currently:

home_team_winner

away_team_winner draw Q: Is the statistical data provided in the Tennis API official data? A: Sportradar collects sports data independently. For some sports Sportradar is the official data provider. In the

case of Tennis, we provide official data for ITF tournaments only.

Updated 08.28.17


Document Change History

Date Section Change

08/28/2017 Sport Event Information Added new endpoint: Deleted Matches FAQ Added new event types: match_called, coin_toss_win, and deciding_team.

08/02/2017 FAQ Updated the list of match statuses in the FAQ. 05/15/2017 Competitor Information Added bracket_number to additional feeds. 04/11/2017 Sport Event Information Added data point for Start Time to be Determined. 03/13/2017 FAQ Added valid match status: interrupted. 02/28/2017 All Major overhaul to all feeds. Documentation has been fully redrafted.

10/24/2016 FAQ Added additional game statuses to the FAQ Match Info Documented the sport_event_status – game_state data points

10/22/2016 All Initial release

Tennis Statistics Feeds - Sportradar US · kaz Kazakh sqi Albanian br Brazilian Portuguese srl...

Documents

Transcript of Tennis Statistics Feeds - Sportradar US · kaz Kazakh sqi Albanian br Brazilian Portuguese srl...