Developer Portal

College Basketball Workflow Guide

Competition Feeds

Standings, Rankings, and Brackets

College Basketball standings are available as traditional standings, rankings, and bracket style tracking. Standings records include total wins/losses, conference wins/losses, AP Poll and Coaches' Poll rankings.

Current Season Standings:

Standings are specific to the season type being requested (Reg, Post)

Regular Season Standings - refers to wins and losses exclusively related to the Regular Season and stop updating once the postseason begins.
Postseason Standings - refers to wins and losses exclusively related to the postseason and not carry over any regular season or pre season wins and losses.

NCAA Top 25 Rankings:

During the Regular Season, top 25 rankings are released each week on Monday. AP rankings are updated in League Hierarchy shortly after top 25 rankings are released.

NCAA Tournament Bracket:

Our NCAA March Madness brackets are pre-created 21 days prior to Selection Sunday with Game ID’s. (Prior to the team assignments, GameID will have teams listed as "TBD")

On Selection Sunday, Teams and TeamIDs are assigned to the bracket's GameID(s) live as they are announced on the live broadcast.
The following round teams will display as "TBD" until the previous round’s matchups are settled.

Teams, Players & Rosters

College Basketball Teams, Players, and Rosters are updated year-round, including throughout the duration of the off-season. Team official sites will publish their updated rosters for each upcoming season to include incoming Freshman, as well as any transfer players that are added to the roster.

While our rosters and player profiles are managed throughout the offseason, they are not considered finalized for the upcoming season until the official team rosters are published on school websites. Then, our records are checked and updated to ensure accuracy for the upcoming season.

Player Profiles include data fields such as name, position, class (senior, redshirt freshman, etc), number, height/weight, high school, and home town.
Player rosters are updated when players move to teams and are updated typically within hours of moves becoming official.
Team profiles include data fields such as name, conference, and home stadium.
SportsDataIO has team abbreviations for schools which match the broadcast.
The ShortDisplayName field can be used for school abbreviations as opposed to the abbreviation provided for the Key field. Many of the Key and ShortDisplayName abbreviations are the same, but there are slight differences
All CBB GlobalPlayerID's start with 600.
SportsDataIO only provides coverage for players from Division I basketball schools. Even if a Division I is playing a Division II or III school, only the Division I school will have player info and stats.

Transfer Portal

The College Basketball transfer window takes place each year beginning sometime at the end of March (after the 2nd Round of the NCAA Tournament) and spans 30 days long. Player profiles and rosters are actively managed throughout the duration of the transfer window. In the event that a player enters their name in the transfer portal and their current team has any scheduled game(s) left on their post-season schedule, the team’s official roster is monitored to determine the status of the player.

A full list of available data fields can be found here:

PlayerBasic

TeamBasic

Team

Venues & Officials

Venues:

CBB Venue feeds include all active venues that are currently available to host games each CBB season.

While CBB venues remain relatively static, when a neutral site is scheduled to host a game, SportsDataIO creates a new profile for each new venue and adds it to the CBB venues feed.
Throughout the season, there are a number of College Basketball games hosted at neutral venues. Use the NeutralVenue field to determine if a game is being played at a neutral venue.
If a team is playing in an NBA or NFL arena, the StadiumID for CBB may be different than the NBA or NFL StadiumID.

Officials:

SportsDataIO does not track college basketball referees.

Event Feeds

Schedules & Gameday Info

Regular Season Schedule

College basketball schedules are typically announced on a per-team or per-conference basis throughout the summer months and will vary year-to-year. Once the schedule is officially announced, we match and update our records.

Occasionally, neutral-site regular season games may have home and away teams listed inconsistently across various sources. SportsDataIO attempts to align with industry standards, but to maintain data stability and avoid deleting previously created games, we do not guarantee complete alignment with all external sources. In situations where a GameID must be removed and re-created, SportsDataIO will proactively notify clients of the change.

The current and upcoming schedule is updated continuously at intervals each day to ensure the latest changes are taken into account.

March Madness and Selection Sunday

Our NCAA March Madness brackets are pre-created 21 days prior to Selection Sunday with Game ID’s. Prior to the team assignments, the GameID will have teams listed as TBD.

