Skip to main content
The Sports resource provides access to sports configuration and team information from data providers.

Methods

MethodEndpointDescription
list()GET /v1/sportsList all sports
teams(params?)GET /v1/sports/teams/providerGet teams by provider

list

Get all available sports and their configuration.
sports = client.sports.list()

for sport in sports["sports"]:
    print(f"{sport['sport']} - Operational: {sport['isOperational']}")

Response Fields

FieldTypeDescription
sportstrSport name
imagestrSport image URL
isOperationalboolWhether sport is operational
automaticResolutionboolWhether automatic resolution is enabled
orderingstrDisplay ordering

teams

Get team information from a specific data provider.
teams = client.sports.teams({
    "provider": "PROVIDER_SPORTRADAR",
    "league": "NFL",
})

for team in teams["teams"]:
    print(f"{team['name']} ({team['abbreviation']})")
    print(f"  Conference: {team['conference']}")
    print(f"  Record: {team['record']}")

Parameters

ParameterTypeDescription
providerstrData provider (see below)
leaguestrLeague name (NFL, NBA, MLB, etc.)
teamIdslist[int]Filter by specific team IDs

Data Providers

ProviderDescription
PROVIDER_SPORTRADARSportradar
PROVIDER_SPORTSDATAIOSportsData.io

Team Fields

FieldTypeDescription
idintTeam identifier
namestrTeam name
abbreviationstrTeam abbreviation
leaguestrLeague name
conferencestrConference name
recordstrTeam record
rankingintTeam ranking
logostrLogo URL
colorPrimarystrPrimary team color