Splits
Introduction to Splits
In the NBA, splits refer to the division of a player's or team's performance data into specific categories or time periods to analyze trends, patterns, or differences in performance. Splits can provide more granular insights into how a player or team performs under different conditions.
You can access splits using four feeds:
- Splits (Game): Detailed Team, Player, and Opponent game splits across various views including: Home Team, Loss, Vs Opponent, Overtime, Over 500, Road, Under 500, At Venue, and Wins.
- Splits (Hierarchy): Detailed Team, Player, and Opponent splits across each Conference and Division.
- Splits (In-Game): Detailed Team, Player, and Opponent in-game splits across various views including: Higher Field Goal Percentage, Less Personal Fouls, Less Rebounds, Less Turnovers, Lower Field Goal Percentage, More Personal Fouls, More Rebounds, More Turnovers, Over 100 Against, Over 100 For, Same Personal Fouls, Same Rebounds, Same Turnovers, Under 100 Against, and Under 100 For.
- Splits (Schedule): Detailed Team, Player, and Opponent splits across various schedule views including: Days of Rest (1, 2, or 3+), Day of the Week, Last 5, Last 10, By Month, and By Week.
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.
Accessing Splits
- Get a team ID: You can access a list of all active teams in the NBA API database with the Teams endpoint.
- Call one of our Split endpoints:
Recommended Pull Frequency
- Splits are updated around 5 minutes after a game is moved to
closed - Pull 5-10 mins after a game is moved to
closedto receive the quickest updates- Utilize the daily change log to capture data changes after a game has ended.
- The TTL/Cache is 120 seconds.
Example - Splits (Game):
{
"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"
},
"splits": [
{
"category": "home",
"own_record": {
"total": {
"games_played": 41,
"minutes": 9865,
"field_goals_made": 1749,
"field_goals_att": 3648,
"field_goals_pct": 0.479,
"two_points_made": 1155,
"two_points_att": 2062,
"two_points_pct": 0.56,
"three_points_made": 594,
"three_points_att": 1586,
"three_points_pct": 0.375,
"blocked_att": 172,
"free_throws_made": 774,
"free_throws_att": 1012,
"free_throws_pct": 0.765,
"offensive_rebounds": 422,
"defensive_rebounds": 1355,
"rebounds": 1777,
"assists": 1048,
"turnovers": 508,
"assists_turnover_ratio": 2.06,
"steals": 284,
"blocks": 208,
"personal_fouls": 781,
"tech_fouls": 45,
"points": 4866,
"fast_break_pts": 687,
"flagrant_fouls": 2,
"points_off_turnovers": 437,
"second_chance_pts": 392,
"ejections": 1,
"foulouts": 2,
"efficiency": 5538,
"points_in_paint": 1980,
"team_offensive_rebounds": 254,
"team_defensive_rebounds": 102,
"team_rebounds": 356,
"team_turnovers": 20,
"total_rebounds": 2133,
"total_turnovers": 528,
"true_shooting_att": 4093.28,
"true_shooting_pct": 0.594,
"field_goals_at_rim_made": 690,
"field_goals_at_rim_att": 942,
"field_goals_at_midrange_made": 160,
"field_goals_at_midrange_att": 423,
"points_in_paint_made": 991,
"points_in_paint_att": 1630,
"points_in_paint_pct": 0.608,
"effective_fg_pct": 0.561,
"bench_points": 1411,
"fouls_drawn": 898,
"offensive_fouls": 63,
"team_tech_fouls": 26,
"defensive_assists": 0,
"fast_break_att": 449,
"fast_break_made": 263,
"fast_break_pct": 0.586,
"technical_other": 0,
"coach_ejections": 0,
"points_against": 4717,
"second_chance_att": 415,
"second_chance_made": 203,
"second_chance_pct": 0.489,
"coach_tech_fouls": 0,
"team_fouls": 26,
"total_fouls": 807,
"possessions": 4199.279999999999,
"opponent_possessions": 4207.5199999999995
},
"average": {
"fast_break_pts": 16.76,
"points_off_turnovers": 10.66,
"second_chance_pts": 9.56,
"minutes": 240.6,
"points": 118.7,
"off_rebounds": 10.29,
"def_rebounds": 33.05,
"rebounds": 43.34,
"assists": 25.6,
"steals": 6.93,
"blocks": 5.07,
"turnovers": 12.39,
"personal_fouls": 19.05,
"flagrant_fouls": 0.05,
"blocked_att": 4.2,
"field_goals_made": 42.66,
"field_goals_att": 88.98,
"three_points_made": 14.49,
"three_points_att": 38.68,
"free_throws_made": 18.88,
"free_throws_att": 24.68,
"two_points_made": 28.17,
"two_points_att": 50.29,
"points_in_paint": 48.29,
"efficiency": 135.07,
"true_shooting_att": 99.84,
"points_in_paint_att": 39.76,
"points_in_paint_made": 24.17,
"bench_points": 34.41,
"fouls_drawn": 21.9,
"offensive_fouls": 1.54,
"fast_break_att": 10.95,
"fast_break_made": 6.41,
"second_chance_att": 10.12,
"second_chance_made": 4.95
}
},
"opponents": {
"total": {
"games_played": 41,
"minutes": 9865,
"field_goals_made": 1740,
"field_goals_att": 3685,
"field_goals_pct": 0.472,
"two_points_made": 1216,
"two_points_att": 2226,
"two_points_pct": 0.546,
"three_points_made": 524,
"three_points_att": 1459,
"three_points_pct": 0.359,
"blocked_att": 208,
"free_throws_made": 713,
"free_throws_att": 933,
"free_throws_pct": 0.764,
"offensive_rebounds": 445,
"defensive_rebounds": 1356,
"rebounds": 1801,
"assists": 1108,
"turnovers": 526,
"assists_turnover_ratio": 2.11,
"steals": 307,
"blocks": 172,
"personal_fouls": 898,
"tech_fouls": 36,
"points": 4717,
"fast_break_pts": 587,
"flagrant_fouls": 5,
"points_off_turnovers": 484,
"second_chance_pts": 413,
"ejections": 2,
"foulouts": 8,
"efficiency": 5414,
"points_in_paint": 2086,
"team_offensive_rebounds": 262,
"team_defensive_rebounds": 106,
"team_rebounds": 368,
"team_turnovers": 31,
"total_rebounds": 2169,
"total_turnovers": 557,
"true_shooting_att": 4095.52,
"true_shooting_pct": 0.576,
"field_goals_at_rim_made": 669,
"field_goals_at_rim_att": 926,
"field_goals_at_midrange_made": 170,
"field_goals_at_midrange_att": 423,
"points_in_paint_made": 1042,
"points_in_paint_att": 1791,
"points_in_paint_pct": 0.582,
"effective_fg_pct": 0.543,
"bench_points": 1527,
"fouls_drawn": 781,
"offensive_fouls": 99,
"team_tech_fouls": 19,
"defensive_assists": 0,
"fast_break_att": 388,
"fast_break_made": 217,
"fast_break_pct": 0.559,
"technical_other": 0,
"coach_ejections": 0,
"points_against": 4866,
"second_chance_att": 446,
"second_chance_made": 224,
"second_chance_pct": 0.502,
"coach_tech_fouls": 1,
"team_fouls": 20,
"total_fouls": 918,
"possessions": 4207.5199999999995,
"opponent_possessions": 4199.279999999999
},
"average": {
"fast_break_pts": 14.32,
"points_off_turnovers": 11.8,
"second_chance_pts": 10.07,
"minutes": 240.6,
"points": 115,
"off_rebounds": 10.85,
"def_rebounds": 33.07,
"rebounds": 43.93,
"assists": 27,
"steals": 7.49,
"blocks": 4.2,
"turnovers": 12.83,
"personal_fouls": 21.9,
"flagrant_fouls": 0.12,
"blocked_att": 5.07,
"field_goals_made": 42.44,
"field_goals_att": 89.88,
"three_points_made": 12.78,
"three_points_att": 35.59,
"free_throws_made": 17.39,
"free_throws_att": 22.76,
"two_points_made": 29.66,
"two_points_att": 54.29,
"points_in_paint": 50.88,
"efficiency": 132.05,
"true_shooting_att": 99.89,
"points_in_paint_att": 43.68,
"points_in_paint_made": 25.41,
"bench_points": 37.24,
"fouls_drawn": 19.05,
"offensive_fouls": 2.41,
"fast_break_att": 9.46,
"fast_break_made": 5.29,
"second_chance_att": 10.88,
"second_chance_made": 5.46
}
}
},
{
"category": "loss",
"own_record": {
"total": {
"games_played": 32,
"minutes": 7680,
"field_goals_made": 1269,
"field_goals_att": 2859,
"field_goals_pct": 0.444,
"two_points_made": 864,
"two_points_att": 1641,
"two_points_pct": 0.527,
"three_points_made": 405,
"three_points_att": 1218,
"three_points_pct": 0.333,
"blocked_att": 159,
"free_throws_made": 488,
"free_throws_att": 653,
"free_throws_pct": 0.747,
"offensive_rebounds": 327,
"defensive_rebounds": 963,
"rebounds": 1290,
"assists": 741,
"turnovers": 423,
"assists_turnover_ratio": 1.75,
"steals": 211,
"blocks": 124,
"personal_fouls": 583,
"tech_fouls": 29,
"points": 3431,
"fast_break_pts": 437,
"flagrant_fouls": 1,
"points_off_turnovers": 394,
"second_chance_pts": 312,
"ejections": 1,
"foulouts": 1,
"efficiency": 3619,
"points_in_paint": 1440,
"team_offensive_rebounds": 176,
"team_defensive_rebounds": 75,
"team_rebounds": 251,
"team_turnovers": 14,
"total_rebounds": 1541,
"total_turnovers": 437,
"true_shooting_att": 3146.32,
"true_shooting_pct": 0.545,
"field_goals_at_rim_made": 468,
"field_goals_at_rim_att": 684,
"field_goals_at_midrange_made": 145,
"field_goals_at_midrange_att": 363,
"points_in_paint_made": 720,
"points_in_paint_att": 1278,
"points_in_paint_pct": 0.563,
"effective_fg_pct": 0.515,
"bench_points": 1093,
"fouls_drawn": 610,
"offensive_fouls": 38,
"team_tech_fouls": 15,
"defensive_assists": 0,
"fast_break_att": 325,
"fast_break_made": 173,
"fast_break_pct": 0.532,
"technical_other": 0,
"coach_ejections": 0,
"points_against": 3941,
"second_chance_att": 318,
"second_chance_made": 151,
"second_chance_pct": 0.475,
"coach_tech_fouls": 0,
"team_fouls": 15,
"total_fouls": 598,
"possessions": 3256.3200000000006,
"opponent_possessions": 3256.56
},
"average": {
"fast_break_pts": 13.66,
"points_off_turnovers": 12.31,
"second_chance_pts": 9.75,
"minutes": 240,
"points": 107.2,
"off_rebounds": 10.22,
"def_rebounds": 30.09,
"rebounds": 40.31,
"assists": 23.2,
"steals": 6.59,
"blocks": 3.88,
"turnovers": 13.22,
"personal_fouls": 18.22,
"flagrant_fouls": 0.03,
"blocked_att": 4.97,
"field_goals_made": 39.66,
"field_goals_att": 89.34,
"three_points_made": 12.66,
"three_points_att": 38.06,
"free_throws_made": 15.25,
"free_throws_att": 20.41,
"two_points_made": 27,
"two_points_att": 51.28,
"points_in_paint": 45,
"efficiency": 113.09,
"true_shooting_att": 98.32,
"points_in_paint_att": 39.94,
"points_in_paint_made": 22.5,
"bench_points": 34.16,
"fouls_drawn": 19.06,
"offensive_fouls": 1.19,
"fast_break_att": 10.16,
"fast_break_made": 5.41,
"second_chance_att": 9.94,
"second_chance_made": 4.72
}
},
"opponents": {
"total": {
"games_played": 32,
"minutes": 7680,
"field_goals_made": 1465,
"field_goals_att": 2858,
"field_goals_pct": 0.513,
"two_points_made": 1018,
"two_points_att": 1720,
"two_points_pct": 0.592,
"three_points_made": 447,
"three_points_att": 1138,
"three_points_pct": 0.393,
"blocked_att": 124,
"free_throws_made": 564,
"free_throws_att": 724,
"free_throws_pct": 0.779,
"offensive_rebounds": 341,
"defensive_rebounds": 1161,
"rebounds": 1502,
"assists": 953,
"turnovers": 391,
"assists_turnover_ratio": 2.44,
"steals": 256,
"blocks": 159,
"personal_fouls": 610,
"tech_fouls": 24,
"points": 3941,
"fast_break_pts": 578,
"flagrant_fouls": 2,
"points_off_turnovers": 440,
"second_chance_pts": 334,
"ejections": 0,
"foulouts": 2,
"efficiency": 4867,
"points_in_paint": 1734,
"team_offensive_rebounds": 173,
"team_defensive_rebounds": 92,
"team_rebounds": 265,
"team_turnovers": 30,
"total_rebounds": 1767,
"total_turnovers": 421,
"true_shooting_att": 3176.56,
"true_shooting_pct": 0.62,
"field_goals_at_rim_made": 539,
"field_goals_at_rim_att": 707,
"field_goals_at_midrange_made": 145,
"field_goals_at_midrange_att": 342,
"points_in_paint_made": 866,
"points_in_paint_att": 1367,
"points_in_paint_pct": 0.634,
"effective_fg_pct": 0.591,
"bench_points": 1295,
"fouls_drawn": 583,
"offensive_fouls": 60,
"team_tech_fouls": 17,
"defensive_assists": 0,
"fast_break_att": 343,
"fast_break_made": 221,
"fast_break_pct": 0.644,
"technical_other": 0,
"coach_ejections": 0,
"points_against": 3431,
"second_chance_att": 329,
"second_chance_made": 188,
"second_chance_pct": 0.571,
"coach_tech_fouls": 0,
"team_fouls": 17,
"total_fouls": 627,
"possessions": 3256.56,
"opponent_possessions": 3256.3200000000006
},
"average": {
"fast_break_pts": 18.06,
"points_off_turnovers": 13.75,
"second_chance_pts": 10.44,
"minutes": 240,
"points": 123.2,
"off_rebounds": 10.66,
"def_rebounds": 36.28,
"rebounds": 46.94,
"assists": 29.8,
"steals": 8,
"blocks": 4.97,
"turnovers": 12.22,
"personal_fouls": 19.06,
"flagrant_fouls": 0.06,
"blocked_att": 3.88,
"field_goals_made": 45.78,
"field_goals_att": 89.31,
"three_points_made": 13.97,
"three_points_att": 35.56,
"free_throws_made": 17.63,
"free_throws_att": 22.63,
"two_points_made": 31.81,
"two_points_att": 53.75,
"points_in_paint": 54.19,
"efficiency": 152.09,
"true_shooting_att": 99.27,
"points_in_paint_att": 42.72,
"points_in_paint_made": 27.06,
"bench_points": 40.47,
"fouls_drawn": 18.22,
"offensive_fouls": 1.88,
"fast_break_att": 10.72,
"fast_break_made": 6.91,
"second_chance_att": 10.28,
"second_chance_made": 5.88
}
}
],
}
This code represents detailed data for the Dallas Mavericks basketball team during the 2023 regular season, broken down by splits.
Split Category Definitions
The table below defines split categories used across all endpoints, helping you understand their meaning within your data.
Splits (Game)
| Category | Definition |
|---|---|
home | Statistics for games played at the team's home arena. |
road | Statistics for games played away from the team's home arena (i.e., away games). |
win | Statistics for games that the team won. |
loss | Statistics for games that the team lost. |
opponent | Performance statistics based on different opponents faced during the season. |
over_500 | Statistics for games against teams with a winning record (teams with over 50% wins). |
under_500 | Statistics for games against teams with a losing record (teams with under 50% wins). |
venue | Specific statistics related to games played in certain venues. |
Splits (Hierarchy)
| Category | Definition |
|---|---|
conference | Refers to the NBA's two conferences, the Eastern and Western Conferences, grouping team stats based on games played against the Eastern and Western Conferences. |
division | Refers to smaller groups of teams within each conference. There are three divisions per conference in the NBA, and splits by division allow analysis of a team's performance against these specific team groupings. |
Splits (In-game)
| Category | Definition |
|---|---|
higher_fg_pct | Indicates games where the team had a higher field goal percentage compared to their opponent. |
less_personal_fouls | Indicates games where the team committed fewer personal fouls than their opponent. |
less_rebounds | Indicates games where the team had fewer rebounds than their opponent. |
less_turnovers | Indicates games where the team committed fewer turnovers than their opponent. |
lower_fg_pct | Indicates games where the team had a lower field goal percentage compared to their opponent. |
more_personal_fouls | Indicates games where the team committed more personal fouls than their opponent. |
more_rebounds | Indicates games where the team had more rebounds than their opponent. |
more_turnovers | Indicates games where the team committed more turnovers than their opponent. |
over_100_against | Indicates games where the opponent scored over 100 points. |
over_100_for | Indicates games where the team scored over 100 points. |
same_personal_fouls | Indicates games where the team committed the same number of personal fouls as their opponent. |
same_rebounds | Indicates games where the team had the same number of rebounds as their opponent. |
same_turnovers | Indicates games where the team committed the same number of turnovers as their opponent. |
under_100_against | Indicates games where the opponent scored under 100 points. |
under_100_for | Indicates games where the team scored under 100 points. |
Splits (Schedule)
| Category | Definition |
|---|---|
days_of_rest | Represents the number of days a team has rested between games. |
day_of_week | Indicates performance based on the specific day of the week a game was played (e.g., Monday, Tuesday). |
last_10 | Tracks the team's performance over the last 10 games. |
last_5 | Tracks the team's performance over the last 5 games. |
month | Represents the team's performance in a specific month of the season. |
week | Represents the team's performance during a specific week of the season. |
Use Cases
Incorporating splits into your application can significantly enhance the depth of analysis and offer valuable insights into team and player performance under different scenarios. Here are some examples of how split data can be useful:
-
Track Home vs. Away Performance: You can display how a team performs at home versus on the road. This insight helps fans predict outcomes for upcoming games based on location.
-
Analyze Player Performance with Rest: Use splits to show how a player performs based on the number of days of rest, helping coaches determine the best rotation strategies for maximizing player efficiency.
-
Opponent Strength Comparison: By breaking down performance against teams over or under .500, your application can highlight how well a team or player performs against stronger or weaker competition, useful for analysts making playoff predictions.
-
Impact of Game Scenarios: Provide insights into team performance when they score over 100 points or keep opponents under 100 points. This data can show critical winning trends and game strategies that lead to success.
These splits give users a more detailed look into team and player dynamics, enabling smarter decisions and richer sports analysis within your application.
Monitoring Revisions to Splits with the Daily Change Log
The Daily Change Log is useful for monitoring adjustments to NBA splits and statistics. For instance, if a game statistic that affects splits 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