On Selection Sunday, our Data Operations team sets the seeds for teams in real time as they are announced on the live broadcast. The Women’s College Basketball brackets are not updated live and will appear following the announcement of the entire bracket seeding.

The home/away teams will not be assigned based on seed in the Men's College Basketball Tournament. Instead, we will assign teams to away/home based on their previous game in the bracket. This allows us to move much faster in the creation of new games and odds, because we will no longer need to wait for both games to end before slotting them into the next round of the tournament.
For the Men's College Basketball Tournament in March, all schedule, seeding, and game day info can be found in our Tournament Hierarchy endpoint. Day and time of games are in the Eastern Time Zone

In addition to the Men's College Basketball Tournament in March, SportsDataIO has full coverage for the National Invitation Tournament (NIT), College Basketball Invitational (CBI), and College Basketball Crown Tournament. These tournaments will not be given a TournamentID, but you can find them with the POST season type parameter in the Schedules endpoint.

Scores & Game State

Scores and Game State are updated live during all games, along with the final score being provided after the game is completed and verified.

Score includes the score for each half the final score for both teams.
Game State includes things like score, current half, time remaining, possession and if the game is in overtime.

Final Only (No Game State)

Final score results are delivered after the event is final and are delivered in half and total score values. Final scores are available around 5-10 minutes after each game concludes.

The home/away teams will not be assigned based on seed in the Men's College Basketball Tournament.
Instead, we assign teams to away/home based on their previous game in the bracket. This allows us to move much faster in the creation of new games and odds, because we will no longer need to wait for both games to end before slotting them into the next round of the tournament.

Live & Final (With Game State)

Live Game coverage is delivered when an event "Status" field switches from "Scheduled" to "InProgress"
Game State data is updated alongside all other live in-game data, with a delay approximately 30-60s behind TV broadcast.
Live scores are delivered in half and total score values.
Final Scores are available at the conclusion of each event.

A full list of available score details can be found here:

Game

ScoreBasic

Team & Player Stats

Team and Player Stats are managed on a game by game basis as well as season long totals. Stats are updated in season for every game, along with detailed Box Score level information for each particular game.

Final Only

CBB team and player stats are delivered after the event is final - typically 5-10 minutes after each game concludes.
Each game's final player stats are added to a player's and team's Season Stats once the game's final player stats are verified by our team (approximately 1 hour after each game is completed).
When a Division I school plays a Division II or Division III school, we will show who the Division II or Division III school is and the score of the Division II or Division III school, but we will not collect any player or teams stats for them in the game.

A full list of available stats can be found here:

Live & Final

CBB team and player Game Stats delivered as "Live" include live stat updates throughout the game, typically 15-20 seconds behind the TV broadcast.
Each game's final player stats are added to a player's and team's Season Stats once the game's final player stats are verified by our team (approx 1 hour after each game is completed).
When a Division I school plays a Division II or Division III school, we will show who the Division II or Division III school is and the score of the Division II or Division III school, but we will not collect any player or team stats for them in the game.
Minutes played for each CBB player is delivered post-game once the game is final.

A full list of available stats can be found here:

Player Feeds

Injuries

SportsDataIO monitors and provides updates to injuries for all NCAA Division I teams. Injuries are managed during the regular season and postseason. During the offseason, only players dealing with serious injuries, who are guaranteed to miss any upcoming regular season game(s), will be managed.

Official injury wires for each NCAA Division I team, as well as trusted media sources, are monitored to determine the latest injury status of each player. While official sources are always preferred, credible media reports are also used to ensure we are up to date.

Conference Injury Reports

Currently, the BIG10 and SEC conferences are the only that require their teams to release an official injury report prior to every game.

BIG10

Releases its injury report on a weekly basis, and makes updates periodically to each team's page.
Our records are matched to reflect player status and reviewed periodically leading up to games to ensure that injuries are accurate and up to date.

SEC

Releases its injury report on a daily basis, and makes updates periodically leading up to games. The SEC only posts the official injury report for games between two SEC opponents.
Our records are matched to reflect player status and reviewed periodically leading up to games to ensure that injuries are accurate and up to date.

Key fields that should be consulted:

