Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

NCAAWB API Basics

Learn important structural concepts of the NCAA Women's Basketball API

Intro

Sportradar's NCAA Women's Basketball (NCAAWB) 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
  • Can follow an HTTP redirect (used in Push) and the Images API

API Style

The NCAAWB API is a Sportradar Leagued-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 Women's College Basketball statistics.

We provide five additional basketball data APIs: NBA, WNBA, NCAA Men's Basketball, G-League, and Global Basketball.

All of the Basketball APIs except for Global Basketball have the exact same structure as the NCAAWB API, with the only differences being those necessitated by the league structures themselves. For example, RPI Rankings data in the Women's College Basketball behaves differently than Rankings in the 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.


Data Collection

Sportradar’s NCAA Women's Basketball API offers a comprehensive set of data through game, player, and seasonal feeds. This data is captured using proprietary software developed by Sportradar and is meticulously gathered by in-house production operators who monitor games via broadcast video feeds.


Versioning

The current version of the NCAAWB API is v8. We strongly recommend using the latest version of all of our APIs, as these will be the most stable and robust offerings. However, we do support up to 3 versions (the current and 2 past versions) of our data APIs, per our Versioning Policy.

To access NCAAWB v8, simply use v8 in each request to the API in the version parameter. To access previous versions, alter to v7 or v3. No other adjustment is necessary for access.


Data Flow and Retrieval

The NCAA Women's Basketball 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 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 21 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 NCAAWB 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

First, make a request to the [Season Schedule](https://developer.sportradar.com/basketball/reference/ncaaWb-season-schedule) or [Teams](https://developer.sportradar.com/basketball/reference/ncaawb-teams) endpoint. 

See the [Endpoint Descriptions](https://developer.sportradar.com/basketball/reference/ncaawb-overview#endpoint-descriptions) section for data to be found in each feed. 

Locate the unique Id of the team who employs this player.

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

Second, make a request to the [Team Profile](https://developer.sportradar.com/basketball/reference/ncaawb-team-profile) feed using your  
found team Id and locate the unique player Id.

Second, make a request to the Team Profile feed using your
found team Id and locate the unique player Id.

Step 3

Third, make a request to the [Player Profile](https://developer.sportradar.com/basketball/reference/ncaawb-player-profile) feed to find  
player biographical info, draft info, and seasonal stats.

Third, make a request to the Player Profile feed to find
player biographical info, draft info, and seasonal stats.

All NCAAWB API feeds will follow this pulling logic. Visit our Integration Scenarios section for specific retrieval scenarios.

You can also reference our NCAAWB API Map to get a sense of how the entire API is interconnected.

Change Log

The NCAAWB 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 details on how to efficiently leverage this feed.


Pagination

The Women's College Basketball 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 NCAA Women's Basketball 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 NCAA Women's Basketball API XSD schema.

NCAAWB v8 Schema

Simulations

Click here for a detailed breakdown on our available simulations.

🏀

More Questions?

Check our NCAAWB API FAQ or reach out to our support team at [email protected]