Unrivaled Overview

Introduction

Sportradar is the Official Data Provider of Unrivaled data. All game data feeds update in real-time as games are played and are compiled via Sportradar‘s expert in-house operators.

The Unrivaled API is consistent in structure, format, and behavior with our other League Specific APIs (e.g. WNBA, NCAAWB).

Primary endpoints return schedules, standings, team rosters, and real-time scores. Additional endpoints provide complementary data, including player transfers, injuries, and in-depth season stats.

🗝️
Authentication is required for all API calls.

🏀
Unrivaled Integration Guide
Explore our Unrivaled API Integration Guide for detailed, step-by-step guidance on how to build applications using our Unrivaled API.

Key Data Differences

The Unrivaled API follows the same structure as our existing WNBA and NCAA Women's Basketball APIs. If you are already integrated with either API, you can integrate with Unrivaled quickly.

However, there are several league-specific updates to be aware of. Below is a high-level overview of key changes. See our Unrivaled Integration Guide for more comprehensive integration details.

🏀 3-on-3 Format and 1-on-1 Tournament

Unrivaled includes both 3-on-3 games and a separate 1-on-1 midseason tournament. Some game behavior (clock rules, substitutions, period structure) differs between formats.

⛹️‍♀️ Elam Period & Game Clock Behavior

Unrivaled uses an Elam Ending to determine the winner in the final phase of the game.

This introduces:

A new period type: elam
Two additional clock fields: clock_type and clock_directional

Click here for detailed behavior and samples.

🏀 Weighted Free Throws

Unrivaled uses a single-attempt weighted free-throw system, similar to the NBA G League.

Fouled on a 2-point attempt → One free throw worth 2 points
Fouled on a 3-point attempt → One free throw worth 3 points

Data Updates:

Game Summary includes the total weighted free-throw points for players and teams (free_throw_points)
Game Play-by-Play marks these attempts using free_throw_type="weighted" and provides textual context in event.attempt and description

Click here for detailed behavior and samples.

⛹️‍♀️ Game-Winning Basket

Because every Unrivaled game ends on an Elam score, the feed includes a dedicated indicator for the final made basket.

Game Summary provides a winning_basket data point at both the player and team level
Seasonal Statistics and Player Profile endpoints aggregate this as winning_baskets

Click here for detailed behavior and samples.

🏀 Lineup Changes

Unrivaled includes additional substitution and rotation events:

lineupchangeone
lineupchangethree

These reflect fast-paced lineup swaps common to 3-on-3 basketball.

Click here for detailed behavior and samples.

⛹️‍♀️ Awarded Points

Coming soon. This will include a new event type and corresponding player/team data fields.

🏀 Coordinate Dimensions

Details coming soon. Unrivaled plays on a compressed full court. Details on our coordinate data are coming soon.

API Map

To best utilize the Unrivaled API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables.

Endpoint Descriptions

Daily Change Log – Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.

Daily Injuries – Provides details for all injuries updated on a given date.

Daily Schedule – Date, time, location, and other event details for every game taking place in the league-defined day.

Daily Transfers – Information for all transfers added or edited during the league-defined day.

Game Boxscore – Top-level team scores by quarter, along with full statistics for each teams’ leaders in points, rebounds, and assists.

Game Play-by-Play – Detailed, real-time information on every team possession and game event.

Game Summary – Top-level boxscore information along with detailed game stats at the team and player levels.

Injuries – Information concerning all active Unrivaled player injuries.

League Hierarchy – League and team identification and association information.

League Leaders – Unrivaled leader information for various offensive and defensive categories including full player seasonal statistics for each player in each category.

Player Profile – Provides player biographical information and seasonal statistics.

Rankings – League ranking for each team.

Schedule – Date, time, location, and other event details for every match-up taking place in the full league season.

Seasonal Statistics – Provides complete team and player seasonal statistics for a given season and season type.

Seasons – Provides a list of all available seasons.

Series Schedule – Schedule details for every match-up in a given series.

Series Statistics – Detailed team and player statistics for a given series.

Standings – Detailed team records across an assortment of categories.

Team Profile – Provides top-level team information and a full roster of active players.

Teams – Provides a complete list of active teams in the Unrivaled API database.

Tournament List – Summarized list of all tournaments scheduled for the given season including tournament name, location, start date, and end date.

Tournament Schedule – Date, time, location, and other event details for every match-up taking place for a given tournament.

Tournament Summary – Tournament information including location, status, start date, end date, set up and participants.

Data Retrieval Samples

To find a team's leader in assists for a given game:

Call the season or series schedule and find the Game Id for the chosen game
Call the Game Boxscore using the Game Id
Find the Team Assists Leader statistics and locate the player full_name attribute

The name of the team's leader in assists is displayed.

To find a player's average points per game:

Call the season or series schedule and find id for the team the player is on
Call the Team Profile using the Team ID
Locate the Player ID for your chosen player and call the Player Profile.
Find the average element with the points attribute

The player's average points are displayed.

Integration Links

Integration Guide

Set up an account, learn the Unrivaled API basics, study our game workflows, tackle in-depth integration scenarios, and more by visiting our Unrivaled v8 Integration Guide!

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Unrivaled API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Unrivaled API XSD schema.

Unrivaled v8 Schema