League of Legends v1

Frequently Asked Questions
API API Version
LoL v1
Note: Authentication is required for all API calls.
## Daily Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/schedules/2016-06-05/results.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/schedules/2016-06-05/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/schedules/2016-06-05/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Daily Results. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/schedules/`{year}`-`{month}`-`{day}`/results.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Results, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/results.xsd?api_key=`{your_api_key}` ## Daily Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/schedules/2016-06-05/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/schedules/2016-06-05/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/schedules/2016-06-05/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Schedule. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/schedules/`{year}`-`{month}`-`{day}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Results, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/common/schedule.xsd?api_key=`{your_api_key}` ## Deleted Matches ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/schedules/deleted_matches.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/schedules/deleted_matches.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/schedules/deleted_matches.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Daily Results. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/schedules/deleted_matches.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Head-2-Head ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/teams/sr:competitor:248707/versus/sr:competitor:240566/matches.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/teams/sr:competitor:248707/versus/sr:competitor:240566/matches.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/teams/sr:competitor:248707/versus/sr:competitor:240566/matches.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Head-2-Head Statistics. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/teams/`{team_id}`/versus/`{team_id}`/matches.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `team_id` | ID of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Head-2-Head, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/team_versus_matches.xsd?api_key=`{your_api_key}` ## Match Lineups ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/matches/sr:match:11563689/lineups.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/matches/sr:match:11563689/lineups.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/matches/sr:match:11563689/lineups.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Lineups. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/matches/`{match_id}`/lineups.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `match_id` | ID of a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Lineups, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/lineups.xsd?api_key=`{your_api_key}` ## Match Probabilities ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/matches/sr:match:11563689/probabilities.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/matches/sr:match:11563689/probabilities.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/matches/sr:match:11563689/probabilities.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Probabilities. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/matches/`{match_id}`/probabilities.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `match_id` | ID of a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. |
Note: The match_id used must be pre-match for the odds to display.
To retrieve the XML Schema Definition (.XSD) for the Match Probabilities, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/match_probabilities.xsd?api_key=`{your_api_key}` ## Match Summary ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/matches/sr:match:11563689/summary.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/matches/sr:match:11563689/summary.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/matches/sr:match:11563689/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Summary. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/matches/`{match_id}`/summary.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `match_id` | ID of a given match. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Summary, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/match_summary.xsd?api_key=`{your_api_key}` ## Player Profile ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/players/sr:player:948928/profile.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/players/sr:player:948928/profile.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/players/sr:player:948928/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Player Profile. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/player/`{player_id}`/profile.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `player_id` | ID of a given player. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Player Profile, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/player_profile.xsd?api_key=`{your_api_key}` ## Team Profile ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/teams/sr:competitor:240566/profile.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/teams/sr:competitor:240566/profile.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/teams/sr:competitor:240566/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Team Profile. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `team_id` | ID of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Profile, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/team_profile.xsd?api_key=`{your_api_key}` ## Team Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/teams/sr:competitor:240566/results.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/teams/sr:competitor:240566/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/teams/sr:competitor:240566/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Team Results. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/teams/`{team_id}`/results.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `team_id` | ID of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Results, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/team_results.xsd?api_key=`{your_api_key}` ## Team Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/teams/sr:competitor:240566/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/teams/sr:competitor:240566/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/teams/sr:competitor:240566/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Team Schedule. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/teams/`{team_id}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `team_id` | ID of a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Schedule, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/team_schedule.xsd?api_key=`{your_api_key}` ## Tournament Info ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/info.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/tournaments/sr:tournament:2549/info.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/info.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Tournament Info. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/info.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `tournament_id or season_id` | ID of a given tournament or season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Info, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/tournament_info.xsd?api_key=`{your_api_key}` ## Tournament Live Summary ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/schedules/live/summaries.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/schedules/live/summaries.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/schedules/live/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Tournament Live Summary. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/schedules/live/summaries.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Info, use the following URL. http://schemas.sportradar.com/bsa/csgo/v1/xml/endpoints/csgo/summaries.xsd ## Tournament Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/results.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/tournaments/sr:tournament:2549/results.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Tournament Results. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/results.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `tournament_id or season_id` | ID of a given tournament or season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Results, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/tournament_results.xsd?api_key=`{your_api_key}` ## Tournament Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/tournaments/sr:tournament:2549/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Tournament Schedule. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `tournament_id or season_id` | ID of a given tournament or season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Schedule, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/tournament_schedule.xsd?api_key=`{your_api_key}` ## Tournament Seasons ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/seasons.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/tournaments/sr:tournament:2549/seasons.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/seasons.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Tournament Seasons. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/seasons.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `tournament_id or season_id` | ID of a given tournament or season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Seasons, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/tournament_seasons.xsd?api_key=`{your_api_key}` ## Tournament Standings ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/standings.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/tournaments/sr:tournament:2549/standings.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/tournaments/sr:tournament:2549/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Tournament Standings. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/standings.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `tournament_id or season_id` | ID of a given tournament or season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Standings, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/lol/tournament_standings.xsd?api_key=`{your_api_key}` ## Tournament Summary ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/schedules/sr:tournament:2549/summaries.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/schedules/sr:tournament:2549/summaries.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/schedules/sr:tournament:2549/summaries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Tournament Summary. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/summaries.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `tournament_id or season_id` | ID of a given tournament or season. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament Summary, use the following URL. http://schemas.sportradar.com/bsa/csgo/v1/xml/endpoints/csgo/summaries.xsd ## Tournaments ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/lol-t1/us/tournaments.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/lol-t1/us/tournaments.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/lol-t1/us/tournaments.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Tournaments. https://api.sportradar.us/lol-`{access_level}{version}`/`{language_code}`/tournaments.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `language_code` | Optional 2 letter code for supported languages. See the list of Supported Locales | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournaments, replace the parameters in the following URL. https://api.sportradar.us/lol-`{access_level}{version}`/schema/common/tournaments.xsd?api_key=`{your_api_key}` ## Frequently Asked Questions

