API |
API Version |
Soccer v2 |
v2.1 |
Note: Each league group requires a separate API key and authentication is required for all API calls.
|
## Soccer v2.1 API Map
To best utilize the Soccer v2.1 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:
>- Call the schedule, daily schedule, or boxscore and find the Match Id for the chosen game
- Call the Match Summary using the Match Id
- Locate the fact - draw
>The draw flag for the match is displayed.
>
>To find a players number of matches played for the season:
>- Call the player rankings and find the desired Player Id
- Call the Player Profile using the Player Id
- 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.1/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.1/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.1/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.1). |
| `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.1/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.1/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.1/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.1). |
| `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.1/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.1/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.1/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.1). |
| `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.1/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.1/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.1/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.1). |
| `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 Inventory
Update Frequency: |
As Necessary |
Content Type: |
XML or JSON |
Inventory Data Points: |
Resource Id |
SR Id |
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/soccer-t2.1/na/inventory/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", "/soccer-t2.1/na/inventory/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/soccer-t2.1/na/inventory/matches.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves the Match Inventory information for a specific game.
https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/inventory/matches.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.1). |
| `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. |
## 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.1/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.1/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.1/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.1). |
| `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 Inventory
Update Frequency: |
As Necessary |
Content Type: |
XML or JSON |
Inventory Data Points: |
Resource Id |
SR Id |
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/soccer-t2.1/na/inventory/players.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.1/na/inventory/players.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.1/na/inventory/players.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Player Inventory.
https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/inventory/players.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.1). |
| `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. |
## 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.1/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.1/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.1/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.1). |
| `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.1/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.1/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.1/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.1). |
| `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.1/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.1/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.1/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.1). |
| `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.1/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.1/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.1/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.1). |
| `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.1/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.1/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.1/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.1). |
| `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 Inventory
Update Frequency: |
As Necessary |
Content Type: |
XML or JSON |
Inventory Data Points: |
Resource Id |
SR Id |
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/soccer-t2.1/na/inventory/teams.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.1/na/inventory/teams.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.1/na/inventory/teams.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Team Inventory.
https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/inventory/teams.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.1). |
| `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. |
## 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.1/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.1/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.1/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.1). |
| `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}`
## Tournament Group Inventory
Update Frequency: |
As Necessary |
Content Type: |
XML or JSON |
Inventory Data Points: |
Resource Id |
SR Id |
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/soccer-t2.1/na/inventory/tournament_group.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.1/na/inventory/tournament_group.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.1/na/inventory/tournament_group.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Tournament Group Inventory.
https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/inventory/tournament_groups.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.1). |
| `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. |
## Tournament Inventory
Update Frequency: |
As Necessary |
Content Type: |
XML or JSON |
Inventory Data Points: |
Resource Id |
SR Id |
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/soccer-t2.1/na/inventory/tournament.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.1/na/inventory/tournament.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.1/na/inventory/tournament.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Tournament Inventory.
https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/inventory/tournament.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.1). |
| `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. |
## Venue Inventory
Update Frequency: |
As Necessary |
Content Type: |
XML or JSON |
Inventory Data Points: |
Resource Id |
SR Id |
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/soccer-t2.1/na/inventory/venues.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.1/na/inventory/venues.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.1/na/inventory/venues.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
This endpoint retrieves a Venue Inventory.
https://api.sportradar.us/soccer-`{access_level}{version}`/`{league_group}`/inventory/venues.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.1). |
| `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. |
## 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:
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: Are simulations available for Soccer v2.1?
A: Simulations for Soccer v2.1 are not currently available, though there are simulations available for Soccer v2. See the Soccer v2 documentation for more information.
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
- cancelled – The match has been cancelled 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:
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:
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