Playbook-API
  1. Core Endpoints
Playbook-API
  • Global
    • Overview
    • Base URL (Servers)
    • Authentication
    • Rate Limits + Usage
    • Errors
    • League / sportKey Conventions
    • Support
  • Core Endpoints
    • Health
      GET
    • Me
      GET
    • Teams
      GET
    • Team Stats
      GET
    • Injuries
      GET
    • Splits
      GET
    • Splits (Historical/History)
      GET
    • Odds-Games
      GET
    • Lines
      GET
    • Games
      GET
    • Recent Form
      GET
    • Head-to-Head
      GET
  • MLB
    • Pitcher Stats (Season)
      GET
    • Starting Pitchers
      GET
    • Ballpark Weather
      GET
    • Strikeout Predictor
      GET
  1. Core Endpoints

Team Stats

GET
https://api.playbook-api.com/v1/{league}/team-stats
Last modified:2026-02-26 04:57:36
Get Team Stats
Retrieve comprehensive season statistics for teams in NBA, NFL, NHL, or MLB.
Season-to-date stats updated nightly
League-wide ranks for every metric
Offensive, defensive, and derived statistics
Filter by specific team or get entire league
Supported Leagues
NBA (basketball)
NFL (football)
NHL (hockey)
MLB (baseball)
Example:
Team stats (entire league):
NBA: https://api.playbook-api.com/v1/nba/team-stats?api_key=YOUR_API_KEY
Team stats with filters:
By season:
https://api.playbook-api.com/v1/nba/team-stats?season=2025-26&api_key=YOUR_API_KEY
By teamId:
https://api.playbook-api.com/v1/nba/team-stats?teamId=OKC&api_key=YOUR_API_KEY
Rate Limiting
Costs 1 request unit (or 5 units if fetching entire league)

Request

Path Params

Query Params

Header Params

Responses

🟢200Success
application/json
Body

🟠404Not Found
🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.playbook-api.com/v1/nba/team-stats?split=season&season=2025-26&teamId=BOS' \
--header 'x-api-key: YOUR_API_KEY'
Response Response Example
200 - Example 1
{
    "league": "NBA",
    "season": "2025-26",
    "split": "season",
    "schemaVersion": "1.0",
    "source": "Playbook API",
    "lastUpdated": "2026-01-15T08:40:38.494Z",
    "count": 1,
    "teams": [
        {
            "team": {
                "id": "bos",
                "name": "Boston Celtics",
                "abbreviation": "BOS"
            },
            "meta": {
                "gp": 39
            },
            "stats": {
                "offense": {
                    "ppg": 116.6,
                    "fgm": 43.1,
                    "fga": 91.1,
                    "fgPct": 47.3,
                    "threePm": 15.7,
                    "threePa": 42.6,
                    "threePct": 36.8,
                    "ftm": 14.8,
                    "fta": 18.7,
                    "ftPct": 79,
                    "or": 12.6,
                    "dr": 31.9,
                    "reb": 44.5,
                    "ast": 23.8,
                    "stl": 7.9,
                    "blk": 5.3,
                    "tov": 11.1,
                    "fouls": 20.5
                },
                "defense": {
                    "ppgAllowed": 110.1,
                    "fgmAllowed": 38.8,
                    "fgaAllowed": 86.2,
                    "fgPctAllowed": 45,
                    "threePmAllowed": 14.4,
                    "threePaAllowed": 38.8,
                    "threePctAllowed": 37,
                    "ftmAllowed": 18.1,
                    "ftaAllowed": 22.8,
                    "ftPctAllowed": 79.4,
                    "orAllowed": 11.4,
                    "drAllowed": 30.3,
                    "rebAllowed": 41.7,
                    "astAllowed": 25.6,
                    "stlAllowed": 5.6,
                    "blkAllowed": 4.2,
                    "tovForced": 13,
                    "foulsDrawn": 18.4
                },
                "derived": {
                    "astTo": 2.14
                }
            },
            "ranks": {
                "offense": {
                    "ppg": "14",
                    "fgm": "9",
                    "fga": "T-4",
                    "fgPct": "T-9",
                    "threePm": "2",
                    "threePa": "2",
                    "threePct": "T-8",
                    "ftm": "30",
                    "fta": "30",
                    "ftPct": "T-12",
                    "or": "6",
                    "dr": "T-18",
                    "reb": "T-13",
                    "ast": "29",
                    "stl": "T-19",
                    "blk": "T-7",
                    "tov": "1",
                    "fouls": "T-16"
                },
                "defense": {
                    "ppgAllowed": "2",
                    "fgmAllowed": "3",
                    "fgaAllowed": "5",
                    "fgPctAllowed": "3",
                    "threePmAllowed": "T-25",
                    "threePaAllowed": "T-23",
                    "threePctAllowed": "23",
                    "ftmAllowed": "10",
                    "ftaAllowed": "T-8",
                    "ftPctAllowed": "21",
                    "orAllowed": "T-12",
                    "drAllowed": "5",
                    "rebAllowed": "5",
                    "astAllowed": "9",
                    "stlAllowed": "1",
                    "blkAllowed": "T-6",
                    "tovForced": "T-8",
                    "foulsDrawn": "2"
                },
                "derived": {
                    "astTo": "5"
                }
            }
        }
    ],
    "definitions": {
        "meta": {
            "gp": "Games played"
        },
        "offense": {
            "ppg": "Points per game",
            "fgm": "Field goals made per game",
            "fga": "Field goals attempted per game",
            "fgPct": "Field goal percentage",
            "threePm": "3-pointers made per game",
            "threePa": "3-pointers attempted per game",
            "threePct": "3-point percentage",
            "ftm": "Free throws made per game",
            "fta": "Free throws attempted per game",
            "ftPct": "Free throw percentage",
            "or": "Offensive rebounds per game",
            "dr": "Defensive rebounds per game",
            "reb": "Total rebounds per game",
            "ast": "Assists per game",
            "stl": "Steals per game",
            "blk": "Blocks per game",
            "tov": "Turnovers per game",
            "fouls": "Personal fouls per game"
        },
        "defense": {
            "ppgAllowed": "Opponent points per game",
            "fgmAllowed": "Opponent field goals made per game",
            "fgaAllowed": "Opponent field goals attempted per game",
            "fgPctAllowed": "Opponent field goal percentage",
            "threePmAllowed": "Opponent 3-pointers made per game",
            "threePaAllowed": "Opponent 3-pointers attempted per game",
            "threePctAllowed": "Opponent 3-point percentage",
            "ftmAllowed": "Opponent free throws made per game",
            "ftaAllowed": "Opponent free throws attempted per game",
            "ftPctAllowed": "Opponent free throw percentage",
            "orAllowed": "Opponent offensive rebounds per game",
            "drAllowed": "Opponent defensive rebounds per game",
            "rebAllowed": "Opponent total rebounds per game",
            "astAllowed": "Opponent assists per game",
            "stlAllowed": "Opponent steals per game",
            "blkAllowed": "Opponent blocks per game",
            "tovForced": "Opponent turnovers per game",
            "foulsDrawn": "Opponent personal fouls per game"
        },
        "derived": {
            "astTo": "Assist-to-turnover ratio"
        }
    },
    "disclaimer": "Team stats are compiled nightly by Playbook API from publicly available game results and team totals, then normalized into a consistent schema with ranks and derived metrics (season-to-date through the prior day). Playbook API is not affiliated with or endorsed by the league or any team."
}
Modified at 2026-02-26 04:57:36
Previous
Teams
Next
Injuries
Built with