Unrivaled API Basics
Learn important structural concepts of the Unrivlaed API
Intro
Unrivaled is a new U.S. women’s professional basketball league founded by stars Breanna Stewart and Napheesa Collier. Unlike the WNBA, which operates a traditional summer-season format, Unrivaled features a winter schedule with a smaller roster of teams and a condensed, fast-paced competition model designed to showcase player skill and generate year-round visibility for women’s basketball.
Sportradar's Unrivaled data is delivered as a RESTful B2B (Business-to-Business) API. HTTP requests are made using the API authentication access established in your account.
Data can be returned in either JSON or XML format.
Technical Requirements
To accept data from our API feeds, ensure that your application supports TLS 1.2 or above
API Style
The Unrivaled API is a Sportradar League-Based API. This means it was designed specifically for the sport of basketball, and an aim to provide our media customers with in-depth, intuitive, and speedy Unrivaled statistics.
We provide six additional basketball data APIs: NBA, NCAA Men's Basketball, WNBA, NCAA Women's Basketball, G-League, and Global Basketball.
All of the Basketball APIs except for Global Basketball have a similar structure to the Unrivaled API, with the only differences being those necessitated by the league structures themselves. For example, Rankings data in Unrivaled behaves differently than Rankings in WNBA.
The Global Basketball API is a separate structure, adhering to our General Sport API format. Integration with the "Global" API will not be covered in this guide.
Key Distinctions from NBA and WNBA
- Game Format
Unrivaled features two distinct formats:
- 3x3 full-court — the primary competition format
- 1-on-1 tournament — a separate midseason event These formats differ from each other and may affect:
- Play-by-play event frequency
- Substitution patterns
- Shot-clock or period structure
- Possession rules
- Seasonal Dates Unrivaled has a winter-season model. Key seasonal dates (team announcements, tournaments, postseason) differ from traditional basketball leagues.
Data Collection
Data is collected and delivered using Sportradar’s standard US API format, providing a consistent structure and user experience across US Sports APIs.
Supported Languages
Currently, English is the only supported language in the Unrivaled API.
Versioning
The current version of the Unrivaled API is v8. To access v8, simply use v8 in each request to the API in the version parameter.
Data Flow and Retrieval
The Unrivaled API organizes its data into logical endpoints, or feeds. For example, to access a team schedule you will want to retrieve a "schedule" feed like Daily Schedule; to access a game, you will want to retrieve a "game" feed like Game Play-by-Play or Game Summary.
The API is separated into a set of distinct feeds, each with a focused purpose to allow for efficient data retrieval. Depending on your specific need, different feeds and pull frequencies will be needed. Use our Unrivaled Endpoints section for feed documentation and an interactive sandbox.
Most feeds will require the inclusion of a unique id or parameter. Parameters can range from: season type, season year, game id, player id, or team id. To retrieve these unique Ids you may have to iterate through feeds with larger data sets. See our ID Handling section for more info on Sportradar Ids.
Here is a retrieval path for a player profile.
Step 1
 or [Teams](https://developer.sportradar.com/basketball/reference/wnba-teams) endpoint.
See the [Endpoint Descriptions](https://developer.sportradar.com/basketball/reference/wnba-overview#endpoint-descriptions) section for data to be found in each feed.
Locate the unique Id of the team who employs this player.](https://files.readme.io/9bc242e-Standard_Game_Flow_15.png)
First, make a request to the League Hierarchy or Teams endpoint.
See the Endpoint Descriptions section for data to be found in each feed.
Locate the unique Id of the team who employs this player.
Step 2
 feed using your
found team Id and locate the unique player Id.](https://files.readme.io/7891d2e-Standard_Game_Flow_16.png)
Second, make a request to the Team Profile feed using your found team Id and locate the unique player Id.
Step 3
 feed to find
player biographical info, draft info, and seasonal stats.](https://files.readme.io/a4dd92a-Standard_Game_Flow_17.png)
Third, make a request to the Player Profile feed to find player biographical info, draft info, and seasonal stats.
All Unrivaled API feeds will follow this pulling logic. Visit our Integration Scenarios section for specific retrieval scenarios.
You can also reference our Unrivaled API Map to get a sense of how the entire API is interconnected.
Change Log
The Unrivaled API includes a Daily Change Log feed, which is used to catch updates for teams, players, game stats, schedules, standings, and rankings.
A request is made for a specific date, which then returns a list of unique Ids and timestamps of updates on that day. You can then use these Ids to retrieve stat updates from other endpoints. This allows for quick and efficient data retrieval, and will be a common concept across all integration scenarios.
See our Change Log guide for detail on how to efficiently leverage this feed.
Pagination
The Unrivaled API does not currently make use of pagination for any endpoint. Each return will provide all data available.
Additional Integration Options
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
More Questions?Check our Unrivaled API FAQ or reach out to our support team at [email protected]
Updated about 4 hours ago