Seasonal Statistics (Player & Team)
This guide helps you access NCAA Women's Basketball (NCAAWB) seasonal and player career statistics. It also includes instructions for using the Daily Change Log endpoint to monitor post-game stat revisions.
Introduction to Seasonal Statistics
If you've explored integrating live game updates into your application, you may be familiar with the Game Summary endpoint, which provides game statistics in real-time. This guide focuses on accessing seasonal statistics — an aggregation of game statistics across a season — for both players and teams.
Note on Past Season Statistics
Past seasons may have fewer available statistics as new data points have been added more recently. Keep this in mind when accessing historical data.
Prerequisite - Accessing Available Seasons
To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.
For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.
Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.
Starting Year for Each Season
It's important to note that the
seasonparameter uses the starting year of the season; for example, to retrieve data for the 2024-25 NCAAWB season, you would use2024as the value for the season parameter.
How to Access Seasonal Statistics
You can access seasonal statistics using the Seasonal Statistics feed. This endpoint provides complete team and player seasonal statistics for a given season.
Data Availability
Our seasonal statistics date back to the year 2015, although availability can vary by player and team.
Accessing the Seasonal Statistics Feed:
- Get a team ID: You can access a list of all active teams in the NCAAWB API database with the Teams endpoint.
- Call the Seasonal Statistics feed: Using the team ID, you can retrieve seasonal statistics for that team — covering conference tournament (CT), regular season (REG), or postseason (PST) — by querying the Seasonal Statistics feed.
The call will retrieve seasonal statistics for the team and its individual players.
Recommended Pull Frequency:
- Seasonal stats are updated on a five-minute timer after a game is moved to
closed - To receive the fastest updates, call the feed five to ten minutes after a game is moved to
closed. - Otherwise, utilize this feed on an as needed basis.
- The TTL/Cache is 120 seconds.
Tip
Utilize the Daily Change Log endpoint to capture stat revisions after a game has ended. See the Daily Change Log section in this guide for more details.
Example - Retrieving Seasonal Stats for the Tennessee Lady Volunteers and Wolverines and Jewel Spear
This example shows a response from using the team ID 9ff241d6-0055-4dac-8741-f4e7bfe637b6 to access the 2024 regular season stats for the Tennessee Lady Volunteers and Jewel Spear.
Here are the team's seasonal stats to start:
{
"id": "9ff241d6-0055-4dac-8741-f4e7bfe637b6",
"name": "Lady Volunteers",
"market": "Tennessee",
"season": {
"id": "a263b759-0702-45fb-803a-b1c0651da16f",
"year": 2024,
"type": "REG"
},
"own_record": {
"total": {
"games_played": 34,
"minutes": 6800,
"field_goals_made": 1110,
"field_goals_att": 2528,
"field_goals_pct": 0.439,
"two_points_made": 767,
"two_points_att": 1474,
"two_points_pct": 0.52,
"three_points_made": 343,
"three_points_att": 1054,
"three_points_pct": 0.325,
"blocked_att": 84,
"free_throws_made": 382,
"free_throws_att": 561,
"free_throws_pct": 0.681,
"offensive_rebounds": 493,
"defensive_rebounds": 757,
"rebounds": 1250,
"assists": 529,
"turnovers": 473,
"assists_turnover_ratio": 1.12,
"steals": 385,
"blocks": 105,
"personal_fouls": 672,
"tech_fouls": 6,
"points": 2945,
"fast_break_pts": 587,
"flagrant_fouls": 0,
"points_off_turnovers": 975,
"second_chance_pts": 547,
"ejections": 0,
"foulouts": 5,
"efficiency": 3144,
"points_in_paint": 1386,
"team_offensive_rebounds": 80,
"team_defensive_rebounds": 45,
"team_rebounds": 125,
"team_turnovers": 12,
"total_rebounds": 1375,
"total_turnovers": 485,
"true_shooting_att": 2774.84,
"true_shooting_pct": 0.531,
"field_goals_at_rim_made": 179,
"field_goals_at_rim_att": 285,
"field_goals_at_rim_pct": 0.628,
"field_goals_at_midrange_made": 92,
"field_goals_at_midrange_att": 252,
"field_goals_at_midrange_pct": 0.365
},
"average": {
"fast_break_pts": 17.26,
"points_off_turnovers": 28.68,
"second_chance_pts": 16.09,
"minutes": 200,
"points": 86.6,
"off_rebounds": 14.5,
"def_rebounds": 22.26,
"rebounds": 36.76,
"assists": 15.6,
"steals": 11.32,
"blocks": 3.09,
"turnovers": 13.91,
"personal_fouls": 19.76,
"flagrant_fouls": 0,
"blocked_att": 2.47,
"field_goals_made": 32.65,
"field_goals_att": 74.35,
"three_points_made": 10.09,
"three_points_att": 31,
"free_throws_made": 11.24,
"free_throws_att": 16.5,
"two_points_made": 22.56,
"two_points_att": 43.35,
"points_in_paint": 40.76,
"efficiency": 92.47,
"true_shooting_att": 81.61
}
},
"opponents": {
"total": {
"games_played": 34,
"minutes": 6800,
"field_goals_made": 887,
"field_goals_att": 2025,
"field_goals_pct": 0.438,
"two_points_made": 720,
"two_points_att": 1453,
"two_points_pct": 0.496,
"three_points_made": 167,
"three_points_att": 572,
"three_points_pct": 0.292,
"blocked_att": 88,
"free_throws_made": 442,
"free_throws_att": 617,
"free_throws_pct": 0.716,
"offensive_rebounds": 284,
"defensive_rebounds": 805,
"rebounds": 1089,
"assists": 465,
"turnovers": 689,
"assists_turnover_ratio": 0.67,
"steals": 223,
"blocks": 106,
"personal_fouls": 567,
"tech_fouls": 5,
"points": 2383,
"fast_break_pts": 561,
"flagrant_fouls": 1,
"points_off_turnovers": 446,
"second_chance_pts": 381,
"ejections": 0,
"foulouts": 7,
"efficiency": 2264,
"points_in_paint": 1220,
"team_offensive_rebounds": 88,
"team_defensive_rebounds": 93,
"team_rebounds": 181,
"team_turnovers": 65,
"total_rebounds": 1270,
"total_turnovers": 754,
"true_shooting_att": 2296.48,
"true_shooting_pct": 0.519,
"field_goals_at_rim_made": 165,
"field_goals_at_rim_att": 278,
"field_goals_at_rim_pct": 0.594,
"field_goals_at_midrange_made": 99,
"field_goals_at_midrange_att": 312,
"field_goals_at_midrange_pct": 0.317
},
"average": {
"fast_break_pts": 16.5,
"points_off_turnovers": 13.12,
"second_chance_pts": 11.21,
"minutes": 200,
"points": 70.1,
"off_rebounds": 8.35,
"def_rebounds": 23.68,
"rebounds": 32.03,
"assists": 13.7,
"steals": 6.56,
"blocks": 3.12,
"turnovers": 20.26,
"personal_fouls": 16.68,
"flagrant_fouls": 0.03,
"blocked_att": 2.59,
"field_goals_made": 26.09,
"field_goals_att": 59.56,
"three_points_made": 4.91,
"three_points_att": 16.82,
"free_throws_made": 13,
"free_throws_att": 18.15,
"two_points_made": 21.18,
"two_points_att": 42.74,
"points_in_paint": 35.88,
"efficiency": 66.59,
"true_shooting_att": 67.54
}
}
}
This code sample provides detailed statistics for the Tennessee Lady Volunteers during the 2024 NCAA Women’s Basketball regular season. It includes metrics for both team and opponent performance, such as field goals made and attempted, shooting percentages, rebounds, assists, turnovers, and points in the paint. The data enables in-depth analysis of the Lady Volunteers’ offensive and defensive efficiency. For instance, Tennessee averaged over 86 points per game while allowing just over 70. The team posted a field goal percentage of 43.9%, while opponents shot 43.8%. These figures, along with breakdowns like second-chance points and points off turnovers, highlight key areas that contributed to the team’s success and outline where improvements can be made.
The image below demonstrates how you can visualize comprehensive college basketball team statistics for the Tennessee Volunteers in your application. It highlights key offensive metrics like points, rebounds, assists, and shooting percentages, alongside defensive stats such as opponent scoring and shooting efficiency. This well-rounded view enables users to evaluate team performance and compare offensive and defensive strengths throughout the season.
Team Seasonal Stats Use Case: By integrating team seasonal statistics, your application could feature updates on key NCAAWB metrics such as points scored, shooting percentages, rebounds, and defensive stats. This would enable fans, coaches, and analysts to track team performance throughout the season, strategize for future games, and make predictions based on comprehensive, real-time statistics like field goal percentages, turnovers, and opponent scoring.
Further analysis of the data reveals seasonal statistics for Jewel Spear:
{
"players": [
{
"id": "40c837ff-1382-4bb2-b7c3-ee17263b280c",
"full_name": "Jewel Spear",
"first_name": "Jewel",
"last_name": "Spear",
"position": "G",
"primary_position": "NA",
"jersey_number": "0",
"total": {
"games_played": 32,
"games_started": 25,
"minutes": 786,
"field_goals_made": 126,
"field_goals_att": 308,
"field_goals_pct": 0.409,
"two_points_made": 49,
"two_points_att": 105,
"two_points_pct": 0.467,
"three_points_made": 77,
"three_points_att": 203,
"three_points_pct": 0.379,
"blocked_att": 13,
"free_throws_made": 71,
"free_throws_att": 81,
"free_throws_pct": 0.877,
"offensive_rebounds": 27,
"defensive_rebounds": 62,
"rebounds": 89,
"assists": 56,
"turnovers": 35,
"assists_turnover_ratio": 1.6,
"steals": 29,
"blocks": 5,
"personal_fouls": 40,
"tech_fouls": 0,
"points": 400,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"true_shooting_att": 343.64,
"true_shooting_pct": 0.582,
"efficiency": 352,
"field_goals_at_rim_made": 13,
"field_goals_at_rim_att": 25,
"field_goals_at_rim_pct": 0.52,
"field_goals_at_midrange_made": 5,
"field_goals_at_midrange_att": 15,
"field_goals_at_midrange_pct": 0.333,
"usage_pct": 20.17
},
"average": {
"minutes": 24.6,
"points": 12.5,
"off_rebounds": 0.84,
"def_rebounds": 1.94,
"rebounds": 2.78,
"assists": 1.8,
"steals": 0.91,
"blocks": 0.16,
"turnovers": 1.09,
"personal_fouls": 1.25,
"flagrant_fouls": 0,
"blocked_att": 0.41,
"field_goals_made": 3.94,
"field_goals_att": 9.63,
"three_points_made": 2.41,
"three_points_att": 6.34,
"free_throws_made": 2.22,
"free_throws_att": 2.53,
"two_points_made": 1.53,
"two_points_att": 3.28,
"efficiency": 11,
"true_shooting_att": 10.74
}
}
]
}
This data sample provides a detailed look at Jewel Spear’s performance over 32 games. She made significant offensive contributions with 400 total points, including strong three-point shooting and an 87.7% free throw percentage. Her averages per game include 12.5 points, 2.8 rebounds, and 1.8 assists, with an overall shooting efficiency reflected by a 58.2% true shooting percentage. The data also includes advanced stats like usage rate (20.17%) and field goal breakdowns by shot type, offering a well-rounded view of her impact on both ends of the court.
Player Seasonal Stats Use Case: You can use this data to enhance a basketball-focused fantasy sports app by delivering real-time updates and in-depth statistical insights on players like Jewel Spear. With key performance metrics such as shooting efficiency, points, rebounds, assists, and usage rate, users can evaluate her overall impact on the court. This enables fantasy participants to make smarter decisions about roster changes and weekly matchups, backed by detailed trends like minutes played, shot selection, and per-game averages.
Accessing Player Career and Seasonal Statistics
You can also access both seasonal and career statistics for players via the Player Profile endpoint. This feed delivers player seasonal statistics for each season they have played, along with biographical details and draft information.
Note: For players who began their careers before the establishment of the API, some early career stats may not be available.
Accessing the Player Profile Feed:
- Get a Player ID: You can find player IDs using various endpoints, such as:
- Seasonal Statistics: Useful if you're already retrieving seasonal data and want comprehensive career statistics.
- Team Profile: Use this feed if you have a team ID and need player IDs. For a detailed guide on which feeds provide player data, check the NCAAWB API Map.
- Use the Player Profile Feed: Once you have a player ID, use it to access both seasonal and career statistics, providing a comprehensive overview of the player’s performance throughout their career.
Recommended Pull Frequency:
- The Player Profile feed is updated on a five minute timer after a game is moved to
closed - To receive the fastest updates, call the feed five to ten minutes after a game is moved to
closed. - Otherwise, utilize this feed on an as needed basis.
- The TTL/Cache is 120 seconds.
Example:
{
"id": "40c837ff-1382-4bb2-b7c3-ee17263b280c",
"status": "ACT",
"full_name": "Jewel Spear",
"first_name": "Jewel",
"last_name": "Spear",
"abbr_name": "J.Spear",
"height": 70,
"position": "G",
"primary_position": "NA",
"jersey_number": "0",
"experience": "SR",
"birth_place": "The Colony, TX, USA",
"updated": "2023-09-15T01:46:18Z",
"league": {
"id": "affab7b6-647e-4304-bbe2-1f9d68cd0cea",
"name": "NCAA WOMEN",
"alias": "NCAAW"
},
"team": {
"id": "9ff241d6-0055-4dac-8741-f4e7bfe637b6",
"name": "Lady Volunteers",
"market": "Tennessee",
"alias": "TENN"
},
"seasons": [
{
"id": "a263b759-0702-45fb-803a-b1c0651da16f",
"year": 2024,
"type": "REG",
"teams": [
{
"id": "9ff241d6-0055-4dac-8741-f4e7bfe637b6",
"name": "Lady Volunteers",
"market": "Tennessee",
"alias": "TENN",
"total": {
"games_played": 32,
"games_started": 25,
"minutes": 786,
"field_goals_made": 126,
"field_goals_att": 308,
"field_goals_pct": 0.409,
"two_points_made": 49,
"two_points_att": 105,
"two_points_pct": 0.467,
"three_points_made": 77,
"three_points_att": 203,
"three_points_pct": 0.379,
"blocked_att": 13,
"free_throws_made": 71,
"free_throws_att": 81,
"free_throws_pct": 0.877,
"offensive_rebounds": 27,
"defensive_rebounds": 62,
"rebounds": 89,
"assists": 56,
"turnovers": 35,
"assists_turnover_ratio": 1.6,
"steals": 29,
"blocks": 5,
"personal_fouls": 40,
"tech_fouls": 0,
"points": 400,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"true_shooting_att": 343.64,
"true_shooting_pct": 0.582,
"efficiency": 352,
"field_goals_at_rim_made": 13,
"field_goals_at_rim_att": 25,
"field_goals_at_rim_pct": 0.52,
"field_goals_at_midrange_made": 5,
"field_goals_at_midrange_att": 15,
"field_goals_at_midrange_pct": 0.333,
"usage_pct": 20.17
},
"average": {
"minutes": 24.6,
"points": 12.5,
"off_rebounds": 0.84,
"def_rebounds": 1.94,
"rebounds": 2.78,
"assists": 1.8,
"steals": 0.91,
"blocks": 0.16,
"turnovers": 1.09,
"personal_fouls": 1.25,
"flagrant_fouls": 0,
"blocked_att": 0.41,
"field_goals_made": 3.94,
"field_goals_att": 9.63,
"three_points_made": 2.41,
"three_points_att": 6.34,
"free_throws_made": 2.22,
"free_throws_att": 2.53,
"two_points_made": 1.53,
"two_points_att": 3.28,
"efficiency": 11,
"true_shooting_att": 10.74
}
}
]
},
{
"id": "3880629e-092d-42d4-a84a-a7c226754fa2",
"year": 2024,
"type": "PST",
"teams": [
{
"id": "9ff241d6-0055-4dac-8741-f4e7bfe637b6",
"name": "Lady Volunteers",
"market": "Tennessee",
"alias": "TENN",
"total": {
"games_played": 3,
"games_started": 3,
"minutes": 64,
"field_goals_made": 6,
"field_goals_att": 26,
"field_goals_pct": 0.231,
"two_points_made": 3,
"two_points_att": 13,
"two_points_pct": 0.231,
"three_points_made": 3,
"three_points_att": 13,
"three_points_pct": 0.231,
"blocked_att": 3,
"free_throws_made": 5,
"free_throws_att": 6,
"free_throws_pct": 0.833,
"offensive_rebounds": 2,
"defensive_rebounds": 5,
"rebounds": 7,
"assists": 5,
"turnovers": 4,
"assists_turnover_ratio": 1.25,
"steals": 1,
"blocks": 1,
"personal_fouls": 4,
"tech_fouls": 0,
"points": 20,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"true_shooting_att": 28.64,
"true_shooting_pct": 0.349,
"efficiency": 9,
"field_goals_at_rim_made": 0,
"field_goals_at_rim_att": 3,
"field_goals_at_rim_pct": 0,
"field_goals_at_midrange_made": 0,
"field_goals_at_midrange_att": 4,
"field_goals_at_midrange_pct": 0,
"usage_pct": 22.92
},
"average": {
"minutes": 21.3,
"points": 6.7,
"off_rebounds": 0.67,
"def_rebounds": 1.67,
"rebounds": 2.33,
"assists": 1.7,
"steals": 0.33,
"blocks": 0.33,
"turnovers": 1.33,
"personal_fouls": 1.33,
"flagrant_fouls": 0,
"blocked_att": 1,
"field_goals_made": 2,
"field_goals_att": 8.67,
"three_points_made": 1,
"three_points_att": 4.33,
"free_throws_made": 1.67,
"free_throws_att": 2,
"two_points_made": 1,
"two_points_att": 4.33,
"efficiency": 3,
"true_shooting_att": 9.55
}
}
]
}
]
}
The Player Profile data for Jewel Spear offers a detailed look at her performance with the Tennessee Lady Volunteers across the 2024 regular season and postseason. During the regular season, she played in 32 games (starting 25), contributing consistently in scoring, shooting from beyond the arc, and converting free throws at a high percentage. The profile highlights her shooting splits—two-pointers, three-pointers, and midrange—as well as advanced metrics like true shooting percentage, usage rate, and overall efficiency. In postseason play, while her shooting percentages dipped, she maintained steady contributions in minutes, assists, and rebounds.
Use Case:
When developing a college basketball application, you can leverage detailed player statistics to enhance scouting or recruitment tools for coaches and sports analysts. For instance, the app could feature a "Player Development Tracker" that visualizes a player's performance metrics across multiple seasons. This could include detailed stats such as shooting accuracy, rebounding, defensive contributions, and minutes played. Coaches and recruiters could use these insights to assess player growth, spot strengths or weaknesses, and make more informed decisions about player recruitment or game strategy adjustments.
Monitoring Seasonal Statistics with the Daily Change Log
The Daily Change Log is useful for monitoring adjustments to NCAAWB seasonal statistics. For instance, if a game statistic that affects seasonal totals is corrected, the log will record this update in its results node.
Steps:
- Identify Change Type: Spot any game IDs within the results node to signify changes in game-related data or statistics.
- Retrieve Detailed Data: Use the identified game IDs to pull additional details from relevant feeds such as Game Summary, Play-by-Play, or Game Boxscore, is recommended for its direct impact on seasonal statistics.
- Access the Seasonal Statistics feed: Use the team ID from the detailed data to retrieve information from the Seasonal Statistics feed.
- Verify Changes: Compare the newly retrieved data with previously stored records to confirm changes in statistics. Use the player ID to access the Player Profile feed for deeper analysis of player-specific updates.
Update Frequency
TTL / Cache: 300 seconds
Data Updates:
- Entries populate live for changes to teams, players, game statistics, schedules, and standings.
- Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC
Updated about 8 hours ago