Global SIR API

The SIR API is exposed as a global SIR function that provides the primary interface for integrating and managing Sportradar widgets on your page.

#Global Configuration Options

The following options can be configured in the widgetloader script initialization:

#Initialization

<script type="text/javascript">
    (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/YOUR_CLIENT_ID/widgetloader","SIR", {
        language: 'en',
        debug: true
    });
</script>

<script>
     // Syntax: SIR(<methodName>[, ...arguments]);
     SIR('addWidget', '#my-div', 'match.scoreboard');
</script>
<div id="my-div"></div>

#API Methods

All methods are invoked using the global SIR function with the method name as the first parameter, followed by method-specific arguments.

#addWidget

Adds a widget to a specified DOM element or selector.

#Parameters

props sub-properties:

#updateWidget

Updates a widget on given DOM element or selector.

#Parameters

#removeWidget

Removes a widget on given DOM element or selector.

#Parameters

#registerAdapter

Registers a data adapter for retrieving information from your page or custom APIs.

#check

Scans the DOM for elements with the data-sr-widget attribute and initializes any uninitialized widgets. Also destroys widget instances when their DOM nodes are removed.

#Parameters

#changeLanguage

Changes the display language for all widgets.

#Parameters

#changeClockType

Changes the clock format between 12-hour and 24-hour display.

#Parameters

#changeOddsType

Changes the odds display format across all widgets.

#Parameters

#changeTeamInvert

Controls the left/right positioning of home and away teams in widget displays.

#Parameters

Example:

// Invert all baseball matches (sport ID 3)
SIR('changeTeamInvert', { sid: { 3: true } });

// Invert all matches across every sport
SIR('changeTeamInvert', { all: true });

// Invert matches in a specific real category (rcid)
SIR('changeTeamInvert', { rcid: { 44: true } }); // e.g. UEFA Champions League

// Invert matches in a specific unique tournament (utid)
SIR('changeTeamInvert', { utid: { 1: true, 17: true } }); // e.g. specific competitions

// Combine multiple scopes
SIR('changeTeamInvert', { sid: { 3: true }, utid: { 1: true } });

#changeLogLevel

Changes the logging verbosity level for debugging purposes.

#Parameters

#setClientTheme

Dynamically loads and applies a widget theme.

#Parameters