Docs
Coverage MatrixDocumentationRelease LogLog In

NCAAMB Overview

Get started with NCAAMB API v8

Introduction

Sportradar’s NCAAMB API offers a comprehensive suite of game and seasonal stats to power your basketball experiences. Whether looking for the fastest gameday updates or your favorite player’s season stats, Sportradar has you covered.

All game data feeds update in real-time as games are played and are compiled via Sportradar‘s expert in-house operators. Real-time play-by-play coverage is provided for 100% of major conference matchups (B10, Big East, Big 12, Pac-12, ACC, SEC, A10, MVC, WCC, AAC, MW).

Primary feeds will return schedules, standings, team and player data, and real-time scores.

Additional feeds provide a host of complementary stats, including: 

  • Player profiles
  • Team rosters
  • Top 25 rankings
  • Seasonal statistics
  • In-game substitution info
  • Live event positional data

Real-time customers are also offered two delivery Push Feeds to enhance speed.

🗝️

Authentication is required for all API calls.

API Map

To best utilize the NCAA Men's Basketball 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.

Tournament IDs

Tournament Ids are only listed in the Tournament List feed. Use the Tournament List to get the Ids required to access the Tournament Schedule and Tournament Summary.



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 Schedule – Date, time, location, and other event details for every match-up taking place in the league-defined day.

Game Boxscore – Top-level team scores by half along with full statistics for each team’s leader in points, rebounds, and assists.

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

League Hierarchy – League, conference, division, and team identification and association information.

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

NET Rankings – Provides the NCAA NET rankings for a given season.

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

Player Profile – Provides player biographical information and seasonal statistics.

Rankings (Current) – List of current Associated Press and USA Today rankings, including those teams not ranked but receiving votes.

Rankings (Weekly) – List by week of Associated Press and USA Today rankings, including those teams not ranked but receiving votes.

RPI Rankings – RPI information including rating, strength of schedule, ranking, and records based on the Sportradar’s RPI calculations.

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

Seasonal Statistics – Detailed team and player statistics for the defined season.

Seasons – Provides a list of all available seasons.

Standings – Detailed team records across various views including, overall, conference, and division information.

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

Teams – Provides a complete list of teams in the NCAA Men's Basketball 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 Statistics – Detailed team and player statistics for the defined tournament.

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

Push Events – Detailed, real-time information on every game event.

Push Statistics – Detailed, real-time game stats at the team and player level for all live games.



Data Retrieval Samples

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

  1. Call the schedule or daily schedule and find the Game Id for the chosen game
  2. Call the Game Boxscore using the Game Id
  3. 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:

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

The players's average points are displayed.


Coverage Levels

We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.

Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team and player level data in near real time. Full coverage is available for any game in which we have a reliable broadcast available and one or more participants are members of the following conferences: B10, Big East, Big 12, Pac-12, ACC, SEC, A10, MVC, WCC, AAC, MW.

Extended Boxscore – We provide scores and time remaining, in a timely manner, as the game progresses. We provide team and player level data for the game within 120 minutes of the official results being posted. Extended Boxscore coverage is available for any game involving a Division I program, not covered via our full coverage offering.

All early season tournament and conference tournament games available from a reliable broadcast will be full coverage.

🏀

Coverage Note

Coverage levels are subject to change up to the scheduled game start time. Changes are usually due to resource availability or possible broadcast and technical difficulties.

Recommended Feeds Per Coverage Level

Based on the differences between our available coverage levels we recommend specific game-centric feeds for each coverage level.

FeedsFullExtended Boxscore
(In Progress)
Extended Boxscore
(Post Game)
Game BoxscoreXXX
Game SummaryXXX
Play-by-PlayX

Integration Links

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our NCAA Men'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 Men's Basketball API XSD schema.

NCAAMB v8 Schema


March Madness Workflow & Samples

Sportradar's data entry experts will have the entire field input within 2 hours of the announcements on Selection Sunday.

Prior to the matchup announcements, the Tournament Schedule and Tournament Summary feeds will return 200 results with basic Regional bracket information included. To access these feeds, you must input the NCAA Men's Division I Basketball Tournament unique ID, found in the Tournament List feed. See below for sample data.


