Team vs. Opponent

GET

https://api.playbook-api.com/v1/nfl/team-vs-opponent

Last modified:2026-07-17 00:52:45

Get NFL Team vs. Opponent History

Returns historical team performance in games against a selected opponent,
newest meeting first.

Distinct from Head-to-Head: this endpoint is NFL-specific, keyed by
team/opponent, and returns per-game offensive stat lines plus a summary
computed from the full filtered set not just the games returned after
limit is applied.

Example:
https://api.playbook-api.com/v1/nfl/team-vs-opponent?team=BUF&opponent=MIA&since=2023&through=2025

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-vs-opponent?team=undefined&opponent=undefined&season=undefined&since=undefined&through=undefined&season_type=undefined&venue=undefined&limit=undefined'

Response Example

{
    "league": "NFL",
    "team": {
        "id": "BUF",
        "name": "Buffalo Bills"
    },
    "opponent": {
        "id": "MIA",
        "name": "Miami Dolphins"
    },
    "filters": {
        "season": null,
        "since": 2023,
        "through": 2025,
        "seasonType": "ALL",
        "venue": "ALL",
        "limit": 25
    },
    "seasonsIncluded": [
        2023,
        2024,
        2025
    ],
    "summary": {
        "games": 6,
        "wins": 5,
        "losses": 1,
        "ties": 0,
        "metrics": {
            "pointsPerGame": 29,
            "totalYardsPerGame": 367.667
        }
    },
    "meetings": [
        {
            "gameId": "45970-BUF@MIA",
            "season": 2025,
            "week": 10,
            "seasonType": "REG",
            "date": "2025-11-09",
            "homeTeam": "MIA",
            "awayTeam": "BUF",
            "teamVenue": "AWAY",
            "score": {
                "team": 13,
                "opponent": 30
            },
            "result": "L",
            "stats": {
                "totalYards": 376,
                "passYards": 306,
                "rushYards": 87,
                "yardsPerPlay": 5.2,
                "completionRate": 0.7,
                "passYardsPerAttempt": 7.7,
                "rushYardsPerAttempt": 4.1,
                "successRate": 0.44,
                "sackRateAllowed": 0.07,
                "rushRate": 0.35,
                "explosivePassRate": 0.1,
                "explosiveRunRate": 0.14,
                "deepAttemptRate": 0.15,
                "shortPassYac": 5.4
            }
        }
    ],
    "metricDefinitions": {},
    "meta": {
        "provider": "Playbook API",
        "dataset": "NFL Team vs. Opponent",
        "definitionVersion": "nfl-team-vs-opponent-v1",
        "freshness": {
            "datasetBuiltAt": "2026-07-16T15:25:30.074Z",
            "datasetDataThrough": "2026-02-08",
            "datasetWeekThrough": 22,
            "responseDataThrough": "2025-11-09",
            "responseWeekThrough": 10
        }
    }
}

Modified at 2026-07-17 00:52:45

NFL Team Stats

Player vs. Opponent