Q: What format are date fields presented in?

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 format are the date/time fields presented in?

A: All of our Date/Time 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 leagues or tournaments do you cover for League Of Legends?

A: We cover all tournaments & leagues run by ESL Gaming. An accurate up to date list of tournaments can be obtained from the API tournaments endpoint at any given time.

Q: How are coverage levels defined for League Of Legends?

A: Coverage for League of Legends is either Gold or Bronze. These coverage levels are defined as follows:

  • Gold: The match is covered live and will contain basic scores and game statistics.
  • Bronze: The match is covered post-game only, and will contain only basic scores.

Q: What leagues or tournaments do you cover live for League Of Legends?

A: We only provide live coverage for LoL World Championship, LCS EU, and LCS NA.

Q: What is the format of the Ids in your feeds?

A: In the API we try to consistently use an URN-scheme for identifying different entities with id. Our standard URN-scheme is usually on this format “<origin>:<type>:<id>”. This string is a guaranteed unique id across our APIs. It is best to treat the Id as a string that uniquely identifies the entity and not try to break apart the different pieces.

Q: What are the valid “sport_event – status” and “sport_event_status – status” values?

A: Here are the valid 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
  • suspended – The match has been suspended.
  • delayed – The match has been temporarily delayed and will be continued.
  • cancelled – The match has been canceled and will not be played.
  • abandoned – The match began, but was abandoned.
  • interrupted – The match has been interrupted.
  • ended – The match is over.
  • closed – The match is over and the results have been confirmed.

Q: What are the valid “sport_event_status – match_status” values?

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

  • not_started
  • first_map
  • first_pause
  • second_map
  • second_pause
  • third_map
  • third_pause
  • fourth_map
  • fourth_pause
  • fifth_map
  • ended
  • walkover1
  • walkover2
  • retired1
  • retired2
  • delayed
  • interrupted
  • abandoned

Q: What are the valid tournament types?

A: Here are the valid tournament types:

  • group
  • playoff
  • qualifier

Q: What are the valid player roles?

A: Here are the valid player roles:

  • 1 = Top
  • 2 = Jungle
  • 3 = AD Carry
  • 4 = Mid
  • 5 = Support
  • unknown

Q: Why is Kill/Death/Assist data not available for a given player?

A: Kill/Death/Assist data can only be generated when the player has had at least 1 death. If players death stat is 0, the KDA is said to be “Perfect” and is not displayed.

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 outcomes are currently:

  • home_team_winner
  • away_team_winner
  • draw

Q: What are the possible values for phase in the tournament_round attribute?

A: Here are the valid phases:

  • regular_season
  • playoffs
  • relegation
  • promotion

Q: What are the possible values for match_mode in the sport_event_conditions attribute?

A: Note that match mode is shared across all 3 eSports we offer, so an individual sport may not utilize all of the values below. Here is a list of the statuses for match_mode:

  • BO1 – Best of one
  • BO2 – Best of two
  • BO3 – Best of three
  • BO4 – Best of four
  • BO5 – Best of five

Q: What are the possible values for hero?

A: There are currently 142 available heroes. Here are all of the valid hero names:

Aatrox Hecarim MonkeyKing Syndra
Ahri Heimerdinger Mordekaiser TahmKench
Akali Illaoi Morgana Taliyah
Alistar Irelia Nami Talon
Amumu Ivern Nasus Taric
Anivia Janna Nautilus Teemo
Annie JarvanIV Nidalee Thresh
Ashe Jax Nocturne Tristana
AurelionSol Jayce Nunu Trundle
Azir Jhin Olaf Tryndamere
Bard Jinx Orianna TwistedFate
Blitzcrank Kai'Sa Ornn Twitch
Brand Kalista Pantheon Udyr
Braum Karma Poppy Urgot
Caitlyn Karthus Pyke Varus
Camille Kassadin Quinn Vayne
Cassiopeia Katarina Rakan Veigar
Chogath Kayle Rammus Velkoz
Corki Kayn RekSai Vi
Darius Kennen Renekton Viktor
Diana Khazix Rengar Vladimir
Draven Kindred Riven Volibear
DrMundo Kled Rumble Warwick
Ekko KogMaw Ryze Xayah
Elise Leblanc Sejuani Xerath
Evelynn LeeSin Shaco XinZhao
Ezreal Leona Shen Wukong
FiddleSticks Lissandra Shyvana Yasuo
Fiora Lucian Singed Yorick
Fizz Lulu Sion Zac
Galio Lux Sivir Zed
Gangplank Malphite Skarner Ziggs
Garen Malzahar Sona Zilean
Gnar Maokai Soraka Zoe
Gragas MasterYi Swain Zyra
Graves MissFortune
Return to top