NFL Depth Chart API + Change Alerts (All 32 Teams)

An NFL depth chart API that returns NFL depth charts as JSON for all 32 teams — scraped live from ESPN's public API with athlete names fully resolved — plus built-in fantasy football depth chart alerts: every run is diffed against the previous snapshot, and starter changes, depth order changes, and player adds/removals are emitted as alert rows (with optional webhook delivery).

What you get

• One row per (formation, position) for every team: full ordered player list with athlete IDs and resolved names, plus a convenience starter field.
• Change alerts between runs: starter_changed, order_changed, player_added, player_removed. First run per team silently seeds the snapshot (stored in a named key-value store), so alerts only reflect real changes. Schedule the actor (e.g. hourly) to get near-real-time alerts.
• No API key required. Clean, stable JSON — great for fantasy football tools, betting models, and sports dashboards.

Input

Field	Type	Default	Description
teams	array	[]	Team abbreviations to fetch (e.g. ["KC","SF"]). Empty = all 32.
webhook_url	string	""	Optional URL; change alerts are POSTed there as {"alerts": [...]}.
include_unchanged	boolean	true	If false, depth chart rows are only pushed for teams that changed.

Default input {} fetches everything.

Example depth chart row

{
  "type": "depthchart-row",
  "team_id": "12",
  "team_abbrev": "KC",
  "team_name": "Kansas City Chiefs",
  "formation": "3WR 1TE",
  "position_key": "qb",
  "position_name": "Quarterback",
  "position_abbrev": "QB",
  "players": [
    {"slot": 1, "athlete_id": "3139477", "name": "Patrick Mahomes"},
    {"slot": 2, "athlete_id": "4362887", "name": "Justin Fields"},
    {"slot": 3, "athlete_id": "4567747", "name": "Garrett Nussmeier"},
    {"slot": 4, "athlete_id": "4044111", "name": "Chris Oladokun"}
  ],
  "starter": "Patrick Mahomes",
  "fetched_at": "2026-09-03T03:25:40Z"
}

Example change alert row

{
  "type": "change-alert",
  "team_id": "22",
  "team_abbrev": "ARI",
  "position_abbrev": "WR",
  "change_kind": "order_changed",
  "old_value": ["Marvin Harrison Jr.", "Michael Wilson", "Zay Jones"],
  "new_value": ["Marvin Harrison Jr.", "Zay Jones", "Michael Wilson"],
  "detected_at": "2026-09-03T03:25:40Z"
}

Pricing (pay per event)

• depthchart-row: $0.0002 per position row
• change-alert: $0.0005 per detected change

Notes & disclaimer

• Athlete names are resolved via each team's roster feed; the rare athlete missing from the roster is emitted as id:<espn_athlete_id>.
• Unofficial. This actor uses ESPN's publicly accessible endpoints and is not affiliated with, endorsed by, or sponsored by ESPN or the NFL. Data accuracy and availability depend entirely on ESPN.

Keywords: nfl depth chart api, nfl depth charts json, fantasy football depth chart alerts, nfl starter changes, espn depth chart scraper.