NFL Team Stats

GET

https://api.playbook-api.com/v1/nfl/team-stats

Last modified:2026-07-17 00:48:03

Get NFL Team Statistics

Returns normalized season-level offensive statistics for an NFL team, plus
league rankings for full regular-season queries.

Seasons currently: 2023–2025. 2026/Current Season will be supported.
Rankings included automatically for full-season requests
Pass week_through for a partial-season cut — rankings are omitted and
individual metric ranks are returned as null

Example:
https://api.playbook-api.com/v1/nfl/team-stats?team=BUF&season=2025&season_type=regular

Request

Query Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.playbook-api.com/v1/nfl/team-stats?team=undefined&season=undefined&season_type=undefined&week_through=undefined'

Response Example

{
    "league": "NFL",
    "team": {
        "id": "BUF",
        "name": "Buffalo Bills"
    },
    "season": 2025,
    "seasonType": "REG",
    "weekThrough": 18,
    "gamesPlayed": 17,
    "partialSeason": false,
    "metrics": {
        "pointsPerGame": {
            "value": 28.3,
            "rank": 4,
            "label": "Points / Game",
            "format": {
                "type": "decimal"
            },
            "performanceDirection": "higher"
        },
        "completionRate": {
            "value": 0.671,
            "rank": 8,
            "label": "Completion Rate",
            "format": {
                "type": "percent",
                "scale": 100
            },
            "performanceDirection": "higher"
        },
        "rushRate": {
            "value": 0.478,
            "rank": null,
            "label": "Rush Rate",
            "format": {
                "type": "percent",
                "scale": 100
            },
            "performanceDirection": "neutral"
        }
    },
    "metricDefinitions": {},
    "ranking": {
        "population": 32,
        "scope": "NFL teams",
        "direction": "best_to_worst",
        "ties": "shared"
    },
    "meta": {
        "provider": "Playbook API",
        "dataset": "NFL Team Statistics",
        "definitionVersion": "nfl-team-stats-v1",
        "availableSeasons": [
            2023,
            2024,
            2025
        ],
        "freshness": {
            "datasetBuiltAt": "2026-07-16T15:25:30.074Z",
            "dataThrough": "2026-01-04",
            "weekThrough": 18
        }
    }
}

Modified at 2026-07-17 00:48:03

Roster

Team vs. Opponent