Player vs. Opponent

GET

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

Last modified:2026-07-17 00:56:55

Get NFL Player vs. Opponent History

Returns a player's validated historical appearances against an opponent,
including position-appropriate totals and per-game averages.

Workflow: get playerId from Roster endpoint, then pass that exact
value here.

Unlike Team vs. Opponent, the summary here is calculated from the meetings
actually returned after limit is applied.

Rate Limiting
Costs 4 request units

Example:
https://api.playbook-api.com/v1/nfl/player-vs-opponent?player_id=pbk_nfl_qb_josh_allen&opponent=MIA

Request

Query Params

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.playbook-api.com/v1/nfl/player-vs-opponent?player_id=undefined&opponent=undefined&season=undefined&since=undefined&through=undefined&season_type=undefined&venue=undefined&limit=undefined'

Response Example

{
    "league": "NFL",
    "player": {
        "playerId": "pbk_nfl_qb_josh_allen",
        "name": "Josh Allen",
        "position": "QB",
        "currentTeam": {
            "id": "BUF",
            "name": "Buffalo Bills"
        }
    },
    "opponent": {
        "id": "MIA",
        "name": "Miami Dolphins"
    },
    "filters": {
        "season": null,
        "since": null,
        "through": null,
        "seasonType": "ALL",
        "venue": "ALL",
        "limit": 25
    },
    "seasonsIncluded": [
        2023,
        2024,
        2025
    ],
    "summary": {
        "appearances": 6,
        "qualifyingGames": 6,
        "passing": {
            "completions": 139,
            "attempts": 189,
            "yards": 1572,
            "touchdowns": 15,
            "interceptions": 4,
            "sacks": 11,
            "yardsPerGame": 262,
            "touchdownsPerGame": 2.5
        },
        "rushing": {
            "attempts": 31,
            "yards": 149,
            "touchdowns": 1,
            "yardsPerGame": 24.8,
            "touchdownsPerGame": 0.2
        },
        "fumbles": {
            "total": 4,
            "lost": 2
        }
    },
    "meetings": [
        {
            "gameId": "45970-BUF@MIA",
            "season": 2025,
            "week": 10,
            "seasonType": "REG",
            "date": "2025-11-09",
            "teamAtGameTime": "BUF",
            "opponent": "MIA",
            "homeAway": "AWAY",
            "starter": true,
            "appearanceRecorded": true,
            "qualifyingAppearance": true,
            "participationBasis": "recorded_offensive_statistics",
            "recordStatus": "validated",
            "offensiveSnaps": 65,
            "stats": {
                "passing": {
                    "completions": 28,
                    "attempts": 40,
                    "yards": 306,
                    "touchdowns": 2,
                    "interceptions": 1,
                    "sacks": 3
                },
                "rushing": {
                    "attempts": 4,
                    "yards": 31,
                    "touchdowns": 0
                },
                "fumbles": {
                    "total": 1,
                    "lost": 1
                }
            }
        }
    ],
    "summaryDefinitions": {},
    "metricDefinitions": {},
    "enumDefinitions": {
        "homeAway": [
            "HOME",
            "AWAY"
        ],
        "recordStatus": [
            "validated",
            "validated_limited_participation",
            "potentially_incomplete"
        ],
        "participationBasis": [
            "recorded_offensive_statistics",
            "recorded_offensive_snaps",
            "starter_with_no_recorded_offensive_stats",
            "single_snap_with_no_recorded_offensive_stats",
            "starter_without_recorded_offensive_participation"
        ],
        "seasonType": [
            "REG",
            "POST"
        ]
    },
    "meta": {
        "provider": "Playbook API",
        "dataset": "NFL Player vs. Opponent",
        "definitionVersion": "nfl-player-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:56:55

Team vs. Opponent