A Python wrapper for the Sportradar APIs
Project description
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 | Wrapper | Tests |
---|---|---|
Soccer :soccer: | :heavy_check_mark: | :heavy_check_mark: |
NBA :basketball: | :heavy_check_mark: | :heavy_check_mark: |
WNBA :basketball: | :heavy_check_mark: | :heavy_check_mark: |
NFL :football: | :heavy_check_mark: | :heavy_check_mark: |
NHL :trophy: | :heavy_check_mark: | :heavy_check_mark: |
Tennis :tennis: | :heavy_check_mark: | :heavy_check_mark: |
MLB :baseball: | :heavy_check_mark: | :heavy_check_mark: |
Darts :dart: | :heavy_check_mark: | :heavy_check_mark: |
Beach volleyball :palm_tree: | :heavy_check_mark: | :heavy_check_mark: |
Golf :golf: | :heavy_check_mark: | :heavy_check_mark: |
NASCAR :red_car: | :heavy_check_mark: | :heavy_check_mark: |
LoL :video_game: | :heavy_check_mark: | :heavy_check_mark: |
Dota2 :video_game: | :heavy_check_mark: | :heavy_check_mark: |
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(sportsradar.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.")
Example projects
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
sportradar-1.2.1.tar.gz
(12.6 kB
view hashes)
Built Distribution
sportradar-1.2.1-py3-none-any.whl
(18.8 kB
view hashes)
Close
Hashes for sportradar-1.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 93137bdc60de7c61ca991e3d915d47449501b6b112fab9a30128e27a19b43ba7 |
|
MD5 | 5c944c44d581959a58601dc13376d78b |
|
BLAKE2b-256 | 27b00188d6ed0e6c2483cb4f4856923962a2482014502ffebbede38abc5a97c3 |