InjuryStatus: A player's game status (Probable, Questionable, Doubtful, or Out)
InjuryBodyPart: The body part affected
InjuryStartDate: The date at which the player's injury was first verified
InjuryNotes: A written description of the player's injury, e.g.: "Allen is dealing with a knee injury and will not take the court for the Blue Devils."

Betting Feeds

Game Lines

Game lines (spread, moneyline, totals) available as both pre-match and in-play, including timestamps for opening price, all line movement changes, and closing price, with optional resulting available as an add-on.

Odds are made available when sportsbooks publish opening lines, typically starting Sunday of each game week.
Includes full-game odds markets plus partial game lines such as halves.

Pre-Game Lines

Includes full-game odds markets plus partial game lines such as halves. Does not include resulting of game line markets.

College Basketball Pre Game Lines are made available early on game day or occasionally the night before. If a team has multiple days between games, they may be available earlier.

Pre-Game Lines Plus

Includes all line movement for pre game odds markets.

Resulting: See our Betting Guide for available markets with resulting and how it works.
Line Movement: The Betting Guide also explains how to access the Betting Market endpoints to view an individual market's movement.

In-Play Lines

In-play betting markets, including spread, moneyline, and totals are available immediately following the start of each game as the sportsbooks make them available.

Halftime lines are available through the In-Game Odds endpoint. To retrieve these odds, you'll need to call the endpoint during halftime. The lines will continuously update throughout halftime and into the second half. Once the game resumes, you can either stop calling the endpoint or continue to received updated odds as the second half plays out. If you would like to know when the game has reached halftime, please refer to the Period field in the Game object.

In-Play Lines Plus

Includes all line movement for In-play betting markets

Resulting: See our Betting Guide for available markets with resulting and how it works.

Line Movement: The Betting Guide also explains how to access the Betting Market endpoints to view an individual market's movement.

Props

Includes Player, Game, and Team Props available as both pre-match including timestamps for opening price, all line movement changes, and closing price, with optional resulting available as an add-on.

Team, Game, and Player Props are all covered for each game, where available by law.
CBB prop markets are generally made available 48 to 24 hours before game time, depending on the preceding game calendar.

Props Plus

Pre-game props results are available 10-15 minutes following the conclusion of each game once all stats are verified.

Includes line movement is available for all Prop betting markets

Resulting: See our Betting Guide for available markets with resulting and how it works.
Line Movement: The Betting Guide also explains how to access the Betting Market endpoints to view an individual market's movement.

Futures

Team and Player Futures are all covered within the CBB Odds solution.
We are at the discretion of the sportsbooks as to when betting markets become available via their API delivery
CBB Team Futures begin to populate in April for the upcoming season and are regularly maintained until the conclusion of that next March Madness tournament
CBB Player Futures begin to populate in June for the upcoming season and are regularly maintained until the conclusion of that next March Madness tournament

Matchups, Trends, and Splits

Matchup Stats

Matchups and Trends leverage our vast historical database to calculate all the traditional information found on a betting match up page.

CBB Match Ups and Trends are run at the Team level and update regularly as each game occurs.

Betting Splits

Betting Splits provide the percentage of bets placed on either side of the line and the percentage of the money wagered on either side of the line.

CBB Betting Splits begin to populate shortly after Game lines are posted and action is taken by the sportsbooks. Betting Splits are available at the discretion of sportsbooks making the data available.

News & Images

Previews, Recaps, and Breaking News

Previews, Recaps, and Breaking News are available all year round.
Your SportsDataIO Client Manager can facilitate an introduction with appropriate news partners.
These feeds are accessed directly through partner sites and not SportsDataIO endpoints.

Player Headshots

Headshots are officially licensed in partnership with multiple licensed image providers and are updated leading up to the start of each season to capture new players and rookies being added as those images become available.

All of our headshots are cropped 1200x1200 pixels with 300 resolution.
Headshots are the property of the photographers that take them and the publishers that make them available, and as such we work with major providers to ensure that we have the best in licensed headshots.

College Basketball headshots are available through an integration with our partners. SportsDataIO's Client Management team can facilitate this introduction.
College Basketball headshots update in December each year.

Utility Endpoints

See our CBB API Documentation for all CBB utility endpoints.

{{jump_to.text}}