Sportradar APIs
This is a Python wrapper for the sports APIs provided by Sportradar. You'll need to sign up for an API key to use the service. Sportradar provides a free trial evaluation that provides 1,000 API queries at up to 1 query per second.
Supported APIs
| Sport | API Wrapper | Unit Tests |
|---|---|---|
| Soccer |
|
|
| NBA |
|
|
| WNBA |
|
|
| NCAAMB |
|
|
| NFL |
|
|
| NHL |
|
|
| Tennis |
|
|
| MLB |
|
|
| Darts |
|
|
| Beach volleyball |
|
|
| Golf |
|
|
| NASCAR |
|
|
| LoL |
|
|
| Dota2 |
|
|
| Cricket |
|
|
| Rugby |
|
|
Installation
The easiest way to start using this package is via PyPI using pip:
$pip install sportradar
If you'd prefer to clone the repository and install the package manually, follow these steps:
- Clone this repo:
$git clone https://github.com/johnwmillr/SportradarAPIs.git - Enter the cloned directory:
$cd SportradarAPIs - Install:
$python setup.py install
Usage
Below is a brief demonstration of how to use the package to download data for the 2018 FIFA World Cup.
from sportradar import Soccer
# Create an instance of the Sportradar Soccer API class
sr = Soccer.Soccer("paste your api key here")
# Get a list of all tournaments
tournaments = sr.get_tournaments().json()
# Get info on the 2018 World Cup (Teams, Rounds, etc.)
worldcup = sr.get_tournament_info(tournaments['tournaments'][4]['id']).json()
# Get more information on each team in the World Cup
teams = []
team_counter = 0
for group in worldcup['groups']:
for team in group['teams']:
team_counter += 1
team_id = team['id']
team_name = team['name']
print("({}): {}, {}".format(team_counter, team_name, team_id))
try:
teams.append(sr.get_team_profile(team_id).json())
except Exception as e:
print("Error: {}".format(e))
time.sleep(5) # wait 5 seconds before next API call
# Save the team data to a .json file
print("Saving the data...", end="", flush=True)
with open("world_cup_team_data.json", "w") as outfile:
json.dump(teams, outfile)
print(" Done.")
16 Jan 2, 2023
125 Dec 26, 2022
3 Oct 25, 2022
5 Oct 7, 2022
1 May 20, 2022
6.2k Jan 8, 2023
756 Jan 6, 2023
114 Dec 11, 2022
47 Oct 31, 2022
921 Jan 8, 2023
3 Apr 12, 2022
1 Oct 2, 2021
79 Dec 22, 2022
34 Dec 15, 2022
1 Dec 20, 2021
1.4k Jan 1, 2023
222.5k Jan 2, 2023
84 Nov 17, 2022