Snooker v1

Frequently Asked Questions
API API Version XSD Schema
Snooker v1 Download
Note: Authentication is required for all API calls.
## Snooker v1 API Map To best utilize the Snooker API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need. >

Example:

>To find the probability of a home team win for a given game: >
  1. Call the Daily Schedule for the day the sport event takes place and find the Sport Event Id for the chosen sport event
  2. Call the Sport Event Probabilities using the Sport Event Id
>The probability of a home team win is displayed. The primary feeds require only a date or human-readable parameters to call the endpoints. Those feeds provide Sport Event Ids, Competitor Ids, or Tournament Ids which can be used to generate the match, team, and tournament feeds. ## Competitor Profile ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/competitors/sr:competitor:169240/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", "/snooker-t1/en/competitors/sr:competitor:169240/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.com/snooker-t1/en/competitors/sr:competitor:169240/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor Profile. https://api.sportradar.com/snooker-`{access_level}{version}`/`{language_code}`/competitors/`{competitor_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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `competitor_id` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Competitor Profile use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/competitor_profile.xsd Return to API map ## Competitor Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/competitors/sr:competitor:169240/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", "/snooker-t1/en/competitors/sr:competitor:169240/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.com/snooker-t1/en/competitors/sr:competitor:169240/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor Results. https://api.sportradar.com/snooker-`{access_level}{version}`/`{language_code}`/competitors/`{competitor_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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `competitor_id` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Competitor Results use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/competitor_results.xsd Return to API map ## Competitor Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/competitors/sr:competitor:169240/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", "/snooker-t1/en/competitors/sr:competitor:169240/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.com/snooker-t1/en/competitors/sr:competitor:169240/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Competitor Schedule. https://api.sportradar.com/snooker-`{access_level}{version}`/`{language_code}`/competitors/`{competitor_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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `competitor_id` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Competitor Schedule use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/competitor_schedule.xsd Return to API map ## Daily Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/schedules/2016-08-24/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", "/snooker-t1/en/schedules/2016-08-24/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.com/snooker-t1/en/schedules/2016-08-24/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Results. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day 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 use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/results.xsd Return to API map ## Daily Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/schedules/2016-08-24/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", "/snooker-t1/en/schedules/2016-08-24/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.com/snooker-t1/en/schedules/2016-08-24/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Schedule. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day 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 Schedule use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/schedule.xsd Return to API map ## Head To Head ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/competitors/sr:competitor:169240/versus/sr:competitor:130320/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", "/snooker-t1/en/competitors/sr:competitor:169240/versus/sr:competitor:130320/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.com/snooker-t1/en/competitors/sr:competitor:169240/versus/sr:competitor:130320/matches.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Head To Head. https://api.sportradar.com/snooker-`{access_level}{version}`/`{language_code}`/competitors/`{competitor_id}`/versus/`{competitor_id2}`/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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `competitor_id` | Id of a given competitor. | | `competitor_id2` | Id of a given competitor. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Head To Head use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/competitor_versus_matches.xsd Return to API map ## Seasons ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/tournaments/sr:tournament:14137/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", "/snooker-t1/en/tournaments/sr:tournament:14137/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.com/snooker-t1/en/tournaments/sr:tournament:14137/seasons.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Seasons. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 Seasons use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/tournament_seasons.xsd Return to API map ## Sport Event Probabilities ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/matches/sr:match:9815695/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", "/snooker-t1/en/matches/sr:match:9815695/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.com/snooker-t1/en/matches/sr:match:9815695/probabilities.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Sport Event Probabilities. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 Sport Event Probabilities use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/match_probabilities.xsd Return to API map ## Sport Event Timeline ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/sport_events/sr:match:9815695/timeline.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", "/snooker-t1/en/sport_events/sr:match:9815695/timeline.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.com/snooker-t1/en/sport_events/sr:match:9815695/timeline.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Sport Event Timeline. https://api.sportradar.com/snooker-`{access_level}{version}`/`{language_code}`/sport_events/`{match_id}`/timeline.`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 Sport Event Timeline use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/sport_event_timeline.xsd Return to API map ## Tournament Info ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/tournaments/sr:tournament:14137/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", "/snooker-t1/en/tournaments/sr:tournament:14137/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.com/snooker-t1/en/tournaments/sr:tournament:14137/info.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Info. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/tournament_info.xsd Return to API map ## Tournament List ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/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", "/snooker-t1/en/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.com/snooker-t1/en/tournaments.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament List. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Tournament List use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/tournaments.xsd Return to API map ## Tournament Live Standings ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/tournaments/sr:tournament:14137/live_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", "/snooker-t1/en/tournaments/sr:tournament:14137/live_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.com/snooker-t1/en/tournaments/sr:tournament:14137/live_standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Live Standings. https://api.sportradar.com/snooker-`{access_level}{version}`/`{language_code}`/tournaments/`{tournament_id or season_id}`/live_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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 Live Standings use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/tournament_live_standings.xsd Return to API map ## Tournament Results ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/tournaments/sr:tournament:14137/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", "/snooker-t1/en/tournaments/sr:tournament:14137/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.com/snooker-t1/en/tournaments/sr:tournament:14137/results.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Results. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/tournament_results.xsd Return to API map ## Tournament Schedule ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/tournaments/sr:tournament:14137/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", "/snooker-t1/en/tournaments/sr:tournament:14137/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.com/snooker-t1/en/tournaments/sr:tournament:14137/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Schedule. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/tournament_schedule.xsd Return to API map ## Tournament Standings ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/snooker-t1/en/tournaments/sr:tournament:14137/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", "/snooker-t1/en/tournaments/sr:tournament:14137/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.com/snooker-t1/en/tournaments/sr:tournament:14137/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Tournament Standings. https://api.sportradar.com/snooker-`{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` | 2 letter code for supported languages

English (en) is the only fully supported language for this API. | | `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 use the following URL. https://schemas.sportradar.com/bsa/v1/endpoints/standard/tournament_standings.xsd Return to API map ## Frequently Asked Questions

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

A: We cover the following tournaments.

Area Tournament
International World Championship
Australian Open
World Cup
Wuxi Classic
Welsh Open
China Open
The Masters
German Masters
UK Championship
Shanghai Masters
World Open
Players Tour Championship
International Championship
Indian Open
Champion Of Champions
Shoot-Out
European Tour
Asian Tour
World Seniors Championship
Championship League
World Grand Prix
Riga Masters
Paul Hunter Classic
European Masters
China Championship
Home Nations Series
England Premier League

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 are the valid “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
  • delayed – The match has been temporarily delayed and will be continued
  • start_delayed - The match start has been temporarily delayed and will be continued
  • interrupted - The match began, but coverage has stopped for a short time. Note that match scores may not be updated during this period, the last recorded match score will be displayed instead
  • cancelled – The match has been cancelled and will not be played
  • ended – The match is over
  • closed – The match results have been confirmed
  • abandoned – The match has been abandoned

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.

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

Q: How will a sport event behave when it is not covered with live scores?

A: When a sport_event is not covered live, the status and match_status will remain as not_started until results are entered post-match.

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

A: Here are the valid match_status values:

  • not_started
  • started
  • cancelled
  • walkover
  • retired
  • ended
Return to top

Docs Navigation