Soccer v2

Frequently Asked Questions
API API Version
Soccer v2
Note: Each league group requires a separate API key and authentication is required for all API calls.
## Soccer v2 API Map To best utilize the Soccer v2 API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need. >

Examples:

>To find the draw flag for a given match: >
  1. Call the schedule, daily schedule, or boxscore and find the Match Id for the chosen game
  2. Call the Match Summary using the Match Id
  3. Locate the fact - draw
>The draw flag for the match is displayed. >
    >To find a players number of matches played for the season: >
    1. Call the player rankings and find the desired Player Id
    2. Call the Player Profile using the Player Id
    3. Locate the statistic - matches played
    >The players number of matches played is displayed. Primary feeds only require dates or human-readable parameters, while other feeds require a global unique identifier (GUID) to identify the match, team, or player that the feed will discribe. The primary feeds provide GUIDs for matches, players, and teams. ## Daily Boxscore
    Update Frequency: As Necessary
    Content Type: XML
    Boxscore Data Points: Away Team 1st Half Score
    Away Team 2nd Half Score
    Away Team Overtime Score
    Away Team Penalty Score (Post Period)
    Away Team Penalty Score
    Away Team Score
    Away Team Total Score
    Away Team Winner Flag
    Half Number
    Home Team 1st Half Score
    Home Team 2nd Half Score
    Home Team Overtime Score
    Home Team Penalty Score (Post Period)
    Home Team Penalty Score
    Home Team Score
    Home Team Total Score
    Home Team Winner Flag
    Category Info Data Points: Country
    Country Code
    Id Name
    Match Info Data Points: Away Team Alias
    Away Team Country
    Away Team Country Code
    Away Team Formation
    Away Team Id
    Away Team Name
    Away Team Type
    Coverage Corner Facts Flag
    Coverage Deep Facts Flag
    Coverage Extended Facts Flag
    Coverage Lineups Flag
    Coverage Statistics Flag
    Coverage Tactical Lineups Flag
    Game Clock
    Home Team Alias
    Home Team Country
    Home Team Country Code
    Home Team Formation
    Home Team Id
    Home Team Name
    Home Team Type
    Id
    Period
    Schedule Date/Time
    Scratched Flag
    Season Id
    Status
    Team Match Statistics Data Points: Attacks
    Corner Kicks
    Dangerous Attacks
    Fouls
    Free Kicks
    Goal Attempts
    Goal Kicks
    Offsides
    Possessions
    Red Cards
    Safe Balls
    Saves
    Shots
    Shots Off Target
    Shots On Target
    Substitutions
    Throw Ins
    Yellow Cards
    Yellow/Red Cards
    Tournament Info Data Points: Id
    Leg Away Score
    Leg Away Team
    Leg Home Score
    Leg Home Team
    Leg Match Id
    Leg Match Status
    Leg Number
    Name
    Round Aggregate Flag
    Round Loser
    Round Loser's Score
    Round Name
    Round Number
    Round Scheduled Length
    Round Type
    Round Week
    Round Winner
    Round Winner's Score
    Season Id
    Type
    Type Group Id
    Tournament Group Data Points: Id Name
    Venue Data Points: Capacity
    City
    Coordinates
    Country
    Country Code
    Id
    Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/matches/2015/07/26/boxscore.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", "/soccer-t2/na/matches/2015/07/26/boxscore.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/soccer-t2/na/matches/2015/07/26/boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the boxscore information for a specific day. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/matches/`{year}`/`{month}`/`{day}`/boxscore.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Boxscore, replace the parameters in the following URL. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/matches-boxscore.xsd?api_key=`{your_api_key}` ## Daily Schedule
    Update Frequency: As Necessary
    Content Type: XML
    Category Info Data Points: Country
    Country Code
    Id Name
    Match Info Data Points: Away Team Alias
    Away Team Country
    Away Team Country Code
    Away Team Id
    Away Team Name
    Away Team Type
    Home Team Alias
    Home Team Country
    Home Team Country Code
    Home Team Id
    Home Team Name
    Home Team Type
    Id
    Schedule Date/Time
    Scratched Flag
    Season Id
    Status
    Tournament Info Data Points: Id
    Leg Away Score
    Leg Away Team
    Leg Home Score
    Leg Home Team
    Leg Match Id
    Leg Match Status
    Leg Number
    Name
    Round Aggregate Flag
    Round Loser
    Round Loser's Score
    Round Name
    Round Number
    Round Scheduled Length
    Round Type
    Round Week
    Round Winner
    Round Winner's Score
    Season
    Season End Date/Time
    Season Id
    Season Start Date/Time
    Type
    Type Group Id
    Tournament Group Data Points: Id
    Name
    Season
    Season End Date/Time
    Season Start Date/Time
    Venue Data Points: Capacity
    City
    Coordinates
    Country
    Country Code
    Id
    Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/matches/2015/07/26/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", "/soccer-t2/na/matches/2015/07/26/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/soccer-t2/na/matches/2015/07/26/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To access the Daily Schedule, replace the parameters in the following URL: https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/matches/`{year}`/`{month}`/`{day}`/schedule.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Schedule, replace the parameters in the following URL. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/matches-schedule.xsd?api_key=`{your_api_key}` ## Daily Summary
    Update Frequency: As Necessary
    Content Type: XML
    Boxscore Data Points: Away Team 1st Half Score
    Away Team 2nd Half Score
    Away Team Overtime Score
    Away Team Penalty Score (Post Period)
    Away Team Penalty Score
    Away Team Score
    Away Team Total Score
    Away Team Winner Flag
    Half Number
    Home Team 1st Half Score
    Home Team 2nd Half Score
    Home Team Overtime Score
    Home Team Penalty Score (Post Period)
    Home Team Penalty Score
    Home Team Score
    Home Team Total Score
    Home Team Winner Flag
    Category Data Points: Country
    Country Code
    Id Name
    Match Facts Data Points: Away Score
    Card
    Clock
    Description
    Draw Flag
    Header Flag
    Home Score
    Id
    Injury Time
    Insert Time
    Own Goal Flag
    Penalty Flag
    Period
    Player Id
    Player In
    Player Out
    Scratch
    Team Id
    Type
    Update Time
    Winner Id
    X Coordinate
    Y Coordinate
    Match Info Data Points: Away Team Alias
    Away Team Country
    Away Team Country Code
    Away Team Formation
    Away Team Id
    Away Team Name
    Away Team Type
    Coverage Corner Facts Flag
    Coverage Deep Facts Flag
    Coverage Extended Facts Flag
    Coverage Lineups Flag
    Coverage Statistics Flag
    Coverage Tactical Lineups Flag
    Game Clock
    Home Team Alias
    Home Team Country
    Home Team Country Code
    Home Team Formation
    Home Team Id
    Home Team Name
    Home Team Type
    Id
    Period
    Referee Country
    Referee Country Code
    Referee First Name
    Referee Id
    Referee Last Name
    Schedule Date/Time
    Scratched Flag
    Season Id
    Status
    Player Match Statistics Data Points: Assists
    Goals
    Red Cards
    Start
    Substitution In
    Substitution Out
    Yellow Cards
    Yellow/Red Cards
    Team Match Statistics Data Points: Attacks
    Corner Kicks
    Dangerous Attacks
    Fouls
    Free Kicks
    Goal Attempts
    Goal Kicks
    Offsides
    Possessions
    Red Cards
    Safe Balls
    Saves
    Shots
    Shots Off Target
    Shots On Target
    Substitutions
    Throw Ins
    Yellow Cards
    Yellow/Red Cards
    Player Info Data Points: Country
    Country Code
    First Name
    Full First Name
    Full Last Name
    Id
    Jersey Number
    Last Name
    Position
    Tactical Order
    Tactical Position
    Team Manager Data Points: Country
    Country Code
    First Name
    Full First Name
    Full Last Name
    Id
    Last Name
    Tournament Info Data Points: Id
    Leg Away Score
    Leg Away Team
    Leg Home Score
    Leg Home Team
    Leg Match Id
    Leg Match Status
    Leg Number
    Name
    Round Aggregate Flag
    Round Loser
    Round Loser's Score
    Round Name
    Round Number
    Round Scheduled Length
    Round Type
    Round Week
    Round Winner
    Round Winner's Score
    Season Id
    Type
    Type Group Id
    Tournament Group Data Points: Id Name
    Venue Data Points: Capacity
    City
    Coordinates
    Country
    Country Code
    Id
    Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/matches/2015/07/26/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", "/soccer-t2/na/matches/2015/07/26/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/soccer-t2/na/matches/2015/07/26/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Summary information. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/matches/`{year}`/`{month}`/`{day}`/summary.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Summary, replace the parameters in the following URL. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/matches-summary.xsd?api_key=`{your_api_key}` ## Match Boxscore
    Update Frequency: As Necessary
    Content Type: XML
    Boxscore Data Points: Away Team 1st Half Score
    Away Team 2nd Half Score
    Away Team Overtime Score
    Away Team Penalty Score (Post Period)
    Away Team Penalty Score
    Away Team Score
    Away Team Total Score
    Away Team Winner Flag
    Half Number
    Home Team 1st Half Score
    Home Team 2nd Half Score
    Home Team Overtime Score
    Home Team Penalty Score (Post Period)
    Home Team Penalty Score
    Home Team Score
    Home Team Total Score
    Home Team Winner Flag
    Category Data Points: Country
    Country Code
    Id Name
    Match Info Data Points: Away Team Alias
    Away Team Country
    Away Team Country Code
    Away Team Formation
    Away Team Id
    Away Team Name
    Away Team Type
    Coverage Corner Facts Flag
    Coverage Deep Facts Flag
    Coverage Extended Facts Flag
    Coverage Lineups Flag
    Coverage Statistics Flag
    Coverage Tactical Lineups Flag
    Game Clock
    Home Team Alias
    Home Team Country
    Home Team Country Code
    Home Team Formation
    Home Team Id
    Home Team Name
    Home Team Type
    Id
    Period
    Schedule Date/Time
    Scratched Flag
    Season Id
    Status
    Team Match Statistics Data Points: Attacks
    Corner Kicks
    Dangerous Attacks
    Fouls
    Free Kicks
    Goal Attempts
    Goal Kicks
    Offsides
    Possessions
    Red Cards
    Safe Balls
    Saves
    Shots
    Shots Off Target
    Shots On Target
    Substitutions
    Throw Ins
    Yellow Cards
    Yellow/Red Cards
    Tournament Info Data Points: Id
    Leg Away Score
    Leg Away Team
    Leg Home Score
    Leg Home Team
    Leg Match Id
    Leg Match Status
    Leg Number
    Name
    Round Aggregate Flag
    Round Loser
    Round Loser's Score
    Round Name
    Round Number
    Round Scheduled Length
    Round Type
    Round Week
    Round Winner
    Round Winner's Score
    Season Id
    Type
    Type Group Id
    Tournament Group Data Points: Id Name
    Venue Data Points: Capacity
    City
    Coordinates
    Country
    Country Code
    Id
    Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/matches/859e4179-cc65-42f0-97aa-0faa2df5260a/boxscore.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", "/soccer-t2/na/matches/859e4179-cc65-42f0-97aa-0faa2df5260a/boxscore.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/soccer-t2/na/matches/859e4179-cc65-42f0-97aa-0faa2df5260a/boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Game Boxscore information for a specific game. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/matches/`{match_id}`/boxscore.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `match_id` | ID for a given match. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Match Boxscore, replace the parameters in the following URL. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/matches-boxscore.xsd?api_key=`{your_api_key}` ## Match Summary
    Update Frequency: As Necessary
    Content Type: XML
    Boxscore Data Points: Away Team 1st Half Score
    Away Team 2nd Half Score
    Away Team Overtime Score
    Away Team Penalty Score (Post Period)
    Away Team Penalty Score
    Away Team Score
    Away Team Total Score
    Away Team Winner Flag
    Half Number
    Home Team 1st Half Score
    Home Team 2nd Half Score
    Home Team Overtime Score
    Home Team Penalty Score (Post Period)
    Home Team Penalty Score
    Home Team Score
    Home Team Total Score
    Home Team Winner Flag
    Category Data Points: Country
    Country Code
    Id Name
    Match Facts Data Points: Away Score
    Card
    Clock
    Description
    Draw Flag
    Header Flag
    Home Score
    Id
    Injury Time
    Insert Time
    Own Goal Flag
    Penalty Flag
    Period
    Player Id
    Player In
    Player Out
    Scratch
    Team Id
    Type
    Update Time
    Winner Id
    X Coordinate
    Y Coordinate
    Match Info Data Points: Away Team Alias
    Away Team Country
    Away Team Country Code
    Away Team Formation
    Away Team Id
    Away Team Name
    Away Team Type
    Coverage Corner Facts Flag
    Coverage Deep Facts Flag
    Coverage Extended Facts Flag
    Coverage Lineups Flag
    Coverage Statistics Flag
    Coverage Tactical Lineups Flag
    Game Clock
    Home Team Alias
    Home Team Country
    Home Team Country Code
    Home Team Formation
    Home Team Id
    Home Team Name
    Home Team Type
    Id
    Period
    Referee Country
    Referee Country Code
    Referee First Name
    Referee Id
    Referee Last Name
    Schedule Date/Time
    Scratched Flag
    Season Id
    Status
    Player Match Statistics Data Points: Assists
    Goals
    Red Cards
    Start
    Substitution In
    Substitution Out
    Yellow Cards
    Yellow/Red Cards
    Team Match Statistics Data Points: Attacks
    Corner Kicks
    Dangerous Attacks
    Fouls
    Free Kicks
    Goal Attempts
    Goal Kicks
    Offsides
    Possessions
    Red Cards
    Safe Balls
    Saves
    Shots
    Shots Off Target
    Shots On Target
    Substitutions
    Throw Ins
    Yellow Cards
    Yellow/Red Cards
    Player Info Data Points: Country
    Country Code
    First Name
    Full First Name
    Full Last Name
    Id
    Jersey Number
    Last Name
    Position
    Tactical Order
    Tactical Position
    Team Manager Data Points: Country
    Country Code
    First Name
    Full First Name
    Full Last Name
    Id
    Last Name
    Tournament Info Data Points: Id
    Leg Away Score
    Leg Away Team
    Leg Home Score
    Leg Home Team
    Leg Match Id
    Leg Match Status
    Leg Number
    Name
    Round Aggregate Flag
    Round Loser
    Round Loser's Score
    Round Name
    Round Number
    Round Scheduled Length
    Round Type
    Round Week
    Round Winner
    Round Winner's Score
    Season Id
    Type
    Type Group Id
    Tournament Group Data Points: Id Name
    Venue Data Points: Capacity
    City
    Coordinates
    Country
    Country Code
    Id
    Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/matches/859e4179-cc65-42f0-97aa-0faa2df5260a/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", "/soccer-t2/na/matches/859e4179-cc65-42f0-97aa-0faa2df5260a/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/soccer-t2/na/matches/859e4179-cc65-42f0-97aa-0faa2df5260a/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Match Summary information for a specific match. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/matches/`{match_id}`/summary.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `match_id` | ID for a given match. | | `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/soccer-`{access_level}{version}`/`{league_group}`/schema/matches-summary.xsd?api_key=`{your_api_key}` ## Player Profile
    Update Frequency: As Necessary
    Content Type: XML
    Category Data Points: Country
    Country Code
    Id Name
    Player Info Data Points: Birth Date
    Country
    Country Code
    First Name
    Full First Name
    Full Last Name
    Height (Cm)
    Height (Inches)
    Id
    Jersey Number
    Last Name
    Manager Flag
    On Loan Flag
    Player Flag
    Position
    Preferred Foot
    Weight (Kg)
    Weight (Lbs)
    Player Season Statistics Data Points: Assists
    Goal Frequency
    Goals
    Goals Average
    Matches Played
    Matches Started
    Minutes Played
    Red Cards
    Statistics Year
    Substitutions In
    Substitutions Out
    Yellow Cards
    Yellow/Red Cards
    Team Info Data Points: Alias
    Country
    Country Code
    Full Name
    Id
    Name
    Reference Id
    Type
    Tournament Info Data Points: Id Name
    Tournament Group Data Points: Id Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/players/7d6f8b7a-5782-458b-a3e6-95b2482822cc/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", "/soccer-t2/na/players/7d6f8b7a-5782-458b-a3e6-95b2482822cc/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/soccer-t2/na/players/7d6f8b7a-5782-458b-a3e6-95b2482822cc/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/soccer-`{access_level}{version}`/`{league_group}`/players/`{player_id}`/profile.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `player_id` | ID for a given player. | | `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/soccer-`{access_level}{version}`/`{league_group}`/schema/players-profile.xsd?api_key=`{your_api_key}` ## Player Rankings
    Update Frequency: As Necessary
    Content Type: XML
    Category Data Points: Country
    Country Code
    Id Name
    Player Info Data Points: Country
    Country Code
    First Name
    Full First Name
    Full Last Name
    Id
    Last Name
    Position
    Player Ranking Data Points: Assists
    Goals
    Matches Played
    Own Goals
    Player Rank
    Points
    Red Card
    Substitutions In
    Total Assists
    Total Goals
    Total Matches Played
    Total Own Goals
    Total Points
    Total Red Cards
    Total Substitutions In
    Total Yellow Cards
    Total Yellow/Red Cards
    Yellow Cards
    Yellow/Red Cards
    Team Info Data Points: Alias
    Country
    Country Code
    Full Name
    Id
    Name
    Reference Id
    Type
    Tournament Group Data Points: Id
    Name
    Season End Date/Time Season Start Date/Time
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/players/leader.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", "/soccer-t2/na/players/leader.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/soccer-t2/na/players/leader.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Player Rankings. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/players/leader.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Player Rankings, replace the parameters in the following URL. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/players-leader.xsd?api_key=`{your_api_key}` ## Schedule
    Update Frequency: As Necessary
    Content Type: XML
    Category Data Points: Country
    Country Code
    Id Name
    Match Info Data Points: Away Team Alias
    Away Team Country
    Away Team Country Code
    Away Team Id
    Away Team Name
    Away Team Type
    Home Team Alias
    Home Team Country
    Home Team Country Code
    Home Team Id
    Home Team Name
    Home Team Type
    Id
    Schedule Date/Time
    Scratched Flag
    Season Id
    Status
    Tournament Info Data Points: Id
    Leg Away Score
    Leg Away Team
    Leg Home Score
    Leg Home Team
    Leg Match Id
    Leg Match Status
    Leg Number
    Name
    Round Aggregate Flag
    Round Loser
    Round Loser's Score
    Round Name
    Round Number
    Round Scheduled Length
    Round Type
    Round Week
    Round Winner
    Round Winner's Score
    Season
    Season End Date/Time
    Season Id
    Season Start Date/Time
    Type
    Type Group Id
    Tournament Group Data Points: Id
    Name
    Season
    Season End Date/Time
    Season Start Date/Time
    Venue Data Points: Capacity
    City
    Coordinates
    Country
    Country Code
    Id
    Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/matches/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", "/soccer-t2/na/matches/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/soccer-t2/na/matches/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Schedule. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/matches/schedule.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Schedule, replace the parameters in the following URL. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/matches-schedule.xsd?api_key=`{your_api_key}` ## Standings
    Update Frequency: As Necessary
    Content Type: XML
    Category Data Points: Country
    Country Code
    Id Name
    Standings Data Points: Change
    Draws
    Goal Differential
    Goals Against
    Goals For
    Home Change
    Home Draws
    Home Goals Against
    Home Goals For
    Home Losses
    Home Points
    Home Rank
    Home Wins
    Losses
    Points
    Rank
    Road Change
    Road Draws
    Road Goals Against
    Road Goals For
    Road Losses
    Road Points
    Road Rank
    Road Wins
    Wins
    Team Info Data Points: Alias
    Country
    Country Code
    Full Name
    Id
    Name
    Reference Id
    Type
    Tournament Info Data Points: Id
    Name
    Season
    Season End Date/Time
    Season Id
    Season Start Date/Time
    Type
    Type Group Id
    Tournament Group Data Points: Id
    Name
    Season
    Season End Date/Time
    Season Start Date/Time
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/teams/standing.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", "/soccer-t2/na/teams/standing.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/soccer-t2/na/teams/standing.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Standings. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/teams/standing.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Standings, replace the parameters in the following URL. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/teams-standing.xsd?api_key=`{your_api_key}` ## Team Hierarchy
    Update Frequency: As Necessary
    Content Type: XML
    Category Data Points: Country
    Country Code
    Id Name
    Team Info Data Points: Alias
    Country
    Country Code
    Full Name
    Id
    Name
    Reference Id
    Type
    Tournament Info Data Points: Coverage Delayed Facts Flag
    Coverage Live Facts Flag
    Coverage Match Roster Flag
    Coverage Match Stats Flag
    Coverage Player Profile Flag
    Coverage Season Stats Flag
    Coverage Team Roster Flag
    Id
    Name
    Season
    Season End Date/Time
    Season Id
    Season Start Date/Time
    Type
    Type Group Id
    Tournament Group Data Points: Id
    Name
    Season
    Season End Date/Time
    Season Start Date/Time
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/teams/hierarchy.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", "/soccer-t2/na/teams/hierarchy.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/soccer-t2/na/teams/hierarchy.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Team Hierarchy. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/teams/hierarchy.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Hierarchy, replace the parameters in the following URL. https:///api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/schema/teams-hierarchy.xsd?api_key=`{your_api_key}` ## Team Profile
    Update Frequency: As Necessary
    Content Type: XML
    Category Data Points: Country
    Country Code
    Id Name
    Player Data Points: Birth Date
    Country
    Country Code
    First Name
    Full First Name
    Full Last Name
    Height (Cm)
    Height (Inches)
    Id
    Jersey Number
    Last Name
    Position
    Preferred Foot
    Weight (Kg)
    Weight (Lbs)
    Team Season Statistics Data Points: Cards
    Corner Kicks
    Free Kicks
    Matches Played
    Possessions
    Shots Blocked
    Shots Off Target
    Shots On Target
    Statistics Year
    Team Info Data Points: Alias
    Country
    Country Code
    Full Name
    Id
    Manager Country
    Manager Country Code
    Manager First Name
    Manager Full First Name
    Manager Full Last Name
    Manager Id
    Manager Last Name
    Name
    Reference Id
    Type
    Tournament Group Data Points: Id Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/soccer-t2/na/teams/d733c2ab-d2fd-4ee2-9025-e3b9b9f051e4/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", "/soccer-t2/na/teams/d733c2ab-d2fd-4ee2-9025-e3b9b9f051e4/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/soccer-t2/na/teams/d733c2ab-d2fd-4ee2-9025-e3b9b9f051e4/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Team Profile. https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/teams/`{team_id}`/profile.xml?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: 2). | | `league_group` | League group in 2 letter format: Europe (eu), North America (na), South America (sa), World Cup (wc), Asia (as), or Africa (af). | | `team_id` | ID for a given team. | | `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/soccer-`{access_level}{version}`/`{league_group}`/schema/teams-profile.xsd?api_key=`{your_api_key}` ## Frequently Asked Questions Q: What leagues or tournaments do you cover for soccer? A: We cover numerous leagues and tournaments. We break the information out into specific packages. Here is a table with the groups and leagues currently covered:
    Package Name Package Abbr Category Tournament Group
    Africa AF International Africa Cup of Nations
    Africa Cup of Nations Qualifiers
    Africa Nations Championship
    Asia AS Australia A-League
    China Chinese Super League
    International Clubs AFC Champions League
    AFC Cup
    Japan Emperor Cup
    J. League
    J. League Cup
    Super Cup
    South Korea K-League Classic
    K-League Challenge
    North American NA Canada Canadian Soccer League
    International CONCACAF Confederations Cup
    CONCACAF Gold Cup
    International Clubs CONCACAF Champions League
    Mexico Primera Division
    United States Major League Soccer
    South America SA Argentina Primera Division
    Brazil Brasilero Serie A
    Carioca
    Copa do Brasil
    Paulista Serie A1
    International Copa America
    International Clubs  Copa Sudamericana
    Copa Libertadores
    UEFA EU Austria Bundesliga
    Belgium Pro League
    Denmark Superligaen
    England Championship
    FA Cup
    League Cup
    League One
    League Two
    Premier League
    France Coupe de la Ligue
    Coupe de France
    Ligue 1
    Germany  Bundesliga
    DFB Pokal
    Greece Super League
    International   European Championship
    European Championship Qualifiers
    International Friendlies
    International Clubs  UEFA Champions League
    UEFA Europa League
    Ireland Premier Division
    Italy Coppa Italia
    Serie A
    Serie B
    Netherlands Eredivisie
    Norway Eliteserien
    Poland Ekstraklasa
    Portugal Primeira Liga
    Romania Liga I
    Russia Premiere League
    Scotland Premiership
    Spain Copa del Rey
    Primera Division
    Segunda Division
    Sweden Allsvenskan
    Switzerland Super League
    Turkey Super Lig
    Ukraine Premier League
    World Cup WC International Confederations Cup
    WC Qualification
    Womens World Cup
    World Championship
    International Clubs Club World Cup

    Q: What time zone are the date time 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 are the valid match period values?

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

    • P1 = Period one
    • H = Halftime
    • P2 = Period two
    • PX1 = Pre-extra time one
    • X1 – Extra time one
    • PX2 = Pre-extra time two
    • X2 = Extra time two
    • PP = Pre-penalty
    • P = Penalty

    Q: What are the valid match status values?

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

    • scheduled – The match is scheduled to be played
    • inprogress – The match is currently in progress
    • postponed – The match has been postponed to a future date
    • delayed – The match has been temporarily delayed and will be continued
    • canceled – The match has been canceled and will not be played
    • closed – The match is over

    Q: What are the valid player position values?

    A: Here are the valid player position values and their definitions:

    • G = Goalie
    • D = Defender
    • M = Midfielder
    • F = Forward

    Q: What are the valid player tactical position values?

    A: Here are the valid player tactical position values and their definitions:

    • 0 = Unknown
    • 1 = Goalkeeper
    • 2 = Right back
    • 3 = Central defender
    • 4 = Left back
    • 5 = Right winger
    • 6 = Central midfielder
    • 7 = Left winger
    • 8 = Forward

    Q: What do each of the 5 coverage elements mean as far as the data I can expect to receive based on the coverage flags?

    A: Here are the coverage flags and what their values mean:

    Lineups

    • 0 = Lineups have not been created yet
    • 1 = Lineups have been created and are pending confirmation
    • 2 = Lineups have been confirmed

    Tactical Lineups

    • true = You get detailed position information

    Corner Facts

    • true = You get corner facts in the summary feeds

    Extended Facts

    • true = You will get all cards, free kicks, throw ins, and penalty time facts in the summary feeds

    Deep Facts

    • true = You get X and Y coordinates included with all facts in the summary feeds

    Statistics

    • true = You get team and player statistics for the match

    Q: What are the valid round types?

    A: Here are the valid round types:

    • cup
    • standard
    • table

    Q: What is the scale of the X Y coordinates?

    A: The pitch we use is 100 by 100. Here is a layout of the pitch:
    0,0 X 100,0
    Y 50,50
    0,100 100,100

    X = Horizontal position on the pitch. X is a number between 0 and 100. The reference point 0 is at the home team’s goal.

    Y = Vertical position on the pitch. Y is a number between 0 and 100. The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side.

    Q: What are the possible fact types logged?

    A: Here are all of the possible fact types we log:

    • card
    • corner_kick
    • free_kick
    • game_resumed
    • goal
    • goal_kick
    • injury
    • injury_return
    • injury_time
    • keeper_save
    • match_ended
    • match_started
    • offside
    • penalty_awarded
    • penalty_missed
    • period_over
    • period_started
    • shot_blocked
    • shot_off_target
    • shot_on_target
    • substitution
    • throwin

    Q: What are the valid tournament types?

    A: Here are the valid tournament types:

    • group
    • playoff
    • qualifier
    • variable
    Return to top