Returns each team's core stats and their opponents' stats for latest available date or,
if specified, stats accumulated through yyyyMMdd
. Additionally, stats can be returned for
the regular season (default) or postseason. Core stats include field goals, three point field goals,
free throws, rebounds, assists, blocks, steals, and turnovers for per game averages and aggregate totals.
Tip
To retrieve final regular season stats for previous seasons without knowing the exact date the season finished,
specify a date that is easily past the typical mid-April finish date. For example,
GET /nba/team-stats/20130601.json?team_id=new-york-knicks
returns the New York Knicks final
regular season stats for the 2012-2013 NBA season. This would not return postseason stats because the
season_type
defaults to regular
if not specified.
URL
GET /sport/team-stats.format
GET /sport/team-stats/yyyyMMdd.format
Sport
- nba
Format
- json
Authorization
Required. A valid access token must be included in the header of the request.
Parameters
Name
| Required
| Description
|
team_id |
optional |
Return results for specified team_id only. The team_id is the full name of the team,
all lowercase with spaces replaced by dashes (e.g., boston‑celtics, portland‑trail‑blazers). Use
the Teams endpoint to return all active team_id values |
season_type |
optional |
Specify the season type for the statistics to be returned. Acceptable values
are regular and post . Defaults to regular if this parameter is not
specified |
Returned Values
Name
| Type
| Description
|
team_stats_date |
string |
Date of result using format yyyy‑MM‑dd |
sport |
string |
NBA |
games_played |
integer |
Number of games team has played |
won |
integer |
Number of games team has won |
lost |
integer |
Number of games team has lost |
stats |
object |
Basketball Team Stats for team |
stats_opponent |
object |
Basketball Team Stats for team's opponents |
Example Request
curl -H "Authorization: Bearer ACCESS_TOKEN" "https://erikberg.com/nba/team-stats.json?team_id=washington-wizards"
Example Result
{
"sport" : "NBA",
"team_stats_date" : "2013-11-28",
"team_stats" : [ {
"team" : {
"team_id" : "washington-wizards",
"abbreviation" : "WAS",
"active" : true,
"first_name" : "Washington",
"last_name" : "Wizards",
"conference" : "East",
"division" : "Southeast",
"site_name" : "Verizon Center",
"city" : "Washington",
"state" : "District of Columbia",
"full_name" : "Washington Wizards"
},
"games_played" : 15,
"won" : 7,
"lost" : 8,
"stats" : {
"points" : 1504,
"assists" : 366,
"turnovers" : 218,
"steals" : 141,
"blocks" : 60,
"rebounds" : 622,
"field_goals_attempted" : 1279,
"field_goals_made" : 572,
"three_point_field_goals_attempted" : 350,
"three_point_field_goals_made" : 135,
"free_throws_attempted" : 303,
"free_throws_made" : 225,
"defensive_rebounds" : 460,
"offensive_rebounds" : 162,
"personal_fouls" : 282,
"field_goals_made_per_game" : 38.133,
"field_goals_attempted_per_game" : 85.267,
"field_goals_made_per_game_string" : "38.1",
"field_goals_attempted_per_game_string" : "85.3",
"three_point_field_goals_made_per_game" : 9.0,
"three_point_field_goals_attempted_per_game" : 23.333,
"three_point_field_goals_made_per_game_string" : "9.0",
"three_point_field_goals_attempted_per_game_string" : "23.3",
"free_throws_made_per_game" : 15.0,
"free_throws_attempted_per_game" : 20.2,
"free_throws_made_per_game_string" : "15.0",
"free_throws_attempted_per_game_string" : "20.2",
"offensive_rebounds_per_game" : 10.8,
"defensive_rebounds_per_game" : 30.667,
"offensive_rebounds_per_game_string" : "10.8",
"defensive_rebounds_per_game_string" : "30.7",
"rebounds_per_game_string" : "41.5",
"assists_per_game_string" : "24.4",
"steals_per_game_string" : "9.4",
"blocks_per_game_string" : "4.0",
"turnovers_per_game_string" : "14.5",
"personal_fouls_per_game_string" : "18.8",
"points_per_game_string" : "100.3",
"rebounds_per_game" : 41.467,
"field_goal_percentage" : 0.447,
"three_point_percentage" : 0.386,
"free_throw_percentage" : 0.743,
"field_goal_percentage_string" : "44.7",
"three_point_field_goal_percentage_string" : "38.6",
"free_throw_percentage_string" : "74.3"
},
"stats_opponent" : {
"points" : 1520,
"assists" : 366,
"turnovers" : 252,
"steals" : 107,
"blocks" : 63,
"rebounds" : 660,
"field_goals_attempted" : 1237,
"field_goals_made" : 584,
"three_point_field_goals_attempted" : 356,
"three_point_field_goals_made" : 130,
"free_throws_attempted" : 306,
"free_throws_made" : 222,
"defensive_rebounds" : 501,
"offensive_rebounds" : 159,
"personal_fouls" : 297,
"field_goals_made_per_game" : 38.933,
"field_goals_attempted_per_game" : 82.467,
"field_goals_made_per_game_string" : "38.9",
"field_goals_attempted_per_game_string" : "82.5",
"three_point_field_goals_made_per_game" : 8.667,
"three_point_field_goals_attempted_per_game" : 23.733,
"three_point_field_goals_made_per_game_string" : "8.7",
"three_point_field_goals_attempted_per_game_string" : "23.7",
"free_throws_made_per_game" : 14.8,
"free_throws_attempted_per_game" : 20.4,
"free_throws_made_per_game_string" : "14.8",
"free_throws_attempted_per_game_string" : "20.4",
"offensive_rebounds_per_game" : 10.6,
"defensive_rebounds_per_game" : 33.4,
"offensive_rebounds_per_game_string" : "10.6",
"defensive_rebounds_per_game_string" : "33.4",
"rebounds_per_game_string" : "44.0",
"assists_per_game_string" : "24.4",
"steals_per_game_string" : "7.1",
"blocks_per_game_string" : "4.2",
"turnovers_per_game_string" : "16.8",
"personal_fouls_per_game_string" : "19.8",
"points_per_game_string" : "101.3",
"rebounds_per_game" : 44.0,
"field_goal_percentage" : 0.472,
"three_point_percentage" : 0.365,
"free_throw_percentage" : 0.725,
"field_goal_percentage_string" : "47.2",
"three_point_field_goal_percentage_string" : "36.5",
"free_throw_percentage_string" : "72.5"
}
} ]
}