Tournament Samples

Pre-Selection Sunday
Tournament Schedule - Tournament Summary

During the matchup announcements all available team and schedule data is added to each feed. See below for sample data.

Selection Sunday - Top 4 Seeds Announced (Region Rank Included)
Tournament Schedule - Tournament Summary

Selection Sunday - Midway Through Announcement
Tournament Schedule - Tournament Summary

After Selection Sunday
The below sample provides the behavior of the Schedule and Summary feeds after all Selection Sunday matchups have been announced and populated in our feeds.

All tournament games are included, with team id and seed omitted for TBD matchups. Teams are promoted to the next round within 10 minutes of complete status (when a game has ended and the final score confirmed) of the prior game.
Tournament Schedule - Tournament Summary

Completed Bracket
You can reference a completed Division I Tournament bracket here and here.


Live Tournament Coverage

Men’s: All games are covered via full coverage with substitution data. Realtime data includes:

  • Full play-by-play
  • Team statistics
  • Player statistics (including player minutes and plus/minus)

Women’s: All games are covered via full coverage. Realtime data includes:

  • Full play-by-play
  • Team statistics
  • Player statistics (no realtime player minutes or plus/minus)

Please note that the game time for March Madness games will be adjusted in the schedule feeds if the game time is changed by the broadcast network.


Postgame Coverage

Tournament Schedule:
Teams are promoted to the next round within 10 minutes of complete status (when a game has ended and the final score confirmed) of the prior game.

Tournament Statistics:
Team statistics will be updated in the Tournament Statistics endpoint within 20 minutes after a game goes to closed status.

On average, it takes about 30 minutes to close a men’s game. As a result, on average, it takes approximately an hour for team statistics to update after a game ends.


March Madness FAQ

How do I know the order or position (top left, bottom left, etc) in the bracket for each region?

In the Tournament Summary endpoint, each region has a rank value. The region's position in the bracket is based on that rank value.

  • Top Left Quadrant: Regional Rank = 1 - South Regional in Example Provided
  • Bottom Left Quadrant: Regional Rank = 4 - West Regional in Example Provided
  • Top Right Quadrant: Regional Rank = 2 - East Regional In Example Provided
  • Bottom Right Quadrant: Regional Rank = 3 - Midwest Regional in Example Provided

The region rank value will be populated as soon as each number 1 seed is announced (top 4 overall seeds in the tournament) at the start of the Selection Sunday show.



Data Entry Workflow

See below for a daily breakdown of data updates for the NCAA Men's Basketball API.

Sunday

  • Final game times and coverage levels set for day's games (10am CT)
  • Games stats validated and moved to closed status (120 minutes after game goes final)

Monday

  • Weekly AP and USA Today Top 25 Polls Created (5pm CT)
  • Final game times and coverage levels set for day's games (10am CT)
  • Initial coverage levels set for week's games [Monday-Sunday] (5pm CT) Levels subject to change
  • TV Broadcast information updated (End of Day)
  • Games stats validated and moved to closed status (120 minutes after game goes final)
  • Seasonal stats validation (All Day)

Tuesday

  • Final game times and coverage levels set for day's games (10am CT)
  • Games stats validated and moved to closed status (120 minutes after game goes final)
  • Seasonal stats validation (All Day)

Wednesday

  • Final game times and coverage levels set for day's games (10am CT)
  • Games stats validated and moved to closed status (120 minutes after game goes final)
  • Seasonal stats validation (All Day)

Thursday

  • Final game times and coverage levels set for day's games (10am CT)
  • Games stats validated and moved to closed status (120 minutes after game goes final)

Friday

  • Final game times and coverage levels set for day's games (10am CT)
  • Games stats validated and moved to closed status (120 minutes after game goes final)

Saturday

  • Final game times and coverage levels set for day's games (10am CT)
  • Games stats validated and moved to closed status (120 minutes after game goes final)

Important Dates & Timings

  • NCAA Men's Basketball schedule becomes available by late October.

  • All game times and dates are monitored and validated throughout the season and confirmed the day of the game.

  • Coverage levels are set prior to the start of each week and re-affirmed each morning.