get_snap_counts

5 creditsStats + aggregationPOST /v1/get_snap_counts

Data refreshed Nov 6, 2026 · changelog

Offensive, defensive, and special-teams snaps and shares by game or player

Use it when you are measuring playing time or usage: snaps and snap share per game by phase.

Parameters

game_idstringoptional: Game id, e.g. 2025_01_KC_BUF
player_idstringoptional: PFR player id (from search_players pfr_id)
teamstringoptional: Team code
seasonstring | numberoptional: Season year (with team or player)
weekintegeroptional: Week filter
limitintegeroptional: Max rows (default 200)

Notes

Over MCP, ask for it in plain English and the client calls get_snap_counts itself. Point any MCP client at https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.endzoneapi.com/v1/get_snap_counts \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "2025_01_KC_LAC",
  "limit": 5
}'

Response

json

{
  "filters": {
    "game_id": "2025_01_KC_LAC",
    "player_id": null,
    "team": null,
    "season": null,
    "week": null
  },
  "snap_counts": [
    {
      "game_id": "2025_01_KC_LAC",
      "season": 2025,
      "week": 1,
      "team": "KC",
      "opponent": "LAC",
      "player": "Trey Smith",
      "pfr_player_id": "SmitTr05",
      "position": "G",
      "offense_snaps": 61,
      "offense_pct": 1,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 4,
      "st_pct": 0.16
    },
    {
      "game_id": "2025_01_KC_LAC",
      "season": 2025,
      "week": 1,
      "team": "KC",
      "opponent": "LAC",
      "player": "Creed Humphrey",
      "pfr_player_id": "HumpCr00",
      "position": "C",
      "offense_snaps": 61,
      "offense_pct": 1,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 4,
      "st_pct": 0.16
    },
    {
      "game_id": "2025_01_KC_LAC",
      "season": 2025,
      "week": 1,
      "team": "KC",
      "opponent": "LAC",
      "player": "Patrick Mahomes",
      "pfr_player_id": "MahoPa00",
      "position": "QB",
      "offense_snaps": 61,
      "offense_pct": 1,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 0,
      "st_pct": 0
    }
  ],
  "count": 5,
  "note": "Snap counts are keyed by PFR player id (see pfr_id on search_players)."
}