1. NFL
Playbook-API
  • Global
    • Overview
    • Base URL (Servers)
    • Authentication
    • Rate Limits + Usage
    • Errors
    • League / sportKey Conventions
    • Support
  • Core Endpoints
    • Health
      GET
    • Me
      GET
    • Teams
      GET
    • Live Scores/Games
      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)
    • Starting Pitchers
    • Ballpark Weather
    • Strikeout Predictor
    • MLB Starting Pitchers
    • MLB Strikeout Predictor
    • MLB Pitcher Stats
    • MLB Ballpark Weather
  • NFL
    • Roster
      GET
    • NFL Team Stats
      GET
    • Team vs. Opponent
      GET
    • Player vs. Opponent
      GET
    • NFL Rosters
      GET
    • NFL Team Stats
      GET
    • NFL Team vs. Opponent
      GET
    • NFL Player vs. Opponent
      GET
    • NFL Stadiums
      GET
    • NFL IR & Reserve Moves
      GET
  • Games & odds
    • Games & IDs
    • Game Lines
    • Games
    • Live Games
  • Player props
    • Player Props
    • Player Prop Splits
  • Betting data
    • Betting Splits
    • Betting Splits History
    • Large Wagers
    • Large Wagers Summary
  • Injuries & teams
    • Injuries
    • Teams
    • Team Stats
  • Form & matchups
    • Recent Form
    • Head-to-Head
  • NBA
    • NBA Roster Moves
  • Account
    • Account & Usage
  • Schemas
    • Error
  1. NFL

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

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
API Key
Add parameter in query
api_key
Example:
api_key: ********************
or
Query Params

Responses

🟢200Success
application/json
Bodyapplication/json

Request 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' \
--header 'x-api-key: <api-key>'
Response 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
Previous
Team vs. Opponent
Next
NFL Rosters
Built with