NBA Team Stats

Last updated March 16, 2016

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

  1. nba

Format

  1. 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"
    }
  } ]
}