Updated 08.17.18
Handball Statistics Feeds
2016
1 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Table of Contents Handball Statistics Feeds ...... 3 Coverage Levels ...... 4 Language Support ...... 5 Category & Sport Information ...... 6 Tournament Information ...... 8 Competitor Information ...... 11 Player Information ...... 13 Venue Information ...... 14 Probability Information ...... 16 Sport Event Information ...... 17 Timeline Information ...... 19 Standings Information ...... 20 Frequently Asked Questions ...... 21 Document Change History ...... 25
2 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Handball Statistics Feeds
We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs: Competitor Profile - Returns information for a competitor/team. Competitor Results - Returns a list of results for a given competitor/team. Competitor Schedule - Returns a list of scheduled matches for a given competitor/team. Daily Results - Returns a list of match results for a given date: yyyy-mm-dd Daily Schedule - Returns a list of scheduled matches for a given date: yyyy-mm-dd Head to Head - Compares past results and schedules upcoming matches given two team IDs. Player Profile - Returns information for a player. Seasons - Displays a listing of seasons with respective IDs. Season IDs can be interchanged with tournament IDs to retrieve historical data. Sport Event Probabilities - Returns the pre-match 3-way probabilities of winning for both teams. Expires once the match is live. Sport Event Timeline - Displays information for a specific match including a timeline of events, live (assuming coverage levels dictate that it is live) as well as match and player statistics. Tournament Info - Provides information pertaining to a given tournament or season. Tournament List - Lists all tournaments in the package. Tournament Live Standings - Returns the live standings for a given tournament or season. This data changes in relation to events occurring in currently live matches. Tournament Results - Returns a list of results for a given tournament or season. Tournament Schedule - Returns a list of scheduled matches for a given tournament or season. Tournament Standings - Returns the current standings for a given tournament or season. Venues – Returns information for a given venue.
3 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Coverage Levels
Coverage level information for a particular tournament can be found in the Tournament Info endpoint. Match level coverage information is found in the Sport Event Timeline endpoint. From time to time, coverage is updated. In order keep up to date with the latest coverage levels please check the change log: http://developer.sportradar.us/change_log and also refer to the Sportradar coverage document published here: https://www.sportradar.com/wp-content/uploads/sites/5/2014/12/Sportradar_Coverage.pdf
4 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
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
5 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Category & Sport Information
Stat Feeds Element Attribute Format
Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Seasons Sport Event Probabilities Category Country Code category country_code String Sport Event Timeline Tournament Info Tournament List Tournament Live Standings Tournament Results Tournament Schedule Tournament Standings Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Seasons Sport Event Probabilities Category Id category id Id Sport Event Timeline Tournament Info Tournament List Tournament Live Standings Tournament Results Tournament Schedule Tournament Standings Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Seasons Sport Event Probabilities Category Name category name String Sport Event Timeline Tournament Info Tournament List Tournament Live Standings Tournament Results Tournament Schedule Tournament Standings Venues Competitor Profile Competitor Results Sport Id sport id Id Competitor Schedule Daily Results
6 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Daily Schedule Head to Head Seasons Sport Event Probabilities Sport Event Timeline Tournament Info Tournament List Tournament Live Standings Tournament Results Tournament Schedule Tournament Standings Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Seasons Sport Event Probabilities Sport Name sport name String Sport Event Timeline Tournament Info Tournament List Tournament Live Standings Tournament Results Tournament Schedule Tournament Standings Venues
7 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Tournament Information
Stat Feeds Element Attribute Format Tournament Info Tournament List Current Season End Date current_season end_date Time/Date Tournament Live Standings Tournament Standings Tournament Info Tournament List Current Season Id current_season id Id Tournament Live Standings Tournament Standings Tournament Info Tournament List Current Season Name current_season name String Tournament Live Standings Tournament Standings Tournament Info Tournament List Current Season Start Date current_season start_date Time/Date Tournament Live Standings Tournament Standings Tournament Info Tournament List Current Season Year current_season year String Tournament Live Standings Tournament Standings Tournament Live Standings Group Group Name group group_name String Tournament Standings Tournament Live Standings Group Id group id Id Tournament Standings Tournament Live Standings Group Name group name String Tournament Standings Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Season End Date Seasons season end_date Date/Time Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Season Id Seasons season id Id Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Competitor Results Competitor Schedule Season Name season name String Daily Results Daily Schedule
8 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Head to Head Seasons Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Season Start Date Seasons season start_date Date/Time Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head tournament / id / Season Tournament Id Seasons Id season tournament_id Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Season Year Seasons season year String Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Seasons Sport Event Probabilities Tournament Id tournament id Id Sport Event Timeline Tournament Info Tournament List Tournament Live Standings Tournament Results Tournament Schedule Tournament Standings Competitor Results Tournament Name Competitor Schedule tournament name String Daily Results
9 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Daily Schedule Head to Head Seasons Sport Event Probabilities Sport Event Timeline Tournament Info Tournament List Tournament Live Standings Tournament Results Tournament Schedule Tournament Standings Competitor Results Daily Results Daily Schedule Head to Head Tournament Round Group tournament_round group String Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Tournament Round Match Head to Head round / cup_round_match_number Integer Number Sport Event Timeline tournament_round Head to Head round / Tournament Round Matches cup_round_matches Integer Sport Event Timeline tournament_round Head to Head round / Tournament Round Name name String Sport Event Timeline tournament_round Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Tournament Round Number tournament_round number Integer Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Tournament Round Other Match Head to Head tournament_round other_match_id Id Sport Event Timeline Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head round / Tournament Round Type type String Sport Event Probabilities tournament_round Sport Event Timeline Tournament Info Tournament Results Tournament Schedule
10 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Competitor Information
Stat Feeds Element Attribute Format
Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Competitor Abbreviation team abbreviation String Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Competitor Country team country String Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Competitor Country Code team country_code String Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Head to Head Competitor Id team id Id Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Name team name String Competitor Schedule Daily Results
11 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Daily Schedule Head to Head Sport Event Probabilities Sport Event Timeline Tournament Info Tournament Results Tournament Schedule Venues Competitor Results Competitor Schedule Daily Results Daily Schedule Competitor Qualifier Head to Head team qualifier String Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Jersey Base Color Competitor Profile jersey base String Jersey Number Competitor Profile jersey number Integer Jersey Sleeve Color Competitor Profile jersey sleeve String Jersey Type Competitor Profile jersey type String
12 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Player Information
Stat Feeds Element Attribute Format
Competitor Profile Country Code player country_code String Player Profile Competitor Profile Date Of Birth player date_of_birth Date Player Profile Competitor Profile Id player id Id Player Profile Jersey Number Competitor Profile player jersey_number Integer Competitor Profile Name player name String Player Profile Competitor Profile Nationality player nationality String Player Profile Type Player Profile player type String Weight Player Profile player weight String
13 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Venue Information
Stat Feeds Element Attribute Format
Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Capacity Head to Head venue capacity Integer Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule City Head to Head venue city_name String Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Country Code Head to Head venue country_code String Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Country Name Head to Head venue country_name String Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Id venue id Id Daily Schedule Head to Head Sport Event Probabilities Sport Event Timeline
14 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Map Coordinates Head to Head venue map_coordinates String Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Venues Competitor Profile Competitor Results Competitor Schedule Daily Results Daily Schedule Name Head to Head venue name String Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Venues
15 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Probability Information
Stat Feeds Element Attribute Format
Away Team Win Probability Sport Event Probability outcome probabilitiy String Home Team Win Probability Sport Event Probability outcome probabilitiy String Market Name Sport Event Probability market name String Outcome Name Sport Event Probability outcome name String
16 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Sport Event Information
Stat Feeds Element Attribute Format
Coverage Info Sport Event Timeline coverage_info live_coverage String Competitor Results Daily Results Period Away Score Head to Head period_score away_score Integer Sport Event Timeline Tournament Results Competitor Results Daily Results Period Home Score Head to Head period_score home_score Integer Sport Event Timeline Tournament Results Competitor Results Daily Results Period Number Head to Head period_score number Integer Sport Event Timeline Tournament Results Competitor Results Daily Results Period Type Head to Head period_score type String Sport Event Timeline Tournament Results Competitor Results Competitor Schedule Daily Results Daily Schedule Sport Event Id Head to Head sport_event id Id Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Competitor Results Competitor Schedule Daily Results Daily Schedule Sport Event Scheduled Head to Head sport_event scheduled Date/Time Date/Time Sport Event Probabilities Sport Event Timeline Tournament Results Tournament Schedule Competitor Schedule Daily Schedule sport_event status String Tournament Schedule Competitor Results Sport Event Status Daily Results Head to Head sport_event_status status String Sport Event Timeline Tournament Results Competitor Results Daily Results Sport Event Status Away Score Head to Head sport_event_status away_score Integer Sport Event Timeline Tournament Results
17 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Competitor Results Daily Results Sport Event Status Home Score Head to Head sport_event_status home_score Integer Sport Event Timeline Tournament Results Competitor Results Daily Results Sport Event Status Winner Id Head to Head sport_event_status winner_id Id Sport Event Timeline Tournament Results
18 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Timeline Information
Stat Feeds Element Attribute Format
Event Away Score Sport Event Timeline event away_score Integer Event Home Score Sport Event Timeline event home_score Integer Event Id Sport Event Timeline event id Id Event Match Clock Sport Event Timeline event match_clock String Event Match Time Sport Event Timeline event match_time Integer Event Period Sport Event Timeline event period Integer Event Period Name Sport Event Timeline event period_name String Event Team Sport Event Timeline event team String Event Time Sport Event Timeline event time Time Event Type Sport Event Timeline event type String
19 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Standings Information
Stat Feeds Element Attribute Format
Tournament Live Standings Change team_standing change Integer Tournament Standings Tournament Live Standings Current Outcome team_standing current_outcome String Tournament Standings Tournament Live Standings Draw team_standing draw Integer Tournament Standings Tournament Live Standings Loss team_standing loss Integer Tournament Standings Tournament Live Standings Played team_standing played Integer Tournament Standings Tournament Live Standings Points team_standing points Integer Tournament Standings Tournament Live Standings Rank team_standing rank Integer Tournament Standings Tournament Live Standings Score Against team_standing score_against Integer Tournament Standings Tournament Live Standings Score Difference team_standing score_diff Integer Tournament Standings Tournament Live Standings Score For team_standing score_for Integer Tournament Standings Tournament Live Standings Team Id team id Id Tournament Standings Tournament Live Standings Team Name team name String Tournament Standings Tournament Live Standings Tie Break Rule standings tie_break_rule String Tournament Standings Tournament Live Standings Type standings type Integer Tournament Standings Tournament Live Standings Win team_standing win Integer Tournament Standings
20 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Frequently Asked Questions
Q: What leagues or tournaments do you cover for Handball?
A: We cover the following tournaments. Area Tournament Champions League Champions League, Women EHF Cup EHF Cup, Women EHF Cup Winners EHF Cup Winners, Women European Championship European Championship Quarterfinals European Championship, Women European Championship, Women Quarterfinals World Championship World Championship Qualifiers World Championship, Women World Championship, Women Qualifiers Super Cup International Super Globe Club Friendly Games International Friendly Games International Friendly Games, Women Olympic Games Olympic Games Quarterfinals Olympic Games, Women Olympic Games, Women Quarterfinals Bring Cup Tournament Of Champions SEHA League Mobelringen Cup Baltic Handball League U19 World Championship U20 World Championship, Women U21 World Championship WHIL, Women DHB Pokal DHB Pokal, Women Bundesliga Bundesliga, Women Germany Super Cup Super Cup, Women 2nd Bundesliga All Star Game HLA Super Cup Austria OHB-Cup WHA GD, Women Denmark Handboldligaen
21 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Damehandboldligaen Cup Cup, Women 1. Division 1. Division, Women LNH Division 1 Coupe de France France Coupe de la Ligue Trophee des Champions Elitserien Sweden Elitserien Women Allsvenskan Switzerland MNLA Eliteserien Eliteserien Women Norway 1. Division 1. Division, Women Liga Asobal Super Cup Spain Copa del Rey Copa Asobal Division De Honor Female Finland SM Liiga Premijer Liga Croatia 1. HRL Women Czech Republic Extraliga Greese A1 NB I Hungary Super Cup Slovenia 1.liga Superliga Poland Superliga, Women Super League Russia Super League, Women Extraliga Slovakia Cup, Women Cup Israel Division 1 Superliga Serbia Super Cup Liga Nationala Liga Nationala, Women Romania Super Cupa Super Cupa, Women 1a Divisao Portugal Supertaca Urvalsdeild Iceland Urvalsdeild, Women
22 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
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
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 live – 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 ended – The match is over closed – The match results have been confirmed.
Q: How do I access past seasons’ result and stats?
A: TournamentID and SeasonID are interchangeable. To access a previous season, first interrogate the tournaments/[tournamentID]/seasons endpoint to ascertain the required seasonID, then use that seasonID in place of the tournamentID for any of the following endpoints: - Tournaments/seasonID/results - Tournaments/seasonID/schedule - Tournaments/seasonID/teams/teamID/statistics - Tournaments/seasonID/standings
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” in the Sport Event Timeline endpoint. The attribute live_coverage reports whether Sportradar has live coverage of the match or not.
23 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Q: Why do different groups have coverage information for a tournament?
A: The notion of “groups” is versatile and is used to distinguish between playoffs, and our tournaments structures and is therefore necessary to describe coverage at a group level for consistency.
Q: What are the possible event types logged?
A: Here are all of the possible event types we log:
Match started Score change Match ended
Q: What are the valid tournament types?
A: Here are the valid tournament types:
group playoff
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?)
Q: What are the possible outcomes?
A: Different markets have different outcomes. The available markets are currently:
home_team_winner away_team_winner
24 SPORTRADAR HANDBALL STATISTICS FEEDS
Updated 08.17.18
Document Change History
Date Section Change
Added team_standing – change, team_standing – current_outcome, and 08/17/2018 Standings Information standings – tie_break_rule to the standings feeds. 05/10/2018 Timeline Information Added match_clock to the Sport Event Timeline feed. Added venue data points to the following feeds: Competitor Results, Competitor 04/26/2018 Venue Information Schedule, Daily Results, Daily Schedule, Head to Head, Sport Event Probabilities, Tournament Results, and Tournament Schedule. 01/19/2017 All Document creation
25 SPORTRADAR HANDBALL STATISTICS FEEDS