Season Top Lists

Season Top Lists widget displays statistical leaders for a season across multiple categories using a tabbed interface. The widget showcases top-performing players in goals, assists, cards (for soccer), points (for ice hockey), and injuries. It is designed for sports platforms that need to highlight statistical leaders and provide comprehensive season-level player performance data. The widget supports both soccer and ice hockey, offers flexible category selection, and includes optional contribution charts.

See the Season Top Lists widget demo.

#API Reference

#Required Parameters

• widget-name: season.topLists

The widget requires one of four identifiers to determine the season.

Required identifiers (choose one):

• seasonId: Direct season identifier
• matchId: Match ID from which season is derived
• tournamentId: Tournament identifier
• uniqueTournamentId: Unique tournament identifier

See Getting Identifiers.

Environment Requirements

Technical Requirements:

• JavaScript enabled
• XMLHttpRequest support for data fetching
• CSS3 support for styling and animations

Supported Sports

The Season Top Lists widget supports the following sports:

• Basketball & NBA (including NCAA)
• Soccer

* Conditional Requirement: One of matchId, seasonId, tournamentId, or uniqueTournamentId must be provided.

#Main Configurable Features

Illustrations of main feature variants with relevant property values below.

See Season Top Lists widget demo

#Integration Examples

#Property Name Transformations

Properties do not always transfer from the above table directly into integration code. Properties must be transformed differently for each integration method:

JavaScript/Programmatic Integration

• Property names remain unchanged in camelCase
• Properties become members of the 4th parameter object in SIR() call
• Example: cardVariant: "compact"

HTML/Declarative Integration

• Convert camelCase to lowercase with dashes, e.g. cardVariant becomes card-variant
• Add data-sr- prefix
• Example: cardVariant → data-sr-card-variant

JavaScript (Programmatic)

Initialize the widget programmatically using the JavaScript API. The widget renders in the specified container element.

(function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
)})(window,document,"script","https://widgets.sir.sportradar.com/sportradar/widgetloader","SIR", {
    language: 'en'
});

SIR('addWidget', '#sr-widget', 'season.topLists', {
    seasonId: 123
});

<div id="sr-widget"></div>

HTML (Declarative)

Insert the following HTML code at the target widget location. Complex object properties must be passed as JSON-encoded strings.

<div id="sr-widget"
        data-sr-widget="season.topLists"
        data-sr-season-id="123">
</div>
<script type="application/javascript"
        src="https://widgets.sir.sportradar.com/sportradar/widgetloader"
        async>
</script>