Seasonal Statistics (Player & Team)
This guide helps you access NBA seasonal statistics for players and teams, and career statistics for players. 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.
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 NBA 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 2013, 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 NBA API database with the Teams endpoint.
- Call the Seasonal Statistics feed: Using the team ID, you can retrieve seasonal statistics for that team — covering preseason (PRE), regular season (REG), or postseason (PST), In-Season Tournament (IST), or Play in Tournament (PIT) — by querying the Seasonal Statistics feed.
The call will retrieve seasonal statistics for the team, its opponents, 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 Dallas Mavericks and Greg Brown III
This example shows a response from using the team ID 583ecf50-fb46-11e1-82cb-f4ce4684ea4c to access the 2023 regular season stats for the Dallas Mavericks and Greg Brown.
Here are the team seasonal stats to start:
{
"id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Mavericks",
"market": "Dallas",
"sr_id": "sr:team:3411",
"reference": "1610612742",
"season": {
"id": "f1162fd1-29c5-4c29-abb4-57b78f16d238",
"year": 2023,
"type": "REG"
},
"own_record": {
"total": {
"games_played": 82,
"minutes": 19705,
"field_goals_made": 3535,
"field_goals_att": 7352,
"field_goals_pct": 0.481,
"two_points_made": 2338,
"two_points_att": 4110,
"two_points_pct": 0.569,
"three_points_made": 1197,
"three_points_att": 3242,
"three_points_pct": 0.369,
"blocked_att": 331,
"free_throws_made": 1397,
"free_throws_att": 1842,
"free_throws_pct": 0.758,
"offensive_rebounds": 797,
"defensive_rebounds": 2724,
"rebounds": 3521,
"assists": 2106,
"turnovers": 991,
"assists_turnover_ratio": 2.13,
"steals": 563,
"blocks": 406,
"personal_fouls": 1500,
"tech_fouls": 70,
"points": 9664,
"fast_break_pts": 1293,
"flagrant_fouls": 2,
"points_off_turnovers": 958,
"second_chance_pts": 763,
"ejections": 1,
"foulouts": 2,
"efficiency": 11007,
"points_in_paint": 3884,
"team_offensive_rebounds": 453,
"team_defensive_rebounds": 187,
"team_rebounds": 640,
"team_turnovers": 36,
"total_rebounds": 4161,
"total_turnovers": 1027,
"true_shooting_att": 8162.48,
"true_shooting_pct": 0.592,
"field_goals_at_rim_made": 1298,
"field_goals_at_rim_att": 1773,
"field_goals_at_rim_pct": 0.732,
"field_goals_at_midrange_made": 387,
"field_goals_at_midrange_att": 913,
"field_goals_at_midrange_pct": 0.424,
"points_in_paint_made": 1943,
"points_in_paint_att": 3188,
"points_in_paint_pct": 0.609,
"effective_fg_pct": 0.562,
"bench_points": 2934,
"fouls_drawn": 1667,
"offensive_fouls": 117,
"team_tech_fouls": 48,
"defensive_assists": 0,
"fast_break_att": 874,
"fast_break_made": 506,
"fast_break_pct": 0.579,
"technical_other": 0,
"coach_ejections": 0,
"points_against": 9483,
"second_chance_att": 792,
"second_chance_made": 410,
"second_chance_pct": 0.518,
"coach_tech_fouls": 0,
"team_fouls": 48,
"total_fouls": 1548,
"possessions": 8392.48,
"opponent_possessions": 8423.68,
"offensive_rating": 115.15,
"defensive_rating": 112.58,
"net_rating": 2.57
},
"average": {
"fast_break_pts": 15.77,
"points_off_turnovers": 11.68,
"second_chance_pts": 9.3,
"minutes": 240.3,
"points": 117.9,
"off_rebounds": 9.72,
"def_rebounds": 33.22,
"rebounds": 42.94,
"assists": 25.7,
"steals": 6.87,
"blocks": 4.95,
"turnovers": 12.09,
"personal_fouls": 18.29,
"flagrant_fouls": 0.02,
"blocked_att": 4.04,
"field_goals_made": 43.11,
"field_goals_att": 89.66,
"three_points_made": 14.6,
"three_points_att": 39.54,
"free_throws_made": 17.04,
"free_throws_att": 22.46,
"two_points_made": 28.51,
"two_points_att": 50.12,
"points_in_paint": 47.37,
"efficiency": 134.23,
"true_shooting_att": 99.54,
"points_in_paint_att": 38.88,
"points_in_paint_made": 23.7,
"bench_points": 35.78,
"fouls_drawn": 20.33,
"offensive_fouls": 1.43,
"fast_break_att": 10.66,
"fast_break_made": 6.17,
"second_chance_att": 9.66,
"second_chance_made": 5
}
},
"opponents": {
"total": {
"games_played": 82,
"minutes": 19705,
"field_goals_made": 3522,
"field_goals_att": 7413,
"field_goals_pct": 0.475,
"two_points_made": 2447,
"two_points_att": 4492,
"two_points_pct": 0.545,
"three_points_made": 1075,
"three_points_att": 2921,
"three_points_pct": 0.368,
"blocked_att": 406,
"free_throws_made": 1364,
"free_throws_att": 1772,
"free_throws_pct": 0.77,
"offensive_rebounds": 896,
"defensive_rebounds": 2800,
"rebounds": 3696,
"assists": 2258,
"turnovers": 1063,
"assists_turnover_ratio": 2.12,
"steals": 603,
"blocks": 331,
"personal_fouls": 1667,
"tech_fouls": 64,
"points": 9483,
"fast_break_pts": 1291,
"flagrant_fouls": 12,
"points_off_turnovers": 1010,
"second_chance_pts": 929,
"ejections": 3,
"foulouts": 11,
"efficiency": 11009,
"points_in_paint": 4184,
"team_offensive_rebounds": 491,
"team_defensive_rebounds": 213,
"team_rebounds": 704,
"team_turnovers": 64,
"total_rebounds": 4400,
"total_turnovers": 1127,
"true_shooting_att": 8192.68,
"true_shooting_pct": 0.579,
"field_goals_at_rim_made": 1335,
"field_goals_at_rim_att": 1866,
"field_goals_at_rim_pct": 0.715,
"field_goals_at_midrange_made": 349,
"field_goals_at_midrange_att": 864,
"field_goals_at_midrange_pct": 0.404,
"points_in_paint_made": 2091,
"points_in_paint_att": 3609,
"points_in_paint_pct": 0.579,
"effective_fg_pct": 0.548,
"bench_points": 3018,
"fouls_drawn": 1500,
"offensive_fouls": 187,
"team_tech_fouls": 35,
"defensive_assists": 0,
"fast_break_att": 816,
"fast_break_made": 483,
"fast_break_pct": 0.592,
"technical_other": 0,
"coach_ejections": 0,
"points_against": 9664,
"second_chance_att": 891,
"second_chance_made": 457,
"second_chance_pct": 0.513,
"coach_tech_fouls": 3,
"team_fouls": 38,
"total_fouls": 1705,
"possessions": 8423.68,
"opponent_possessions": 8392.48,
"offensive_rating": 112.58,
"defensive_rating": 115.15,
"net_rating": -2.57
},
"average": {
"fast_break_pts": 15.74,
"points_off_turnovers": 12.32,
"second_chance_pts": 11.33,
"minutes": 240.3,
"points": 115.6,
"off_rebounds": 10.93,
"def_rebounds": 34.15,
"rebounds": 45.07,
"assists": 27.5,
"steals": 7.35,
"blocks": 4.04,
"turnovers": 12.96,
"personal_fouls": 20.33,
"flagrant_fouls": 0.15,
"blocked_att": 4.95,
"field_goals_made": 42.95,
"field_goals_att": 90.4,
"three_points_made": 13.11,
"three_points_att": 35.62,
"free_throws_made": 16.63,
"free_throws_att": 21.61,
"two_points_made": 29.84,
"two_points_att": 54.78,
"points_in_paint": 51.02,
"efficiency": 134.26,
"true_shooting_att": 99.91,
"points_in_paint_att": 44.01,
"points_in_paint_made": 25.5,
"bench_points": 36.8,
"fouls_drawn": 18.29,
"offensive_fouls": 2.28,
"fast_break_att": 9.95,
"fast_break_made": 5.89,
"second_chance_att": 10.87,
"second_chance_made": 5.57
}
}
}
This code sample provides comprehensive team statistics for the Dallas Mavericks during the 2023 NBA regular season. It includes detailed metrics such as field goals made and attempted, three-point and free-throw percentages, rebounds, assists, turnovers, and more. The data allows for in-depth analysis of team performance, highlighting aspects like shooting efficiency (e.g., 48.1% field goal percentage), offensive productivity (e.g., 117.9 points per game), and defensive performance (e.g., 115.6 points allowed per game).
You could visualize this data in your application to display detailed NBA team statistics. The example showcases key metrics such as points scored (9,664), rebounds (3,521), assists (2,106), and shooting percentages (48.1% FG, 36.9% 3P, and 75.8% FT). It also includes defensive stats like opponent points (9,483), opponent field goal percentage (47.5%), and steals (563). This type of visual representation allows users to easily assess both offensive and defensive performances, facilitating quick comparisons and deeper analysis of team efficiency throughout the season.
Team Seasonal Stats Use Case: By integrating team seasonal statistics, your application could feature updates on key NBA 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 Greg Brown III:
{
"players": [
{
"id": "03258eec-a666-4b8f-86da-9bed8e91c39f",
"full_name": "Greg Brown III",
"first_name": "Greg",
"last_name": "Brown",
"position": "F",
"primary_position": "PF",
"name_suffix": "III",
"sr_id": "sr:player:2068597",
"reference": "1630535",
"total": {
"games_played": 6,
"games_started": 0,
"minutes": 40,
"field_goals_made": 5,
"field_goals_att": 11,
"field_goals_pct": 0.455,
"two_points_made": 4,
"two_points_att": 8,
"two_points_pct": 0.5,
"three_points_made": 1,
"three_points_att": 3,
"three_points_pct": 0.333,
"blocked_att": 1,
"free_throws_made": 4,
"free_throws_att": 9,
"free_throws_pct": 0.444,
"offensive_rebounds": 3,
"defensive_rebounds": 6,
"rebounds": 9,
"assists": 4,
"turnovers": 4,
"assists_turnover_ratio": 1,
"steals": 0,
"blocks": 4,
"personal_fouls": 5,
"tech_fouls": 0,
"points": 15,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"tech_fouls_non_unsportsmanlike": 0,
"true_shooting_att": 14.96,
"true_shooting_pct": 0.501,
"efficiency": 17,
"field_goals_at_rim_made": 4,
"field_goals_at_rim_att": 7,
"field_goals_at_rim_pct": 0.571,
"field_goals_at_midrange_made": 0,
"field_goals_at_midrange_att": 0,
"field_goals_at_midrange_pct": 0,
"usage_pct": 20.41,
"points_off_turnovers": 2,
"points_in_paint": 8,
"points_in_paint_made": 4,
"points_in_paint_att": 8,
"points_in_paint_pct": 0.5,
"effective_fg_pct": 0.5,
"double_doubles": 0,
"triple_doubles": 0,
"fouls_drawn": 5,
"offensive_fouls": 1,
"fast_break_pts": 7,
"fast_break_att": 5,
"fast_break_made": 3,
"fast_break_pct": 0.6,
"coach_ejections": 0,
"second_chance_pct": 0.5,
"second_chance_pts": 2,
"second_chance_att": 2,
"second_chance_made": 1,
"minus": 104,
"plus": 95,
"coach_tech_fouls": 0
},
"average": {
"minutes": 6.7,
"points": 2.5,
"off_rebounds": 0.5,
"def_rebounds": 1,
"rebounds": 1.5,
"assists": 0.7,
"steals": 0,
"blocks": 0.67,
"turnovers": 0.67,
"personal_fouls": 0.83,
"flagrant_fouls": 0,
"blocked_att": 0.17,
"field_goals_made": 0.83,
"field_goals_att": 1.83,
"three_points_made": 0.17,
"three_points_att": 0.5,
"free_throws_made": 0.67,
"free_throws_att": 1.5,
"two_points_made": 0.67,
"two_points_att": 1.33,
"efficiency": 2.83,
"true_shooting_att": 2.49,
"points_off_turnovers": 0.33,
"points_in_paint_made": 0.67,
"points_in_paint_att": 1.33,
"points_in_paint": 1.33,
"fouls_drawn": 0.83,
"offensive_fouls": 0.17,
"fast_break_pts": 1.17,
"fast_break_att": 0.83,
"fast_break_made": 0.5,
"second_chance_pts": 0.33,
"second_chance_att": 0.33,
"second_chance_made": 0.17
}
}
]
}
This data sample provides comprehensive statistics on Greg Brown III's performance over six games. It includes key metrics such as field goals made (5 out of 11 attempts), rebounds (9 total), blocks (4), and points scored (15). Additionally, it highlights his shooting percentages, including a 45.5% field goal percentage, 50% two-point percentage, and 33.3% from beyond the arc. The data also covers advanced metrics like usage rate (20.41%) and efficiency (17), providing an in-depth look at his contributions on both offense and defense, including fast break points, points in the paint, and second-chance points.
Player Seasonal Stats Use Case: You can use this data to enhance a basketball-focused fantasy sports app by offering users real-time updates and detailed statistical insights on players like Greg Brown III. With key performance metrics such as field goal percentage, points, rebounds, and blocks, users can track players' contributions to their fantasy teams. This data enables users to make informed decisions about lineup changes, player acquisitions, and overall strategy, providing a competitive edge through comprehensive player stats and trends.
Accessing Player Career and Seasonal Statistics
You can also access both seasonal and career statistics for players via the Player Profile feed. 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 NBA 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": "03258eec-a666-4b8f-86da-9bed8e91c39f",
"status": "FA",
"full_name": "Greg Brown III",
"first_name": "Greg",
"last_name": "Brown",
"abbr_name": "G.Brown",
"height": 79,
"weight": 206,
"position": "F",
"primary_position": "PF",
"experience": "2",
"college": "Texas",
"high_school": "Vandegrift (TX)",
"birth_place": "Dallas, TX, USA",
"birthdate": "2001-09-01",
"updated": "2024-07-01T04:38:48Z",
"name_suffix": "III",
"sr_id": "sr:player:2068597",
"rookie_year": 2021,
"reference": "1630535",
"league": {
"id": "4353138d-4c22-4396-95d8-5f587d2df25c",
"name": "NBA",
"alias": "NBA"
},
"draft": {
"team_id": "583ecc9a-fb46-11e1-82cb-f4ce4684ea4c",
"year": 2021,
"round": "2",
"pick": "43"
},
"seasons": [
{
"id": "f1162fd1-29c5-4c29-abb4-57b78f16d238",
"year": 2023,
"type": "REG",
"teams": [
{
"id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Mavericks",
"market": "Dallas",
"alias": "DAL",
"sr_id": "sr:team:3411",
"reference": "1610612742",
"total": {
"games_played": 6,
"games_started": 0,
"minutes": 40,
"field_goals_made": 5,
"field_goals_att": 11,
"field_goals_pct": 0.455,
"two_points_made": 4,
"two_points_att": 8,
"two_points_pct": 0.5,
"three_points_made": 1,
"three_points_att": 3,
"three_points_pct": 0.333,
"blocked_att": 1,
"free_throws_made": 4,
"free_throws_att": 9,
"free_throws_pct": 0.444,
"offensive_rebounds": 3,
"defensive_rebounds": 6,
"rebounds": 9,
"assists": 4,
"turnovers": 4,
"assists_turnover_ratio": 1,
"steals": 0,
"blocks": 4,
"personal_fouls": 5,
"tech_fouls": 0,
"points": 15,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"tech_fouls_non_unsportsmanlike": 0,
"true_shooting_att": 14.96,
"true_shooting_pct": 0.501,
"efficiency": 17,
"field_goals_at_rim_made": 4,
"field_goals_at_rim_att": 7,
"field_goals_at_rim_pct": 0.571,
"field_goals_at_midrange_made": 0,
"field_goals_at_midrange_att": 0,
"field_goals_at_midrange_pct": 0,
"usage_pct": 20.41,
"points_off_turnovers": 2,
"points_in_paint": 8,
"points_in_paint_made": 4,
"points_in_paint_att": 8,
"points_in_paint_pct": 0.5,
"effective_fg_pct": 0.5,
"double_doubles": 0,
"triple_doubles": 0,
"fouls_drawn": 5,
"offensive_fouls": 1,
"fast_break_pts": 7,
"fast_break_att": 5,
"fast_break_made": 3,
"fast_break_pct": 0.6,
"coach_ejections": 0,
"second_chance_pct": 0.5,
"second_chance_pts": 2,
"second_chance_att": 2,
"second_chance_made": 1,
"minus": 104,
"plus": 95,
"coach_tech_fouls": 0
},
"average": {
"minutes": 6.7,
"points": 2.5,
"off_rebounds": 0.5,
"def_rebounds": 1,
"rebounds": 1.5,
"assists": 0.7,
"steals": 0,
"blocks": 0.67,
"turnovers": 0.67,
"personal_fouls": 0.83,
"flagrant_fouls": 0,
"blocked_att": 0.17,
"field_goals_made": 0.83,
"field_goals_att": 1.83,
"three_points_made": 0.17,
"three_points_att": 0.5,
"free_throws_made": 0.67,
"free_throws_att": 1.5,
"two_points_made": 0.67,
"two_points_att": 1.33,
"efficiency": 2.83,
"true_shooting_att": 2.49,
"points_off_turnovers": 0.33,
"points_in_paint_made": 0.67,
"points_in_paint_att": 1.33,
"points_in_paint": 1.33,
"fouls_drawn": 0.83,
"offensive_fouls": 0.17,
"fast_break_pts": 1.17,
"fast_break_att": 0.83,
"fast_break_made": 0.5,
"second_chance_pts": 0.33,
"second_chance_att": 0.33,
"second_chance_made": 0.17
}
}
]
},
{
"id": "0d858257-7bc3-435d-9e54-1c8590be84ce",
"year": 2023,
"type": "PRE",
"teams": [
{
"id": "583ecf50-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Mavericks",
"market": "Dallas",
"alias": "DAL",
"sr_id": "sr:team:3411",
"reference": "1610612742",
"total": {
"games_played": 2,
"games_started": 0,
"minutes": 20,
"field_goals_made": 2,
"field_goals_att": 8,
"field_goals_pct": 0.25,
"two_points_made": 2,
"two_points_att": 7,
"two_points_pct": 0.286,
"three_points_made": 0,
"three_points_att": 1,
"three_points_pct": 0,
"blocked_att": 3,
"free_throws_made": 0,
"free_throws_att": 1,
"free_throws_pct": 0,
"offensive_rebounds": 2,
"defensive_rebounds": 5,
"rebounds": 7,
"assists": 0,
"turnovers": 1,
"assists_turnover_ratio": 0,
"steals": 0,
"blocks": 2,
"personal_fouls": 5,
"tech_fouls": 0,
"points": 4,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"true_shooting_att": 8.44,
"true_shooting_pct": 0.237,
"efficiency": 5,
"field_goals_at_rim_made": 2,
"field_goals_at_rim_att": 4,
"field_goals_at_rim_pct": 0.5,
"field_goals_at_midrange_made": 0,
"field_goals_at_midrange_att": 1,
"field_goals_at_midrange_pct": 0,
"usage_pct": 19.24,
"points_off_turnovers": 0,
"points_in_paint": 4,
"points_in_paint_made": 2,
"points_in_paint_att": 6,
"points_in_paint_pct": 0.333,
"effective_fg_pct": 0.25,
"double_doubles": 0,
"triple_doubles": 0,
"fouls_drawn": 1,
"offensive_fouls": 1,
"fast_break_pts": 0,
"fast_break_att": 0,
"fast_break_made": 0,
"fast_break_pct": 0,
"coach_ejections": 0,
"second_chance_pct": 0,
"second_chance_pts": 0,
"second_chance_att": 1,
"second_chance_made": 0,
"minus": 44,
"plus": 36,
"coach_tech_fouls": 0
},
"average": {
"minutes": 10,
"points": 2,
"off_rebounds": 1,
"def_rebounds": 2.5,
"rebounds": 3.5,
"assists": 0,
"steals": 0,
"blocks": 1,
"turnovers": 0.5,
"personal_fouls": 2.5,
"flagrant_fouls": 0,
"blocked_att": 1.5,
"field_goals_made": 1,
"field_goals_att": 4,
"three_points_made": 0,
"three_points_att": 0.5,
"free_throws_made": 0,
"free_throws_att": 0.5,
"two_points_made": 1,
"two_points_att": 3.5,
"efficiency": 2.5,
"true_shooting_att": 4.22,
"points_off_turnovers": 0,
"points_in_paint_made": 1,
"points_in_paint_att": 3,
"points_in_paint": 2,
"fouls_drawn": 0.5,
"offensive_fouls": 0.5,
"fast_break_pts": 0,
"fast_break_att": 0,
"fast_break_made": 0,
"second_chance_pts": 0,
"second_chance_att": 0.5,
"second_chance_made": 0
}
}
]
},
{
"id": "5027b6ac-731c-4622-8d69-d863ae7c626b",
"year": 2022,
"type": "REG",
"teams": [
{
"id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Trail Blazers",
"market": "Portland",
"alias": "POR",
"sr_id": "sr:team:3414",
"reference": "1610612757",
"total": {
"games_played": 16,
"games_started": 0,
"minutes": 93,
"field_goals_made": 11,
"field_goals_att": 28,
"field_goals_pct": 0.393,
"two_points_made": 10,
"two_points_att": 21,
"two_points_pct": 0.476,
"three_points_made": 1,
"three_points_att": 7,
"three_points_pct": 0.143,
"blocked_att": 4,
"free_throws_made": 5,
"free_throws_att": 12,
"free_throws_pct": 0.417,
"offensive_rebounds": 2,
"defensive_rebounds": 17,
"rebounds": 19,
"assists": 3,
"turnovers": 6,
"assists_turnover_ratio": 0.5,
"steals": 4,
"blocks": 5,
"personal_fouls": 13,
"tech_fouls": 0,
"points": 28,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"tech_fouls_non_unsportsmanlike": 0,
"true_shooting_att": 33.28,
"true_shooting_pct": 0.421,
"efficiency": 29,
"field_goals_at_rim_made": 10,
"field_goals_at_rim_att": 16,
"field_goals_at_rim_pct": 0.625,
"field_goals_at_midrange_made": 0,
"field_goals_at_midrange_att": 2,
"field_goals_at_midrange_pct": 0,
"usage_pct": 18.5,
"points_off_turnovers": 7,
"points_in_paint": 20,
"points_in_paint_made": 10,
"points_in_paint_att": 19,
"points_in_paint_pct": 0.526,
"effective_fg_pct": 0.411,
"double_doubles": 0,
"triple_doubles": 0,
"fouls_drawn": 7,
"offensive_fouls": 0,
"fast_break_pts": 6,
"fast_break_att": 4,
"fast_break_made": 3,
"fast_break_pct": 0.75,
"coach_ejections": 0,
"second_chance_pct": 0,
"second_chance_pts": 2,
"second_chance_att": 3,
"second_chance_made": 0,
"minus": 187,
"plus": 182,
"coach_tech_fouls": 0
},
"average": {
"minutes": 5.8,
"points": 1.8,
"off_rebounds": 0.13,
"def_rebounds": 1.06,
"rebounds": 1.19,
"assists": 0.2,
"steals": 0.25,
"blocks": 0.31,
"turnovers": 0.38,
"personal_fouls": 0.81,
"flagrant_fouls": 0,
"blocked_att": 0.25,
"field_goals_made": 0.69,
"field_goals_att": 1.75,
"three_points_made": 0.06,
"three_points_att": 0.44,
"free_throws_made": 0.31,
"free_throws_att": 0.75,
"two_points_made": 0.63,
"two_points_att": 1.31,
"efficiency": 1.81,
"true_shooting_att": 2.08,
"points_off_turnovers": 0.44,
"points_in_paint_made": 0.63,
"points_in_paint_att": 1.19,
"points_in_paint": 1.25,
"fouls_drawn": 0.44,
"offensive_fouls": 0,
"fast_break_pts": 0.38,
"fast_break_att": 0.25,
"fast_break_made": 0.19,
"second_chance_pts": 0.13,
"second_chance_att": 0.19,
"second_chance_made": 0
}
}
]
},
{
"id": "6ba5a3b2-e4e9-4b07-9026-6be2819b3006",
"year": 2022,
"type": "PRE",
"teams": [
{
"id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Trail Blazers",
"market": "Portland",
"alias": "POR",
"sr_id": "sr:team:3414",
"reference": "1610612757",
"total": {
"games_played": 5,
"games_started": 0,
"minutes": 49,
"field_goals_made": 7,
"field_goals_att": 14,
"field_goals_pct": 0.5,
"two_points_made": 6,
"two_points_att": 11,
"two_points_pct": 0.545,
"three_points_made": 1,
"three_points_att": 3,
"three_points_pct": 0.333,
"blocked_att": 1,
"free_throws_made": 12,
"free_throws_att": 18,
"free_throws_pct": 0.667,
"offensive_rebounds": 2,
"defensive_rebounds": 7,
"rebounds": 9,
"assists": 1,
"turnovers": 3,
"assists_turnover_ratio": 0.33,
"steals": 2,
"blocks": 1,
"personal_fouls": 6,
"tech_fouls": 2,
"points": 27,
"flagrant_fouls": 0,
"ejections": 1,
"foulouts": 0,
"tech_fouls_non_unsportsmanlike": 0,
"true_shooting_att": 21.92,
"true_shooting_pct": 0.616,
"efficiency": 24,
"field_goals_at_rim_made": 5,
"field_goals_at_rim_att": 7,
"field_goals_at_rim_pct": 0.714,
"field_goals_at_midrange_made": 0,
"field_goals_at_midrange_att": 1,
"field_goals_at_midrange_pct": 0,
"usage_pct": 22.2,
"points_off_turnovers": 9,
"points_in_paint": 12,
"points_in_paint_made": 6,
"points_in_paint_att": 10,
"points_in_paint_pct": 0.6,
"effective_fg_pct": 0.536,
"double_doubles": 0,
"triple_doubles": 0,
"fouls_drawn": 11,
"offensive_fouls": 1,
"fast_break_pts": 8,
"fast_break_att": 2,
"fast_break_made": 2,
"fast_break_pct": 1,
"coach_ejections": 0,
"second_chance_pct": 0.333,
"second_chance_pts": 4,
"second_chance_att": 3,
"second_chance_made": 1,
"minus": 119,
"plus": 83,
"coach_tech_fouls": 0
},
"average": {
"minutes": 9.8,
"points": 5.4,
"off_rebounds": 0.4,
"def_rebounds": 1.4,
"rebounds": 1.8,
"assists": 0.2,
"steals": 0.4,
"blocks": 0.2,
"turnovers": 0.6,
"personal_fouls": 1.2,
"flagrant_fouls": 0,
"blocked_att": 0.2,
"field_goals_made": 1.4,
"field_goals_att": 2.8,
"three_points_made": 0.2,
"three_points_att": 0.6,
"free_throws_made": 2.4,
"free_throws_att": 3.6,
"two_points_made": 1.2,
"two_points_att": 2.2,
"efficiency": 4.8,
"true_shooting_att": 4.38,
"points_off_turnovers": 1.8,
"points_in_paint_made": 1.2,
"points_in_paint_att": 2,
"points_in_paint": 2.4,
"fouls_drawn": 2.2,
"offensive_fouls": 0.2,
"fast_break_pts": 1.6,
"fast_break_att": 0.4,
"fast_break_made": 0.4,
"second_chance_pts": 0.8,
"second_chance_att": 0.6,
"second_chance_made": 0.2
}
}
]
},
{
"id": "16d6292c-25c6-4487-aa90-912c1e09170b",
"year": 2021,
"type": "REG",
"teams": [
{
"id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Trail Blazers",
"market": "Portland",
"alias": "POR",
"sr_id": "sr:team:3414",
"reference": "1610612757",
"total": {
"games_played": 48,
"games_started": 6,
"minutes": 640,
"field_goals_made": 81,
"field_goals_att": 190,
"field_goals_pct": 0.426,
"two_points_made": 62,
"two_points_att": 129,
"two_points_pct": 0.481,
"three_points_made": 19,
"three_points_att": 61,
"three_points_pct": 0.311,
"blocked_att": 18,
"free_throws_made": 44,
"free_throws_att": 65,
"free_throws_pct": 0.677,
"offensive_rebounds": 38,
"defensive_rebounds": 97,
"rebounds": 135,
"assists": 35,
"turnovers": 36,
"assists_turnover_ratio": 0.97,
"steals": 26,
"blocks": 24,
"personal_fouls": 90,
"tech_fouls": 1,
"points": 225,
"flagrant_fouls": 1,
"ejections": 0,
"foulouts": 1,
"tech_fouls_non_unsportsmanlike": 1,
"true_shooting_att": 218.6,
"true_shooting_pct": 0.515,
"efficiency": 279,
"field_goals_at_rim_made": 54,
"field_goals_at_rim_att": 88,
"field_goals_at_rim_pct": 0.614,
"field_goals_at_midrange_made": 1,
"field_goals_at_midrange_att": 11,
"field_goals_at_midrange_pct": 0.091,
"usage_pct": 17.35,
"points_off_turnovers": 41,
"points_in_paint": 120,
"points_in_paint_made": 60,
"points_in_paint_att": 115,
"points_in_paint_pct": 0.522,
"effective_fg_pct": 0.476,
"double_doubles": 0,
"triple_doubles": 0,
"fouls_drawn": 55,
"offensive_fouls": 4,
"fast_break_pts": 32,
"fast_break_att": 29,
"fast_break_made": 12,
"fast_break_pct": 0.414,
"coach_ejections": 0,
"second_chance_pct": 0.581,
"second_chance_pts": 42,
"second_chance_att": 31,
"second_chance_made": 18,
"minus": 1588,
"plus": 1347,
"coach_tech_fouls": 0
},
"average": {
"minutes": 13.3,
"points": 4.7,
"off_rebounds": 0.79,
"def_rebounds": 2.02,
"rebounds": 2.81,
"assists": 0.7,
"steals": 0.54,
"blocks": 0.5,
"turnovers": 0.75,
"personal_fouls": 1.88,
"flagrant_fouls": 0.02,
"blocked_att": 0.38,
"field_goals_made": 1.69,
"field_goals_att": 3.96,
"three_points_made": 0.4,
"three_points_att": 1.27,
"free_throws_made": 0.92,
"free_throws_att": 1.35,
"two_points_made": 1.29,
"two_points_att": 2.69,
"efficiency": 5.81,
"true_shooting_att": 4.55,
"points_off_turnovers": 0.85,
"points_in_paint_made": 1.25,
"points_in_paint_att": 2.4,
"points_in_paint": 2.5,
"fouls_drawn": 1.15,
"offensive_fouls": 0.08,
"fast_break_pts": 0.67,
"fast_break_att": 0.6,
"fast_break_made": 0.25,
"second_chance_pts": 0.88,
"second_chance_att": 0.65,
"second_chance_made": 0.38
}
}
]
},
{
"id": "e17d361d-40f3-4c6d-94a4-5551c6ceecc8",
"year": 2021,
"type": "PRE",
"teams": [
{
"id": "583ed056-fb46-11e1-82cb-f4ce4684ea4c",
"name": "Trail Blazers",
"market": "Portland",
"alias": "POR",
"sr_id": "sr:team:3414",
"reference": "1610612757",
"total": {
"games_played": 4,
"games_started": 0,
"minutes": 66,
"field_goals_made": 7,
"field_goals_att": 20,
"field_goals_pct": 0.35,
"two_points_made": 6,
"two_points_att": 12,
"two_points_pct": 0.5,
"three_points_made": 1,
"three_points_att": 8,
"three_points_pct": 0.125,
"blocked_att": 0,
"free_throws_made": 2,
"free_throws_att": 2,
"free_throws_pct": 1,
"offensive_rebounds": 4,
"defensive_rebounds": 21,
"rebounds": 25,
"assists": 0,
"turnovers": 2,
"assists_turnover_ratio": 0,
"steals": 1,
"blocks": 3,
"personal_fouls": 4,
"tech_fouls": 0,
"points": 17,
"flagrant_fouls": 0,
"ejections": 0,
"foulouts": 0,
"tech_fouls_non_unsportsmanlike": 0,
"true_shooting_att": 20.88,
"true_shooting_pct": 0.407,
"efficiency": 31,
"field_goals_at_rim_made": 6,
"field_goals_at_rim_att": 10,
"field_goals_at_rim_pct": 0.6,
"field_goals_at_midrange_made": 0,
"field_goals_at_midrange_att": 3,
"field_goals_at_midrange_pct": 0,
"usage_pct": 14.44,
"points_off_turnovers": 5,
"points_in_paint": 12,
"points_in_paint_made": 6,
"points_in_paint_att": 10,
"points_in_paint_pct": 0.6,
"effective_fg_pct": 0.375,
"double_doubles": 0,
"triple_doubles": 0,
"fouls_drawn": 3,
"offensive_fouls": 0,
"fast_break_pts": 4,
"fast_break_att": 2,
"fast_break_made": 2,
"fast_break_pct": 1,
"coach_ejections": 0,
"second_chance_pct": 0.571,
"second_chance_pts": 8,
"second_chance_att": 7,
"second_chance_made": 4,
"minus": 128,
"plus": 109,
"coach_tech_fouls": 0
},
"average": {
"minutes": 16.5,
"points": 4.3,
"off_rebounds": 1,
"def_rebounds": 5.25,
"rebounds": 6.25,
"assists": 0,
"steals": 0.25,
"blocks": 0.75,
"turnovers": 0.5,
"personal_fouls": 1,
"flagrant_fouls": 0,
"blocked_att": 0,
"field_goals_made": 1.75,
"field_goals_att": 5,
"three_points_made": 0.25,
"three_points_att": 2,
"free_throws_made": 0.5,
"free_throws_att": 0.5,
"two_points_made": 1.5,
"two_points_att": 3,
"efficiency": 7.75,
"true_shooting_att": 5.22,
"points_off_turnovers": 1.25,
"points_in_paint_made": 1.5,
"points_in_paint_att": 2.5,
"points_in_paint": 3,
"fouls_drawn": 0.75,
"offensive_fouls": 0,
"fast_break_pts": 1,
"fast_break_att": 0.5,
"fast_break_made": 0.5,
"second_chance_pts": 2,
"second_chance_att": 1.75,
"second_chance_made": 1
}
}
]
}
]
}
The Player Profile data for Greg Brown III offers an in-depth overview of his performance across multiple seasons, detailing various key statistics such as field goal percentage, rebounds, points, and blocks. For example, the profile includes data on Brown’s total field goals made, shooting accuracy from different zones, and contributions in defensive plays like blocks and steals. This level of granularity allows you to track Brown's development and contributions across seasons, providing valuable insights into his role and efficiency on the court.
You can display this data in tables representing a player's statistics by season, showing key stats like field goal percentage, and three-point average.
You can also create player profiles like the following to present a snapshot of seasonal statistics.
Use Case:
While building a fantasy basketball application, you can use such detailed statistics to enhance player analytics features, helping users make informed decisions when drafting players. For example, the application could include a "Player Performance Tracker" that visualizes a player's stats over various seasons, enabling users to spot trends in performance or assess the impact of injuries and team changes on a player's output. This would be a valuable tool for fantasy league participants aiming to optimize their draft strategies based on thorough statistical insights.
Taking Stats Further with Splits
Splits provide a more granular view of team and player performance by breaking down statistics across various categories like home vs. away games, wins vs. losses, or specific periods within a season. By analyzing these splits, you can uncover patterns and trends that aren't always visible in standard statistics, offering a more complete understanding of performance.
See our guide on accessing splits for more details.
Monitoring Seasonal Statistics with the Daily Change Log
The Daily Change Log is useful for monitoring adjustments to NBA seasonal statistics and splits. 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 and splits.
- Access Seasonal Statistics or Splits Feeds: Use the team ID from the detailed data to retrieve information from the seasonal statistics feed or one of the available split feeds.
- 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 1 month ago