nntrn / espn-wiki

Collection of nfl data fetching on espn

List of NFL API Endpoints

This page has been updated a lot in the past 2 years. It might be helpful to look at older revisions. View latest here

Additional Resources / Further Reading

• nfl-nerd
• ESPN's hidden API endpoints
• Using ESPN's new Fantasy API (v3)
• ESPN: Get Endpoint (CRAN Package)

Parameters

Name	Description
:YEAR	Integer year in which the season started (YYYY)
:SEASONTYPE	1=pre, 2=regular, 3=post, 4=off
:TEAM_ID	1-32 (view all)
:ATHLETE_ID	view all
:LEAGUE_ID	Fantasy league id
:BET_PROVIDER_ID	38=Caesars, 31=William Hill, 41=SugarHouse, 36=Unibet, 2000=Bet 365, 25=Westgate, 45=William Hill (NJ), 1001=accuscore, 1004=consensus, 1003=numberfire, 1002=teamrankings (view all)

---

Current:

• Athletes:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true

• Team (list of IDs):
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32

• Team (with more details):
  https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams

• Positions:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75

• Venues:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues?limit=700

• Leaders:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders?limit=100

• Seasons:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons?limit=100

• Franchises:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises?limit=50

• News:
  site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50

• Team News:
  site.api.espn.com/apis/site/v2/sports/football/nfl/news?team={TEAM_ID}
  (limit is incompatible with team filter)

Detailed:

• Scoreboard: cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50

• Schedule: cdn.espn.com/core/nfl/schedule?xhr=1&year={YEAR}&week={WEEK_NUM}

• Standings: cdn.espn.com/core/nfl/standings?xhr=1

• Boxscore: cdn.espn.com/core/nfl/boxscore?xhr=1&gameId={GAME_ID}

• Recap: cdn.espn.com/core/nfl/recap?xhr=1&gameId={GAME_ID}

• Plays: cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId={GAME_ID}

• Game: cdn.espn.com/core/nfl/game?xhr=1&gameId={GAME_ID}

• Matchup: cdn.espn.com/core/nfl/matchup?xhr=1&gameId={GAME_ID}

Odds:

• Win probabilities:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/probabilities?limit=200

• Odds:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/odds

• Matchup Quality & Game Projection:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/predictor

• Against-the-spread:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/2/teams/{TEAM_ID}/ats

• Futures:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/futures

• Head-to-head (game):
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/odds/{BET_PROVIDER_ID}/head-to-heads

• Odds records: (might encounter errors with older years)
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/0/teams/{TEAM_ID}/odds-records

• Game odds:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/odds/{BET_PROVIDER_ID}/history/0/movement?limit=100

• QBR Weekly/Game stats:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/2/weeks/{WEEK_NUM}/qbr/10000

• Past performances:
  get spread, over/under odds, moneyline
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/{TEAM_ID}/odds/{BET_PROVIDER_ID}/past-performances?limit=200

Teams:

• site.api.espn.com/apis/site/v2/sports/football/nfl/teams

• site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}

• sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams

• sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams/{TEAM_ID}

• Season Leaders:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/leaders

• Record:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/teams/{TEAM_ID}/record

• Depthcharts:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams/{TEAM_ID}/depthcharts

• Roster:
  site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}/roster

• Detailed Team:
  site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}?enable=roster,projection,stats

• Roster w/ stats:
  site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}?enable=roster

• Schedule:
  site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}/schedule?season={YEAR}

• Injuries:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/{TEAM_ID}/injuries

• Statistics:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/teams/{TEAM_ID}/statistics

• Past performance:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/{TEAM_ID}/odds/{BET_PROVIDER_ID}/past-performances?limit=140

• Projection:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams/{TEAM_ID}/projection

Games:

• Events:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events

• Game summary:
  site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event={EVENT_ID}

• Detailed plays:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{GAME_ID}/competitions/{GAME_ID}/plays?limit=300

• Probabilities (play): sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{GAME_ID}/competitions/{GAME_ID}/probabilities?limit=300

• Linescores: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{GAME_ID}/competitions/{GAME_ID}/competitors/{TEAM_ID}/linescores

• Scoring & All Splits: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{GAME_ID}/competitions/{GAME_ID}/competitors/{TEAM_ID}/statistics

• Roster (get starters):
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{GAME_ID}/competitions/{GAME_ID}/competitors/{TEAM_ID}/roster

• Weekly talent picks:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks/{WEEK_NUM}/talentpicks?limit=100

• Weekly event ids:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks/{WEEK_NUM}/events

• QBR Weekly/Game stats:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks/{WEEK_NUM}/qbr/10000?limit=100

• Game officials/judges:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{GAME_ID}/competitions/{GAME_ID}/officials

• Expected margin of victory & Team's predicted win percentage:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{GAME_ID}/competitions/{GAME_ID}/powerindex/{TEAM_ID}

Athletes:

• Current leaders:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders

• Leaders (year):
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/leaders

• Talent picks:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks

• Gamelog:
  site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/{ATHLETE_ID}/gamelog

• Coaches:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/coaches?limit=50

• Athletes:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes

• Player stats for each game:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/athletes/{ATHLETE_ID}/eventlog

• statisticslog:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/{ATHLETE_ID}/statisticslog

• Athlete Overview:
  site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/{ATHLETE_ID}/overview

• Free agents:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/freeagents

• Draft:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/draft

• Draft rounds:
  site.web.api.espn.com/apis/v2/scoreboard/header?draft_year={YEAR}&draft_round=1

Calendar:

• sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar

• sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays

• sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays

• sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist

• sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist

• All weeks in given season:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks

• Weeks:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks

• Season:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}

Scoreboard:

• Events in a season:
  site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=YYYY

• Events between dates: (cannot be >13 months)
  site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=YYYYMMDD-YYYYMMDD

• Events for a single day:
  site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=YYYYMMDD

• Season standing:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/groups/{CONFERENCE_ID}/standings

  • AFC (CONFERENCE_ID=8)
  • NFC (CONFERENCE_ID=7)

League:

• Transactions:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions

• Groups:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/groups

• Franchises:
  sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises

• Header:
  site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl

Fantasy:

• fantasy.espn.com/apis/v3/games/ffl

• site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=YYYYMMDD-YYYYMMDD

• fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/{LEAGUE_ID}

Search:

• site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix

• site.web.api.espn.com/apis/common/v3/search