Last active
October 31, 2025 04:15
-
Star
(582)
You must be signed in to star a gist -
Fork
(71)
You must be signed in to fork a gist
-
-
Save nntrn/ee26cb2a0716de0947a0a4e9a157bc1c to your computer and use it in GitHub Desktop.
Revisions
-
nntrn revised this gist
Sep 3, 2025 . 1 changed file with 4 additions and 0 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -21,6 +21,10 @@ This page has been updated a lot in the past 3 years. **Older revisions you migh - This page is limited to NFL endpoints but can be refashioned for other leagues (i.e. `/sports/football/leagues/nfl/` => `/sports/baseball/leagues/mlb/`) **List of ESPN leagues**: [API](https://sports.core.api.espn.com/v2/sports) | [Document](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e0b844e4d56d0b049747024a04bb7949c2d6c5d/extending-espn-api.md) [Games Today] *(for all sports)* [Games Today]: https://site.web.api.espn.com/apis/personalized/site/v2/guide/feed?limit=200 **Paramaters** - **{YEAR}**: Football season (`YYYY`) -
Aug 20, 2025 . 1 changed file with 5 additions and 11 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -2,17 +2,11 @@ This page has been updated a lot in the past 3 years. **Older revisions you might like more than this one:** - [**June 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/b99b9e0d2df72470fa622e2f76cecb0362111e9a) - list of endpoints for other sports/leagues (i.e. nba, nhl, mlb) - [**August 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce#league-history---get-all-historical-data) - get historical fantasy league data - [**September 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9#file-source-txt) - list of endpoints in plain text - [**May 2023**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/cd7462cd365e516d7499b43f027db4b8b1a2d6c0) - collapsed endpoint response examples - [**Mar 2025**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e2ba150912691a56c86097303784aa2ff843a6c/new.md) - endpoints from partners.api.espn.com **\*NEW\*** **Additional Resources** -
Aug 20, 2025 . 1 changed file with 302 additions and 270 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -2,11 +2,17 @@ This page has been updated a lot in the past 3 years. **Older revisions you might like more than this one:** - [**June 2021**] - list of endpoints for other sports/leagues (i.e. nba, nhl, mlb) - [**August 2021**] - get historical fantasy league data - [**September 2021**] - list of endpoints in plain text - [**May 2023**] - collapsed endpoint response examples - [**Mar 2025**] - endpoints from partners.api.espn.com **\*NEW\*** [**June 2021**]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/b99b9e0d2df72470fa622e2f76cecb0362111e9a [**August 2021**]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce#league-history---get-all-historical-data [**September 2021**]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9#file-source-txt [**May 2023**]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/cd7462cd365e516d7499b43f027db4b8b1a2d6c0 [**Mar 2025**]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e2ba150912691a56c86097303784aa2ff843a6c/new.md **Additional Resources** @@ -31,341 +37,342 @@ This page has been updated a lot in the past 3 years. **Older revisions you migh - **{FANTASY_LEAGUE_ID}**: Fantasy league id - **{BET_PROVIDER_ID}**: [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers?limit=100) ## Table of Contents - [Reference List](#reference-list) - [News](#news) - [Detailed](#detailed) - [Teams](#teams) - [Games](#games) - [Athletes](#athletes) - [Calendar](#calendar) - [Odds](#odds) - [Scoreboard](#scoreboard) - [Leagues](#leagues) - [Search](#search) - [Pick em challenges](#pick-em-challenges) - [Fantasy](#fantasy) - [Endpoints](#endpoints) ## Reference List Get list of ids - **Events**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates={YEAR}](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2023) Filter: [&seasontype=2&week=1] | [&seasontype=2] [&seasontype=2&week=1]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2023&seasontype=2&week=1 [&seasontype=2]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2021&seasontype=2 - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) - **Team**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32) - **Positions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75](https://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](https://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](https://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](https://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](https://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](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50) - **Team News** (limit is incompatible with team filter): [site.api.espn.com/apis/site/v2/sports/football/nfl/news?team={TEAM_ID}](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) ## News - **NFL news** [site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50) - **news with api links to event** [now.core.api.espn.com/v1/sports/news?limit=1000&sport=football](https://now.core.api.espn.com/v1/sports/news?limit=1000&sport=football) - :star: **news using playerId** [[view]][e1] [site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId={ATHLETE_ID}](https://site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=2977187) [e1]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c?permalink_comment_id=5200643#gistcomment-5200643 - **Search query** - max limit 100 [[view]][e2] [site.web.api.espn.com/apis/search/v2?limit=100&query={SEARCH_TERM}](https://site.web.api.espn.com/apis/search/v2?query=kupp&limit=100) [e2]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c?permalink_comment_id=5200298#gistcomment-5200298 - **Team news**: [site.api.espn.com/apis/site/v2/sports/football/nfl/news?team={TEAM_ID}](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) - **Contributor news**: [site.web.api.espn.com/apis/v2/flex?contributor=adam-schefter&limit=100&pubkey=contributor-page](https://site.web.api.espn.com/apis/v2/flex?contributor=adam-schefter&limit=100&pubkey=contributor-page) ## Detailed Get live updates (xhr=1) - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50](https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50) - **Schedule**: [cdn.espn.com/core/nfl/schedule?xhr=1&year={YEAR}&week={WEEK_NUM}](https://cdn.espn.com/core/nfl/schedule?xhr=1&year=2020&week=2) - **Standings**: [cdn.espn.com/core/nfl/standings?xhr=1](https://cdn.espn.com/core/nfl/standings?xhr=1) - **Boxscore**: [cdn.espn.com/core/nfl/boxscore?xhr=1&gameId={EVENT_ID}](https://cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=401220225) - **Recap**: [cdn.espn.com/core/nfl/recap?xhr=1&gameId={EVENT_ID}](https://cdn.espn.com/core/nfl/recap?xhr=1&gameId=401220225) - **Plays**: [cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId={EVENT_ID}](https://cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=401220225) - **Game**: [cdn.espn.com/core/nfl/game?xhr=1&gameId={EVENT_ID}](https://cdn.espn.com/core/nfl/game?xhr=1&gameId=401127922) - **Matchup**: [cdn.espn.com/core/nfl/matchup?xhr=1&gameId={EVENT_ID}](https://cdn.espn.com/core/nfl/matchup?xhr=1&gameId=401220225) ## Teams - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams/{TEAM_ID}/athletes?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/18/athletes?limit=200) - **Team Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams/{TEAM_ID}/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/events) - **List of NFL Teams (with id,logo,name)**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) - **Team**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/1) - **Teams (Season)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams) - **Team (season)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams/{TEAM_ID}](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) - **Current Leaders**: [site.web.api.espn.com/apis/site/v3/sports/football/nfl/teamleaders](https://site.web.api.espn.com/apis/site/v3/sports/football/nfl/teamleaders) - **Season Leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/leaders](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) - **Record**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/teams/{TEAM_ID}/record](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/2/teams/6/record) - **Depthcharts**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/teams/{TEAM_ID}/depthcharts](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts) - **Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}/roster](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/roster) - :star: **Detailed Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}?**enable=roster,projection,stats**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4?enable=roster,projection,stats) - **Schedule**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{TEAM_ID}/schedule](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule)[`?season=`{YEAR}](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule?season=2019) - **Injuries**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/{TEAM_ID}/injuries](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/injuries?limit=100) - **Statistics**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/teams/{TEAM_ID}/statistics](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/24/statistics) - **Past performance**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/{TEAM_ID}/odds/{BET_PROVIDER_ID}/past-performances?limit=140](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/odds/1002/past-performances?limit=140) - **Projection** (not valid for past seasons): [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/{TEAM_ID}/projection](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/23/projection) - **Season standing**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/groups/{CONFERENCE_ID}/standings](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) [AFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) (CONFERENCE_ID=8) [NFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7/standings) (CONFERENCE_ID=7) ## Games - :star: **Summary**: 1 => [site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event={EVENT_ID}](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) 2 => [site.web.api.espn.com/apis/site/v2/sports/football/nfl/summary?event={EVENT_ID}](https://site.web.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401671808) - **Events**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events - **Play by Plays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/plays?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300) - **Get events with plays**: [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=YYYYMMDD-YYYYMMDD&pbpOnly=true](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20200901-20210228&pbpOnly=true) - **Drives**: plays, drive start/end times, and total offensive plays [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/drives](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401548411/competitions/401548411/drives) - **Play probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/probabilities?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=300) - **Linescores**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/competitors/{TEAM_ID}/linescores](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/linescores) - **Records**: Record Year To Date as of Event (wins, losses, streaks, etc) [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/competitors/{TEAM_ID}/records](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401548411/competitions/401548411/competitors/10/records) - **Scoring & All Splits**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/competitors/{TEAM_ID}/statistics](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/statistics) - **Roster (get starters)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/competitors/{TEAM_ID}/roster](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220225/competitions/401220225/competitors/12/roster) - **Weekly talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks/{WEEK_NUM}/talentpicks?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/talentpicks?limit=100) - **Weekly event ids**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks/{WEEK_NUM}/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000?limit=100) - **Game officials/judges**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/officials](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/officials) - **Expected margin of victory & predicted win percentage**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/powerindex/{TEAM_ID}](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30) ## Athletes - :star: **Splits**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/{ATHLETE_ID}/splits](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits) - **Get all active player ids**: https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?limit=20000&active=true - **Player stats for event**: - **Eventlog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/athletes/{ATHLETE_ID}/eventlog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog) - **Event stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/competitors/{TEAM_ID}/roster/{ATHLETE_ID}/statistics/0](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640/competitors/10/roster/14876/statistics/0) - **Current leaders**: https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) - **Talent picks**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks - :star: **Gamelog**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/{ATHLETE_ID}/gamelog](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog) - **Coaches**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/coaches?limit=50](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/coaches?limit=50) - **Athletes v2**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes - **Athletes v3**: https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?limit=1000 - **Player stats for each game**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/athletes/{ATHLETE_ID}/eventlog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog) - **statisticslog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/{ATHLETE_ID}/statisticslog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2576336/statisticslog) - :star: **Athlete Overview**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/{ATHLETE_ID}/overview](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/overview) - **Free agents**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/freeagents](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/freeagents) - **Draft**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/draft](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft) - **Draft rounds**: [site.web.api.espn.com/apis/v2/scoreboard/header?draft_year={YEAR}&draft_round=1](https://site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=2023&draft_round=1) ## Calendar - **Get all Monday games**: https://site.api.espn.com/apis/site/v2/mondaynightfootball - **Get all Thursday games**: https://site.api.espn.com/apis/site/v2/thursdaynightfootball - **Get all Sunday games**: https://site.api.espn.com/apis/site/v2/sundaynightfootball - **Ondays**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays - **Offdays**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays - **Blacklist**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist - **Whitelist dates**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist - **Weeks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks) - **Rankings, events, and talentpicks for week**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/{SEASONTYPE}/weeks/{WEEKNUM}](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1) - **Season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021) ## Odds - https://site.web.api.espn.com/apis/v3/sports/football/nfl/odds - **Win probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/probabilities?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200) - **Odds**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/odds](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds) - **Matchup Quality & Game Projection**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/{EVENT_ID}/competitions/{EVENT_ID}/predictor](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/predictor) - **Against-the-spread**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/types/2/teams/{TEAM_ID}/ats](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/teams/26/ats) - **Futures**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/{YEAR}/futures](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/0/teams/4/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200) ## Scoreboard - **Day**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20181213) - **Week**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYY**&seasontype={SEASONTYPE}&week={WEEKNUM}](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2018&seasontype=2&week=1) - **Year**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYY**&seasontype=2](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2018&seasontype=2) @@ -386,35 +393,30 @@ Get live updates (xhr=1) ## Leagues - **Transactions**: https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4/groups) - **Franchises**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises - **Header**: https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl ## Search - https://site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix - https://site.web.api.espn.com/apis/common/v3/search ## Pick em challenges > Parameters > > - {USER_GAME_ID} > - {GROUP_ID} > - {CHALLENGE_ID} and {CHALLENGE_NAME} > - {VIEW_NAME} > - :star: allon > - :star: chui_default > - chui_default_group @@ -423,51 +425,52 @@ Get live updates (xhr=1) > - chui_pagetype_group_picks > - pagetype_leaderboard - **Challenges**: https://gambit-api.fantasy.espn.com/apis/v1/challenges - **Scoring**: [gambit-api.fantasy.espn.com/apis/v1/challenges/{CHALLENGE_NAME}?scoringPeriodId={WEEKNUM}&view={VIEW_NAME}](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023?scoringPeriodId=3&platform=chui&view=allon) - **Group**: [gambit-api.fantasy.espn.com/apis/v1/challenges/{CHALLENGE_NAME}/groups/{GROUP_ID}?view={VIEW_NAME}](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-win-totals-2023/groups/3ea0845b-59d5-499b-97a0-2eb9d02e1cc9?view=allon&platform=chui) - :star: **User** [gambit-api.fantasy.espn.com/apis/v1/challenges/{CHALLENGE_NAME}/entries/{USER_GAME_ID}?view={VIEW_NAME}](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023/entries/ac079fc0-4d4f-11ee-96d2-37e637e51967?platform=chui&view=chui_default) - **Leaderboard**: [gambit-api.fantasy.espn.com/apis/v1/challenges/{CHALLENGE_NAME}/leaderboard?view={VIEW_NAME}](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023/leaderboard?view=pagetype_leaderboard&platform=chui) - **Propositions**: [gambit-api.fantasy.espn.com/apis/v1/propositions?challengeId={CHALLENGE_ID}&view={VIEW_NAME}](https://gambit-api.fantasy.espn.com/apis/v1/propositions?challengeId=230&platform=chui&view=chui_default) ## Fantasy > **v3 header:** > `X-Fantasy-Filter: {"players":{"limit":2000},"filterActive":{"value":true}}` - **Current season**: https://fantasy.espn.com/apis/v3/games/ffl * **Players**: https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?view=players_wl - [&view=mTeam&view=mRoster&view=mMatchup&view=mSettings](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/players?view=mTeam&view=mRoster&view=mMatchup&view=mSettings) * **Private league**: [fantasy.espn.com/apis/v3/games/ffl/seasons/{YEAR}/segments/0/leagues/{FANTASY_LEAGUE_ID}](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mRoster) - season < 2018: [fantasy.espn.com/apis/v3/games/ffl/leagueHistory/{FANTASY_LEAGUE_ID}?seasonId={YEAR}](https://fantasy.espn.com/apis/v3/games/ffl/leagueHistory/1241838?seasonId=2018&view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mRoster) - season > 2018: [fantasy.espn.com/apis/v3/games/ffl/seasons/{YEAR}/segments/0/leagues/{FANTASY_LEAGUE_ID}](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mRoster) - **Games (v2)**: [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=**YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210913&pbpOnly=true) - [dates=**YYYYMMDD-YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108) ### Curl Fantasy Filters - **Get % owned for players**: [fantasy.espn.com/apis/v3/games/ffl/seasons/{YEAR}/players?scoringPeriodId=0&view=players_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?scoringPeriodId=0&view=players_wl) ```sh curl -H 'X-Fantasy-Filter: {"filterActive":{"value":true}}' <URL> @@ -479,7 +482,7 @@ Get live updates (xhr=1) *** - :star: **Get player info**: [fantasy.espn.com/apis/v3/games/ffl/seasons/{YEAR}/segments/0/leaguedefaults/{PPR_ID}?view=kona_player_info](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/segments/0/leaguedefaults/3?view=kona_player_info) ```sh curl -H 'X-Fantasy-Filter: {"players":{"limit":2000,"sortPercOwned":{"sortPriority":4,"sortAsc":false}}}' <URL> @@ -491,7 +494,7 @@ Get live updates (xhr=1) *** - **Get bye week for all teams**: [fantasy.espn.com/apis/v3/games/ffl/seasons/{YEAR}?view=proTeamSchedules_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023?view=proTeamSchedules_wl) ```sh jq '.settings.proTeams|map({name,byeWeek})' @@ -513,112 +516,141 @@ Get live updates (xhr=1) - **Player stats** [View](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e2ba150912691a56c86097303784aa2ff843a6c/new.md) ## Endpoints ### Athlete endpoints - https://partners.api.espn.com/v2/sports/football/nfl/athletes?limit=7000 - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876 - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/bio - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog :star: - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/news - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/overview - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/results - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/scorecards - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/stats - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/vsathlete - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/statistics/byathlete - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/statistics/byteam - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statistics/0 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/notes - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/projections - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog - https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?page=1&limit=20000 ### Calendar endpoints Blacklist dates, whitelist dates, events - https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20200901-20210228&pbpOnly=true - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315 ### Season endpoints Game weeks, Season types, weekly events, weekly picks - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/events - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000 ### Betting endpoints Betting, odds, draft - https://site.web.api.espn.com/apis/v3/sports/football/nfl/odds - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?limit=400 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=200 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003/predictors - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks ### Metainfo endpoints Franchise, news, venues - https://site.api.espn.com/apis/site/v2/sports/football/nfl/news - https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard - https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493 ### Team endpoints Depthcharts, injuries, coaches, roster, odds records - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12 - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/34?enable=projection - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/34?enable=roster - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/34?enable=stats - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/coaches/17553 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/projection - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/ats - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/attendance - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/leaders - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/odds-records - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/record - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries ### Fantasy endpoints - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2025?view=allon - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=chui_default_platformsettings - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?scoringPeriodId=2&view=chui_default_platformsettings - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=kona_player_info - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=players_wl - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/segments/1/leaguedefaults/3?scoringPeriodId=0&view=kona_player_info - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=chui_default_admin_group - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=chui_default_dashboard - https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=chui_default_platformsettings -
Apr 22, 2025 . 1 changed file with 108 additions and 1811 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -49,7 +49,7 @@ This page has been updated a lot in the past 3 years. **Older revisions you migh - [Search](#search) - [Pick em challenges](#pick-em-challenges) - [Fantasy](#fantasy) - [Endpoints](#endpoints) ## Game Night @@ -515,1813 +515,110 @@ Get live updates (xhr=1) [[TOC]](#toc) ## Endpoints ### Athlete endpoints eventlog, gamelog, projections.. etc - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876 - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/bio - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/notes - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/projections - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statistics/0 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog - https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/stats ### Calendar endpoints Blacklist dates, whitelist dates, events - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315 ### Season endpoints Game weeks, Season types, weekly events, weekly picks - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/events - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000 ### Betting endpoints Betting, odds, draft - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?limit=400 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=200 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003/predictors - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status ### Metainfo endpoints Franchise, news, venues - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams - https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0 - https://site.api.espn.com/apis/site/v2/sports/football/nfl/news - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003 - https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks ### Team endpoints Depthcharts, injuries, coaches, roster, odds records - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/ats - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/attendance - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/coaches/17553 - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/leaders - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/odds-records - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/projection - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/record - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster - https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics - https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0 -
Mar 7, 2025 . 1 changed file with 1007 additions and 1388 deletions.There are no files selected for viewing
-
Mar 6, 2025 . 1 changed file with 0 additions and 0 deletions.There are no files selected for viewing
File renamed without changes. -
Mar 6, 2025 . 1 changed file with 8 additions and 13 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -13,16 +13,17 @@ https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?page=1&limit=20 `https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/{{YEAR}}/players?view={{VIEW_NAME}}` ```sh # To get more than 50 items, run in terminal: curl -H 'X-Fantasy-Filter: {"games":{"limit":2000}}' <URL> ``` **Views (that I know of):** * [~~mDraftDetail~~](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mDraftDetail) * [mLiveScoring](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mLiveScoring) * [mMatchup](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mMatchup) * [mTeam](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mTeam) * [mMatchupScore](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mMatchupScore) * [mStandings](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mStandings) * [mRoster](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mRoster) @@ -32,12 +33,6 @@ Views: * [allon](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=allon) ## Stat column names ``` -
Mar 6, 2025 . 1 changed file with 302 additions and 0 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -0,0 +1,302 @@ ## Athletes: https://partners.api.espn.com/v2/sports/football/nfl/athletes?limit=7000 https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?page=1&limit=20000 ## Events `https://partners.api.espn.com/v2/sports/football/nfl/events?limit=1000` [&dates=20230101-20240101][daterange] or [&dates=20230101][singledate] or [&dates=2023][season] ## Fantasy `https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/{{YEAR}}/players?view={{VIEW_NAME}}` Views: * [mDraftDetail](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mDraftDetail) * [mLiveScoring](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mLiveScoring) * [mMatchup](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mMatchup) * [mPendingTransactions](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mPendingTransactions) * [mPositionalRatings](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mPositionalRatings) * [mSettings](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mSettings) * [mTeam](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mTeam) * [modular](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=modular) * [mNav](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mNav) * [mMatchupScore](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mMatchupScore) * [mStandings](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mStandings) * [mRoster](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mRoster) * [mBoxscore](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=mBoxscore) * [kona_player_info](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=kona_player_info) * [player_wl](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=player_wl) * [allon](https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=allon) To get more than 50 items, run in terminal: ```sh curl -H 'X-Fantasy-Filter: {"games":{"limit":2000}}' <URL> ``` ## Stat column names ``` id displayid abbrev description --- --------- -------- -------------------------------- 0 7 PA Each Pass Attempted 1 8 PC Each Pass Completed 2 11 INC Each Incomplete Pass 3 0 PY Passing Yards 4 14 PTD TD Pass 5 1 PY5 Every 5 passing yards 6 2 PY10 Every 10 passing yards ``` <details><summary>View more</summary> ``` id displayid abbrev description --- --------- -------- -------------------------------- 0 7 PA Each Pass Attempted 1 8 PC Each Pass Completed 2 11 INC Each Incomplete Pass 3 0 PY Passing Yards 4 14 PTD TD Pass 5 1 PY5 Every 5 passing yards 6 2 PY10 Every 10 passing yards 7 3 PY20 Every 20 passing yards 8 4 PY25 Every 25 passing yards 9 5 PY50 Every 50 passing yards 10 6 PY100 Every 100 passing yards 11 9 PC5 Every 5 pass completions 12 10 PC10 Every 10 pass completions 13 12 IP5 Every 5 pass incompletions 14 13 IP10 Every 10 pass incompletions 15 15 PTD40 40+ yard TD pass bonus 16 16 PTD50 50+ yard TD pass bonus 17 20 P300 300-399 yard passing game 18 21 P400 400+ yard passing game 19 19 2PC 2pt Passing Conversion 20 18 INTT Interceptions Thrown 21 155 CPCT Passing Completion Pct 22 156 PYPG Passing Yards Per Game 23 30 RA Rushing Attempts 24 23 RY Rushing Yards 25 33 RTD TD Rush 26 37 2PR 2pt Rushing Conversion 27 24 RY5 Every 5 rushing yards 28 25 RY10 Every 10 rushing yards 29 26 RY20 Every 20 rushing yards 30 27 RY25 Every 25 rushing yards 31 28 RY50 Every 50 rushing yards 32 29 R100 Every 100 rushing yards 33 31 RA5 Every 5 rush attempts 34 32 RA10 Every 10 rush attempts 35 34 RTD40 40+ yard TD rush bonus 36 35 RTD50 50+ yard TD rush bonus 37 38 RY100 100-199 yard rushing game 38 39 RY200 200+ yard rushing game 39 157 RYPA Rushing Yards Per Attempt 40 158 RYPG Rushing Yards Per Game 41 159 RECS Receptions 42 40 REY Receiving Yards 43 50 RETD TD Reception 44 54 2PRE 2pt Receiving Conversion 45 51 RETD40 40+ yard TD rec bonus 46 52 RETD50 50+ yard TD rec bonus 47 41 REY5 Every 5 receiving yards 48 42 REY10 Every 10 receiving yards 49 43 REY20 Every 20 receiving yards 50 44 REY25 Every 25 receiving yards 51 45 REY50 Every 50 receiving yards 52 46 RE100 Every 100 receiving yards 53 47 REC Each reception 54 48 REC5 Every 5 receptions 55 49 REC10 Every 10 receptions 56 55 REY100 100-199 yard receiving game 57 56 REY200 200+ yard receiving game 58 57 RET Receiving Target 59 160 YAC Receiving Yards After Catch 60 161 YPC Receiving Yards Per Catch 61 162 REYPG Receiving Yards Per Game 62 163 PTL Total 2pt Conversions 63 66 FTD Fumble Recovered for TD 64 22 SKD Sacked 65 164 PFUM Passing Fumbles 66 165 RFUM Rushing Fumbles 67 166 REFUM Receiving Fumbles 68 67 FUM Total Fumbles 69 167 PFUML Passing Fumbles Lost 70 168 RFUML Rushing Fumbles Lost 71 169 REFUML Receiving Fumbles Lost 72 68 FUML Total Fumbles Lost 73 170 TT Total Turnovers 74 84 FG50P FG Made (50+ yards) 75 171 FGA50P FG Attempted (50+ yards) 76 172 FGM50P FG Missed (50+ yards) 77 83 FG40 FG Made (40-49 yards) 78 86 FGA40 FG Attempted (40-49 yards) 79 89 FGM40 FG Missed (40-49 yards) 80 82 FG0 FG Made (0-39 yards) 81 85 FGA0 FG Attempted (0-39 yards) 82 88 FGM0 FG Missed (0-39 yards) 83 79 FG Total FG Made 84 80 FGA Total FG Attempted 85 81 FGM Total FG Missed 86 76 PAT Each PAT Made 87 77 PATA Each PAT Attempted 88 78 PATM Each PAT Missed 89 136 PA0 0 points allowed 90 137 PA1 1-6 points allowed 91 138 PA7 7-13 points allowed 92 139 PA14 14-17 points allowed 93 73 BLKKRTD Blocked Punt or FG return for TD 94 173 DEFRETTD Fumble or INT Return for TD 95 113 INT Each Interception 96 114 FR Each Fumble Recovered 97 112 BLKK Blocked Punt, PAT or FG 98 116 SF Each Safety 99 107 SK Each Sack 100 108 HALFSK 1/2 Sack 101 64 KRTD Kickoff Return TD 102 65 PRTD Punt Return TD 103 71 INTTD Interception Return TD 104 72 FRTD Fumble Return TD 105 174 TRTD Total Return TD 106 115 FF Each Fumble Forced 107 117 TKA Assisted Tackles 108 118 TKS Solo Tackles 109 109 TK Total Tackles 110 110 TK3 Every 3 Total Tackles 111 111 TK5 Every 5 Total Tackles 112 119 STF Stuffs 113 120 PD Passes Defensed 114 58 KR Kickoff Return Yards 115 61 PR Punt Return Yards 116 59 KR10 Every 10 kickoff return yards 117 60 KR25 Every 25 kickoff return yards 118 62 PR10 Every 10 punt return yards 119 63 PR25 Every 25 punt return yards 120 135 PTSA Points Allowed 121 140 PA18 18-21 points allowed 122 141 PA22 22-27 points allowed 123 142 PA28 28-34 points allowed 124 143 PA35 35-45 points allowed 125 144 PA46 46+ points allowed 126 175 PAPG Points Allowed Per Game 127 145 YA Yards Allowed 128 146 YA100 Less than 100 total yards allowed 129 147 YA199 100-199 total yards allowed 130 148 YA299 200-299 total yards allowed 131 149 YA349 300-349 total yards allowed 132 150 YA399 350-399 total yards allowed 133 151 YA449 400-449 total yards allowed 134 152 YA499 450-499 total yards allowed 135 153 YA549 500-549 total yards allowed 136 154 YA550 550+ total yards allowed 137 176 YAPG Yards Allowed Per Game 138 91 PT Net Punts 139 92 PTY Punt Yards 140 93 PT10 Punts Inside the 10 141 94 PT20 Punts Inside the 20 142 95 PTB Blocked Punts 143 96 PTR Punts Returned 144 97 PTRY Punt Return Yards 145 98 PTTB Touchbacks 146 99 PTFC Fair Catches 147 177 PTAVG Punt Average 148 100 PTA44 Punt Average 44.0+ 149 101 PTA42 Punt Average 42.0-43.9 150 102 PTA40 Punt Average 40.0-41.9 151 103 PTA38 Punt Average 38.0-39.9 152 104 PTA36 Punt Average 36.0-37.9 153 105 PTA34 Punt Average 34.0-35.9 154 106 PTA33 Punt Average 33.9 or less 155 69 TW Team Win 156 70 TL Team Loss 157 121 TIE Team Tie 158 122 PTS Points Scored 159 178 PPG Points Scored Per Game 160 179 MGN Margin of Victory 161 123 WM25 25+ point Win Margin 162 124 WM20 20-24 point Win Margin 163 125 WM15 15-19 point Win Margin 164 126 WM10 10-14 point Win Margin 165 127 WM5 5-9 point Win Margin 166 128 WM1 1-4 point Win Margin 167 129 LM1 1-4 point Loss Margin 168 130 LM5 5-9 point Loss Margin 169 131 LM10 10-14 point Loss Margin 170 132 LM15 15-19 point Loss Margin 171 133 LM20 20-24 point Loss Margin 172 134 LM25 25+ point Loss Margin 173 180 MGNPG Margin of Victory Per Game 174 181 WINPCT Winning Pct 175 182 PTD0 0-9 yd TD pass bonus 176 183 PTD10 10-19 yd TD pass bonus 177 184 PTD20 20-29 yd TD pass bonus 178 185 PTD30 30-39 yd TD pass bonus 179 186 RTD0 0-9 yd TD rush bonus 180 187 RTD10 10-19 yd TD rush bonus 181 188 RTD20 20-29 yd TD rush bonus 182 189 RTD30 30-39 yd TD rush bonus 183 190 RETD0 0-9 yd TD rec bonus 184 191 RETD10 10-19 yd TD rec bonus 185 192 RETD20 20-29 yd TD rec bonus 186 193 RETD30 30-39 yd TD rec bonus 187 194 DPTSA D/ST Points Allowed 188 195 DPA0 D/ST 0 points allowed 189 196 DPA1 D/ST 1-6 points allowed 190 197 DPA7 D/ST 7-13 points allowed 191 198 DPA14 D/ST 14-17 points allowed 192 199 DPA18 D/ST 18-21 points allowed 193 200 DPA22 D/ST 22-27 points allowed 194 201 DPA28 D/ST 28-34 points allowed 195 202 DPA35 D/ST 35-45 points allowed 196 203 DPA46 D/ST 46+ points allowed 197 204 DPAPG D/ST Points Allowed Per Game 198 205 FG50 FG Made (50-59 yards) 199 87 FGA50 FG Attempted (50-59 yards) 200 90 FGM50 FG Missed (50-59 yards) 201 206 FG60 FG Made (60+ yards) 202 207 FGA60 FG Attempted (60+ yards) 203 208 FGM60 FG Missed (60+ yards) 204 209 O2PRET Offensive 2pt Return 205 210 D2PRET Defensive 2pt Return 206 74 2PRET 2pt Return 207 211 O1PSF Offensive 1pt Safety 208 212 D1PSF Defensive 1pt Safety 209 75 1PSF 1pt Safety 210 213 GP Games Played 211 17 PFD Passing First Down 212 36 RFD Rushing First Down 213 53 REFD Receiving First Down 214 214 FGY FG Made Yards 215 215 FGMY FG Missed Yards 216 216 FGAY FG Attempt Yards 217 217 FGY5 Every 5 FG Made yards 218 218 FGY10 Every 10 FG Made yards 219 219 FGY20 Every 20 FG Made yards 220 220 FGY25 Every 25 FG Made yards 221 221 FGY50 Every 50 FG Made yards 222 222 FGY100 Every 100 FG Made yards 223 223 FGMY5 Every 5 FG Missed yards 224 224 FGMY10 Every 10 FG Missed yards 225 225 FGMY20 Every 20 FG Missed yards 226 226 FGMY25 Every 25 FG Missed yards 227 227 FGMY50 Every 50 FG Missed yards 228 228 FGMY100 Every 100 FG Missed yards 229 229 FGAY5 Every 5 FG Attempt yards 230 230 FGAY10 Every 10 FG Attempt yards 231 231 FGAY20 Every 20 FG Attempt yards 232 232 FGAY25 Every 25 FG Attempt yards 233 233 FGAY50 Every 50 FG Attempt yards 234 234 FGAY100 Every 100 FG Attempt yards ``` </details> [daterange]: https://partners.api.espn.com/v2/sports/football/nfl/events?dates=20230101-20240101&limit=1000 [singledate]: https://partners.api.espn.com/v2/sports/football/nfl/events?dates=20230101&limit=1000 [season]: https://partners.api.espn.com/v2/sports/football/nfl/events?dates=2023&limit=1000 -
Sep 22, 2024 . 1 changed file with 25 additions and 6 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -35,6 +35,7 @@ This page has been updated a lot in the past 3 years. **Older revisions you migh ## Table of Contents - [Game Night](#game-night) - [Reference List](#reference-list) - [News](#news) - [Detailed](#detailed) @@ -50,6 +51,20 @@ This page has been updated a lot in the past 3 years. **Older revisions you migh - [Fantasy](#fantasy) - [REST API Response Examples](#rest-api-response-examples) ## Game Night * **Get all Monday games**: https://site.api.espn.com/apis/site/v2/mondaynightfootball * **Get all Thursday games**: https://site.api.espn.com/apis/site/v2/thursdaynightfootball * **Get all Sunday games**: https://site.api.espn.com/apis/site/v2/sundaynightfootball ## Reference List Get list of ids @@ -95,17 +110,21 @@ Get list of ids - :star: **news with api links to event** [now.core.api.espn.com/v1/sports/news?limit=1000&sport=football](https://now.core.api.espn.com/v1/sports/news?limit=1000&sport=football) - :star: **Searchable by playerId:** [site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=**{ATHLETE_ID}**](https://site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=2977187) **Usage example**: [one](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c?permalink_comment_id=5200643#gistcomment-5200643) - **Search query**: (max limit 100) [site.web.api.espn.com/apis/search/v2?limit=100&query=**{SEARCH_TERM}**](https://site.web.api.espn.com/apis/search/v2?query=kupp&limit=100) **Usage example**: [two](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c?permalink_comment_id=5200298#gistcomment-5200298) - **Team news**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) ## Detailed Get live updates (xhr=1) - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50](https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50) - **Schedule**: [cdn.espn.com/core/nfl/schedule?xhr=1&year=**{YEAR}**&week=**{WEEK_NUM}**](https://cdn.espn.com/core/nfl/schedule?xhr=1&year=2020&week=2) @@ -217,9 +236,9 @@ Get list of ids ## Games - :star: **Summary**: 1 => [site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=**{EVENT_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) 2 => [site.web.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=**{EVENT_ID}**](https://site.web.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401671808) - **Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events) -
Sep 22, 2024 . 1 changed file with 10 additions and 6 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -89,20 +89,21 @@ Get list of ids ## News - **NFL news** [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?limit=50](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50) - :star: **news with api links to event** [now.core.api.espn.com/v1/sports/news?limit=1000&sport=football](https://now.core.api.espn.com/v1/sports/news?limit=1000&sport=football) - :star: **Player news:** [site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=**{ATHLETE_ID}**](https://site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=2977187) - **Search query**: [site.web.api.espn.com/apis/search/v2?limit=100&query=**{SEARCH_TERM}**>](https://site.web.api.espn.com/apis/search/v2?query=kupp&limit=100) - **Team news**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) ## Detailed - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50](https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50) @@ -265,6 +266,9 @@ Get list of ids - :star: **Splits**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**{ATHLETE_ID}**/splits](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits) - **Get all active player ids**: [sports.core.api.espn.com/v3/sports/football/nfl/athletes?limit=20000&active=true](https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?limit=20000&active=true) - **Player stats for event**: -
Sep 22, 2024 . 1 changed file with 100 additions and 64 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -36,6 +36,7 @@ This page has been updated a lot in the past 3 years. **Older revisions you migh ## Table of Contents - [Reference List](#reference-list) - [News](#news) - [Detailed](#detailed) - [Odds](#odds) - [Teams](#teams) @@ -85,6 +86,23 @@ Get list of ids - **Team News** (limit is incompatible with team filter): [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) ## News - NFL news [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?limit=50](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50) - :star: news with api links to event [now.core.api.espn.com/v1/sports/news?limit=1000&sport=football](https://now.core.api.espn.com/v1/sports/news?limit=1000&sport=football) - Search query: [site.web.api.espn.com/apis/search/v2?limit=100&query=**{SEARCH_TERM}**>](https://site.web.api.espn.com/apis/search/v2?query=kupp&limit=100) - Team news: [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) ## Detailed - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50](https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50) @@ -524,70 +542,88 @@ Get list of ids **TABLE OF CONTENTS** * [Table of Contents](#table-of-contents) * [Reference List](#reference-list) * [News](#news) * [Detailed](#detailed) * [Odds](#odds) * [Teams](#teams) * [Games](#games) * [Athletes](#athletes) * [Calendar](#calendar) * [Scoreboard](#scoreboard) * [Leagues](#leagues) * [Search](#search) * [Pick em challenges](#pick-em-challenges) * [Fantasy](#fantasy) * [v2](#v2) * [Fantasy Filters](#fantasy-filters) * [Fantasy Stats](#fantasy-stats) * [REST API Response Examples](#rest-api-response-examples) * [ATHLETE PROFILE API](#athlete-profile-api) * [ATHLETE BIO API](#athlete-bio-api) * [ATHLETE EVENTLOG API](#athlete-eventlog-api) * [ATHLETE GAMELOG API](#athlete-gamelog-api) * [ATHLETE NOTES API](#athlete-notes-api) * [ATHLETE PROJECTIONS API](#athlete-projections-api) * [ATHLETE SPLITS API](#athlete-splits-api) * [ATHLETE STATISTICS API](#athlete-statistics-api) * [ATHLETE STATISTICSLOG API](#athlete-statisticslog-api) * [ATHLETE STATS API](#athlete-stats-api) * [CALENDAR API](#calendar-api) * [CALENDAR BLACKLIST API](#calendar-blacklist-api) * [CALENDAR WHITELIST API](#calendar-whitelist-api) * [GAME PREDICTION API](#game-prediction-api) * [COMPETITION DRIVES API](#competition-drives-api) * [BETTING ODDS API](#betting-odds-api) * [COMPETITION PLAYS API](#competition-plays-api) * [GETS ALL PLAYS FOR A GAME: API](#gets-all-plays-for-a-game-api) * [COMPETITION PROBABILITIES API](#competition-probabilities-api) * [COMPETITOR ROSTER API](#competitor-roster-api) * [DRAFT ATHLETES API](#draft-athletes-api) * [DRAFT ROUNDS API](#draft-rounds-api) * [DRAFT STATUS API](#draft-status-api) * [EVENTS API](#events-api) * [EVENT COMPETITIONS API](#event-competitions-api) * [FRANCHISES API](#franchises-api) * [GROUP STANDINGS API](#group-standings-api) * [GROUP TEAMS API](#group-teams-api) * [LEADERS API](#leaders-api) * [NEWS API](#news-api) * [ODD PREDICTORS API](#odd-predictors-api) * [POSITIONS API](#positions-api) * [PROVIDERS API](#providers-api) * [SCOREBOARD API](#scoreboard-api) * [SEASONS API](#seasons-api) * [SEASON ATHLETES API](#season-athletes-api) * [SEASON COACHES API](#season-coaches-api) * [SEASON DRAFT API](#season-draft-api) * [SEASON FUTURES API](#season-futures-api) * [SEASON TEAMS API](#season-teams-api) * [SEASON TYPES API](#season-types-api) * [TALENTPICKS API](#talentpicks-api) * [TEAM API](#team-api) * [TEAM ATHLETES API](#team-athletes-api) * [TEAM ATS API](#team-ats-api) * [TEAM ATTENDANCE API](#team-attendance-api) * [TEAM COACHES API](#team-coaches-api) * [TEAM DEPTHCHARTS API](#team-depthcharts-api) * [TEAM EVENTS API](#team-events-api) * [TEAM INJURIES API](#team-injuries-api) * [TEAM LEADERS API](#team-leaders-api) * [TEAM ODDS-RECORDS API](#team-odds-records-api) * [TEAM PROJECTION API](#team-projection-api) * [TEAM RECORD API](#team-record-api) * [TEAM ROSTER API](#team-roster-api) * [TEAM SCHEDULE API](#team-schedule-api) * [TEAM STATISTICS API](#team-statistics-api) * [SEASONTYPE GROUPS API](#seasontype-groups-api) * [SEASONTYPE LEADERS API](#seasontype-leaders-api) * [SEASONTYPE WEEKS API](#seasontype-weeks-api) * [VENUES API](#venues-api) * [WEEKLY EVENTS API](#weekly-events-api) * [WEEKLY QBR API](#weekly-qbr-api) * [WEEKLY TALENTPICKS API](#weekly-talentpicks-api) <br> <details><summary>Expand for view</summary> -
Sep 21, 2024 . 1 changed file with 13 additions and 4 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -198,21 +198,30 @@ Get list of ids ## Games - :star: **Summary**: * [site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=**{EVENT_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) * [site.web.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=**{EVENT_ID}**](https://site.web.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401671808) - **Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events) - **Play by Plays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/plays?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300) - **Drives**: plays, drive start/end times, and total offensive plays [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/drives](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401548411/competitions/401548411/drives) - **Play probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/probabilities?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=300) - **Linescores**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/linescores](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/linescores) - **Records**: Record Year To Date as of Event (wins, losses, streaks, etc) [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/records](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401548411/competitions/401548411/competitors/10/records) - **Scoring & All Splits**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/statistics](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/statistics) @@ -2637,4 +2646,4 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png", ``` </details> -
Jan 5, 2024 . 1 changed file with 4 additions and 1 deletion.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -1,6 +1,6 @@ # List of NFL API Endpoints This page has been updated a lot in the past 3 years. **Older revisions you might like more than this one:** - [**June 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/b99b9e0d2df72470fa622e2f76cecb0362111e9a) - list of endpoints for other sports/leagues (i.e. basketball, baseball, lacrosse, rugby) - [**August 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce#league-history---get-all-historical-data) - get historical fantasy league data @@ -155,6 +155,9 @@ Get list of ids - **Team (season)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) - **Current Leaders**: [site.web.api.espn.com/apis/site/v3/sports/football/nfl/teamleaders](https://site.web.api.espn.com/apis/site/v3/sports/football/nfl/teamleaders) - **Season Leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/leaders](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) -
Dec 1, 2023 . 1 changed file with 4 additions and 1 deletion.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -140,7 +140,10 @@ Get list of ids - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/athletes?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/18/athletes?limit=200) - **Team Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/events) - **List of NFL Teams (with id,logo,name)**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) - **Team**: -
Nov 7, 2023 . 1 changed file with 19 additions and 8 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -386,19 +386,30 @@ Get list of ids ## Fantasy > **v3 header:** > `X-Fantasy-Filter: {"players":{"limit":2000},"filterActive":{"value":true}}` * **Current season**: [fantasy.espn.com/apis/v3/games/ffl](https://fantasy.espn.com/apis/v3/games/ffl) - **Players**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/players?view=players_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?view=players_wl) - [&view=mTeam&view=mRoster&view=mMatchup&view=mSettings](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/players?view=mTeam&view=mRoster&view=mMatchup&view=mSettings) - **Private league**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leagues/**{FANTASY_LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mRoster) - season < 2018: [fantasy.espn.com/apis/v3/games/ffl/leagueHistory/**{FANTASY_LEAGUE_ID}**?seasonId=**{YEAR}**](https://fantasy.espn.com/apis/v3/games/ffl/leagueHistory/1241838?seasonId=2018&view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mRoster) - season > 2018: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leagues/**{FANTASY_LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mRoster) ### v2 - **Games**: [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=**YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210913&pbpOnly=true) - [dates=**YYYYMMDD-YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108) ### Fantasy Filters * **Get % owned for players**: @@ -408,7 +419,7 @@ Get list of ids curl -H 'X-Fantasy-Filter: {"filterActive":{"value":true}}' <URL> ``` `X-Fantasy-Filter` is required in the request header to get all active players. Omitting this returns only 50 items --- -
Oct 31, 2023 . 1 changed file with 4 additions and 3 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -413,14 +413,15 @@ Get list of ids --- * :star: **Get player info**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leaguedefaults/**{PPR_ID}**?view=kona_player_info](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/segments/0/leaguedefaults/3?view=kona_player_info) ```sh curl -H 'X-Fantasy-Filter: {"players":{"limit":2000,"sortPercOwned":{"sortPriority":4,"sortAsc":false}}}' <URL> ``` * `sortPercOwned` is required with `limit` * `PPR_ID` can be 1, 3, or 4. --- -
Oct 31, 2023 . 1 changed file with 7 additions and 9 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -161,15 +161,12 @@ Get list of ids - **Depthcharts**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/depthcharts](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts) - **Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**/roster](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/roster) - :star: **Detailed Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**?**enable=roster,projection,stats**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4?enable=roster,projection,stats) - **Schedule**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**/schedule](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule)[`?season=`**{YEAR}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule?season=2019) @@ -241,7 +238,7 @@ Get list of ids - **Eventlog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/athletes/**{ATHLETE_ID}**/eventlog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog) - **Event stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/roster/**{ATHLETE_ID}**/statistics/0](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640/competitors/10/roster/14876/statistics/0) - **Current leaders**: @@ -253,7 +250,7 @@ Get list of ids - **Talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks) - :star: **Gamelog**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**{ATHLETE_ID}**/gamelog](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog) - **Coaches**: @@ -372,8 +369,9 @@ Get list of ids > - chui_pagetype_group_picks > - pagetype_leaderboard - **Scoring**: [gambit-api.fantasy.espn.com/apis/v1/challenges/**${CHALLENGE_NAME}**?scoringPeriodId=**{WEEKNUM}**&view=**{VIEW_NAME}**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023?scoringPeriodId=3&platform=chui&view=allon) - **Group**: [gambit-api.fantasy.espn.com/apis/v1/challenges/**${CHALLENGE_NAME}**/groups/**{GROUP_ID}**?view=**{VIEW_NAME}**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-win-totals-2023/groups/3ea0845b-59d5-499b-97a0-2eb9d02e1cc9?view=allon&platform=chui) @@ -403,7 +401,7 @@ Get list of ids ### Fantasy Filters * **Get % owned for players**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/players?scoringPeriodId=0&view=players_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?scoringPeriodId=0&view=players_wl) ```sh -
Oct 20, 2023 . 1 changed file with 205 additions and 173 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -7,42 +7,56 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - [**September 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9#file-source-txt) - list of endpoints in plain text - [**May 2023**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/cd7462cd365e516d7499b43f027db4b8b1a2d6c0) - collapsed endpoint response examples <br><strong>Additional Resources</strong> - [nfl-nerd](https://github.com/nntrn/nfl-nerd) ([api](https://raw.githubusercontent.com/nntrn/nfl-nerd/master/src/api.js)) - [espn-wiki](https://github.com/nntrn/espn-wiki/wiki) :star: - [ESPN's hidden API endpoints](https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b) - [Using ESPN's new Fantasy API (v3)](https://stmorse.github.io/journal/espn-fantasy-v3.html) - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html) <br><strong>Notes</strong> - This page is limited to NFL endpoints but can be refashioned for other leagues (i.e. `/sports/football/leagues/nfl/` => `/sports/baseball/leagues/mlb/`) **List of ESPN leagues**: [API](https://sports.core.api.espn.com/v2/sports) | [Document](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e0b844e4d56d0b049747024a04bb7949c2d6c5d/extending-espn-api.md) <br><strong>Paramaters</strong> - **{YEAR}**: Football season (`YYYY`) - **{SEASONTYPE}**: 1=pre, 2=regular, 3=post, 4=off - **{EVENT_ID}**: game id - **{TEAM_ID}**: 1-32 ([view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams)) - **{ATHLETE_ID}**: [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) - **{FANTASY_LEAGUE_ID}**: Fantasy league id - **{BET_PROVIDER_ID}**: [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers?limit=100) <div id="toc"></div> ## Table of Contents - [Reference List](#reference-list) - [Detailed](#detailed) - [Odds](#odds) - [Teams](#teams) - [Games](#games) - [Athletes](#athletes) - [Calendar](#calendar) - [Scoreboard](#scoreboard) - [Leagues](#leagues) - [Search](#search) - [Pick em challenges](#pick-em-challenges) - [Fantasy](#fantasy) - [REST API Response Examples](#rest-api-response-examples) ## Reference List Get list of ids - **Events**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**scoreboard**?limit=1000&dates=**{YEAR}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2023) Filter: [&seasontype=2&week=1](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2023&seasontype=2&week=1) | [&seasontype=2](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2021&seasontype=2) - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**athletes**?limit=1000&active=true](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) @@ -71,8 +85,7 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **Team News** (limit is incompatible with team filter): [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) ## Detailed - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50](https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50) @@ -90,8 +103,7 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **Matchup**: [cdn.espn.com/core/nfl/matchup?xhr=1&gameId=**{EVENT_ID}**](https://cdn.espn.com/core/nfl/matchup?xhr=1&gameId=401220225) ## Odds - **Win probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/probabilities?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200) @@ -123,11 +135,10 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200) ## Teams - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/athletes?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/18/athletes?limit=200) - **Teams (Current)**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) @@ -180,8 +191,9 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh [AFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) (CONFERENCE_ID=8) [NFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7/standings) (CONFERENCE_ID=7) <br>[<sup>[TOC]</sup>](#table-of-contents) ## Games - **Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events) @@ -219,20 +231,18 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **Expected margin of victory & predicted win percentage**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/powerindex/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30) ## Athletes - :star: **Splits**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**{ATHLETE_ID}**/splits](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits) - **Player stats for event**: - **Eventlog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/athletes/**{ATHLETE_ID}**/eventlog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog) - **Event stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/roster/**{ATHLETE_ID}**/statistics/0](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640/competitors/10/roster/14876/statistics/0) - **Current leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders) @@ -273,8 +283,9 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **Draft rounds**: [site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=**{YEAR}**&draft_round=1](https://site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=2023&draft_round=1) <br>[<sup>[TOC]</sup>](#table-of-contents) ## Calendar - **Ondays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays) @@ -293,12 +304,10 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **Rankings, events, and talentpicks for week**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEKNUM}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1) - **Season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021) ## Scoreboard - **Day**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20181213) @@ -312,18 +321,17 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **Range** (cannot be more than 13 months): [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYYMMDD-YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20210228) *** **Examples**: site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard - [?dates=**2022**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2022) - [?dates=**2022**&seasontype=**2**&week=**1**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2022&seasontype=2&week=1) - [?dates=**20200901-20210228**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20200901-20210228) - [?dates=**20200901**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20200901) ## Leagues - **Transactions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions) @@ -337,17 +345,98 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **Header**: [site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl](https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl) ## Search - [site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix](https://site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix) - [site.web.api.espn.com/apis/common/v3/search](https://site.web.api.espn.com/apis/common/v3/search) <br>[<sup>[TOC]</sup>](#table-of-contents) ## Pick em challenges > Parameters > > - **{USER_GAME_ID}** > - **{GROUP_ID}** > - **CHALLENGE {ID}** and **{NAME}** > - [231] nfl-win-totals-2023 > - [232] nfl-eliminator-challenge-2023 > - [230] nfl-pigskin-pickem-2023 > - **{VIEW_NAME}** > - :star: allon > - :star: chui_default > - chui_default_group > - chui_default_groupParticipationHistory > - chui_default_metadata > - chui_pagetype_group_picks > - pagetype_leaderboard - **Scoring**: [gambit-api.fantasy.espn.com/apis/v1/challenges/**${CHALLENGE_NAME}**?scoringPeriodId=**{WEEKNUM}**&view=**{VIEW_NAME}**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023?scoringPeriodId=3&platform=chui&view=allon) - **Group**: [gambit-api.fantasy.espn.com/apis/v1/challenges/**${CHALLENGE_NAME}**/groups/**{GROUP_ID}**?view=**{VIEW_NAME}**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-win-totals-2023/groups/3ea0845b-59d5-499b-97a0-2eb9d02e1cc9?view=allon&platform=chui) - :star: **User** [gambit-api.fantasy.espn.com/apis/v1/challenges/**${CHALLENGE_NAME}**/entries/**{USER_GAME_ID}**?view=**{VIEW_NAME}**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023/entries/ac079fc0-4d4f-11ee-96d2-37e637e51967?platform=chui&view=chui_default) - **Leaderboard**: [gambit-api.fantasy.espn.com/apis/v1/challenges/**${CHALLENGE_NAME}**/leaderboard?view=**{VIEW_NAME}**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023/leaderboard?view=pagetype_leaderboard&platform=chui) - **Propositions**: [gambit-api.fantasy.espn.com/apis/v1/propositions?challengeId=**${CHALLENGE_ID}**&view=**{VIEW_NAME}**](https://gambit-api.fantasy.espn.com/apis/v1/propositions?challengeId=230&platform=chui&view=chui_default) ## Fantasy * :star: **API structure**: https://fantasy.espn.com/apis/v3/swagger.json * **Current season**: [fantasy.espn.com/apis/v3/games/ffl](https://fantasy.espn.com/apis/v3/games/ffl) * **Player stats in date range**: [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=**YYYYMMDD-YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108) * **Private league**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leagues/**{FANTASY_LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav) ### Fantasy Filters * **Get percent owned of every play**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/players?scoringPeriodId=0&view=players_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?scoringPeriodId=0&view=players_wl) ```sh curl -H 'X-Fantasy-Filter: {"filterActive":{"value":true}}' <URL> ``` `X-Fantasy-Filter` is required in the request header to get all active players. Omitting this returns only 50 items --- * **Get player info**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leaguedefaults/3?view=kona_player_info](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/segments/0/leaguedefaults/3?view=kona_player_info) ```sh curl -H 'X-Fantasy-Filter: {"players":{"limit":2000,"sortPercOwned":{"sortPriority":4,"sortAsc":false}}}' <URL> ``` `sortPercOwned` is required with `limit` --- * **Get bye week for all teams**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**?view=proTeamSchedules_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023?view=proTeamSchedules_wl) ```sh jq '.settings.proTeams|map({name,byeWeek})' ``` ### Fantasy Stats - **Position** ```json { "1": "QB", "2": "RB", @@ -357,7 +446,8 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh "16": "DST" } ``` - **Player stats** ```json { "3": "passingYards", "4": "passingTouchdowns", @@ -402,142 +492,84 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh "136": "defensiveOver550YardsAllowed" } ``` <br>[<sup>[TOC]</sup>](#table-of-contents) ## REST API Response Examples **TABLE OF CONTENTS** - [ATHLETE PROFILE API](#athlete-profile-api) - [ATHLETE BIO API](#athlete-bio-api) - [ATHLETE EVENTLOG API](#athlete-eventlog-api) - [ATHLETE GAMELOG API](#athlete-gamelog-api) - [ATHLETE NOTES API](#athlete-notes-api) - [ATHLETE PROJECTIONS API](#athlete-projections-api) - [ATHLETE SPLITS API](#athlete-splits-api) - [ATHLETE STATISTICS API](#athlete-statistics-api) - [ATHLETE STATISTICSLOG API](#athlete-statisticslog-api) - [ATHLETE STATS API](#athlete-stats-api) - [CALENDAR API](#calendar-api) - [CALENDAR BLACKLIST API](#calendar-blacklist-api) - [CALENDAR WHITELIST API](#calendar-whitelist-api) - [GAME PREDICTION API](#game-prediction-api) - [COMPETITION DRIVES API](#competition-drives-api) - [BETTING ODDS API](#betting-odds-api) - [COMPETITION PLAYS API](#competition-plays-api) - [GETS ALL PLAYS FOR A GAME: API](#gets-all-plays-for-a-game-api) - [COMPETITION PROBABILITIES API](#competition-probabilities-api) - [COMPETITOR ROSTER API](#competitor-roster-api) - [DRAFT ATHLETES API](#draft-athletes-api) - [DRAFT ROUNDS API](#draft-rounds-api) - [DRAFT STATUS API](#draft-status-api) - [EVENTS API](#events-api) - [EVENT COMPETITIONS API](#event-competitions-api) - [FRANCHISES API](#franchises-api) - [GROUP STANDINGS API](#group-standings-api) - [GROUP TEAMS API](#group-teams-api) - [LEADERS API](#leaders-api) - [NEWS API](#news-api) - [ODD PREDICTORS API](#odd-predictors-api) - [POSITIONS API](#positions-api) - [PROVIDERS API](#providers-api) - [SCOREBOARD API](#scoreboard-api) - [SEASONS API](#seasons-api) - [SEASON ATHLETES API](#season-athletes-api) - [SEASON COACHES API](#season-coaches-api) - [SEASON DRAFT API](#season-draft-api) - [SEASON FUTURES API](#season-futures-api) - [SEASON TEAMS API](#season-teams-api) - [SEASON TYPES API](#season-types-api) - [TALENTPICKS API](#talentpicks-api) - [TEAM API](#team-api) - [TEAM ATHLETES API](#team-athletes-api) - [TEAM ATS API](#team-ats-api) - [TEAM ATTENDANCE API](#team-attendance-api) - [TEAM COACHES API](#team-coaches-api) - [TEAM DEPTHCHARTS API](#team-depthcharts-api) - [TEAM EVENTS API](#team-events-api) - [TEAM INJURIES API](#team-injuries-api) - [TEAM LEADERS API](#team-leaders-api) - [TEAM ODDS-RECORDS API](#team-odds-records-api) - [TEAM PROJECTION API](#team-projection-api) - [TEAM RECORD API](#team-record-api) - [TEAM ROSTER API](#team-roster-api) - [TEAM SCHEDULE API](#team-schedule-api) - [TEAM STATISTICS API](#team-statistics-api) - [SEASONTYPE GROUPS API](#seasontype-groups-api) - [SEASONTYPE LEADERS API](#seasontype-leaders-api) - [SEASONTYPE WEEKS API](#seasontype-weeks-api) - [VENUES API](#venues-api) - [WEEKLY EVENTS API](#weekly-events-api) - [WEEKLY QBR API](#weekly-qbr-api) - [WEEKLY TALENTPICKS API](#weekly-talentpicks-api) <br> <details><summary>Expand for view</summary> <br> <div id="top"></div> ### ATHLETE PROFILE API **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876 -
Oct 10, 2023 . 1 changed file with 4 additions and 4 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -68,8 +68,8 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **News**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?limit=50](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50) - **Team News** (limit is incompatible with team filter): [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) ### Detailed @@ -111,7 +111,7 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/0/teams/4/odds-records) - **Game odds**: @@ -120,7 +120,7 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - **QBR Weekly/Game stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/2/weeks/**{WEEK_NUM}**/qbr/10000](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200) -
Oct 4, 2023 . 1 changed file with 0 additions and 1 deletion.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -5,7 +5,6 @@ This page has been updated a lot in the past 2 years. **Older revisions you migh - [**June 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/b99b9e0d2df72470fa622e2f76cecb0362111e9a) - list of endpoints for other sports/leagues (i.e. basketball, baseball, lacrosse, rugby) - [**August 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce#league-history---get-all-historical-data) - get historical fantasy league data - [**September 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9#file-source-txt) - list of endpoints in plain text - [**May 2023**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/cd7462cd365e516d7499b43f027db4b8b1a2d6c0) - collapsed endpoint response examples -
Oct 3, 2023 . 1 changed file with 17 additions and 8 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -1,13 +1,13 @@ # List of NFL API Endpoints This page has been updated a lot in the past 2 years. **Older revisions you might like more than this one:** - [**June 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/b99b9e0d2df72470fa622e2f76cecb0362111e9a) - list of endpoints for other sports/leagues (i.e. basketball, baseball, lacrosse, rugby) - [**August 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce#league-history---get-all-historical-data) - get historical fantasy league data - [**September 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9#file-source-txt) - list of endpoints in plain text - [**December 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/e178f6ed83fe806b4a3913a4ba3e3f59e44c2174) - includes example responses for each endpoint - [**May 2023**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/cd7462cd365e516d7499b43f027db4b8b1a2d6c0) - collapsed endpoint response examples **Additional Resources** @@ -22,22 +22,28 @@ This page has been updated a lot in the past 2 years. * This page is limited to NFL endpoints but can be refashioned for other leagues (i.e. `/sports/football/leagues/nfl/` => `/sports/baseball/leagues/mlb/`) * **List of ESPN leagues**: [API](https://sports.core.api.espn.com/v2/sports) | [Document](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e0b844e4d56d0b049747024a04bb7949c2d6c5d/extending-espn-api.md) <br> ## API Endpoints - **{YEAR}**: Football season (`YYYY`) - **{SEASONTYPE}**: 1=pre, 2=regular, 3=post, 4=off - **{EVENT_ID}**: game id - **{TEAM_ID}**: 1-32 ([view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams)) - **{ATHLETE_ID}**: [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) - **{LEAGUE_ID}**: Fantasy league id - **{BET_PROVIDER_ID}**: [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers?limit=100) --- ### List - **Events**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**scoreboard**?limit=1000&dates=**{YEAR}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2023) Filter: [&seasontype=2&week=1](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2023&seasontype=2&week=1) | [&seasontype=2](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2021&seasontype=2) - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**athletes**?limit=1000&active=true](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) @@ -121,6 +127,9 @@ This page has been updated a lot in the past 2 years. ### Teams - **Athletes**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/18/athletes?limit=200 - **Teams (Current)**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) @@ -142,7 +151,7 @@ This page has been updated a lot in the past 2 years. - **Depthcharts**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/depthcharts](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts) - :star: **Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**/roster](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/roster) - **Detailed Team**: @@ -253,7 +262,7 @@ This page has been updated a lot in the past 2 years. - **statisticslog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/**{ATHLETE_ID}**/statisticslog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2576336/statisticslog) - :star: **Athlete Overview**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**{ATHLETE_ID}**/overview](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/overview) - **Free agents**: -
Sep 15, 2023 . 1 changed file with 29 additions and 16 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -12,7 +12,7 @@ This page has been updated a lot in the past 2 years. **Additional Resources** - [nfl-nerd](https://github.com/nntrn/nfl-nerd) ([api](https://raw.githubusercontent.com/nntrn/nfl-nerd/master/src/api.js)) - [espn-wiki](https://github.com/nntrn/espn-wiki/wiki) :star: - [ESPN's hidden API endpoints](https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b) - [Using ESPN's new Fantasy API (v3)](https://stmorse.github.io/journal/espn-fantasy-v3.html) - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html) @@ -163,8 +163,14 @@ This page has been updated a lot in the past 2 years. - **Past performance**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**{TEAM_ID}**/odds/**{BET_PROVIDER_ID}**/past-performances?limit=140](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/odds/1002/past-performances?limit=140) - **Projection** (not valid for past seasons): [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**2023**/teams/**{TEAM_ID}**/projection](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/23/projection) - **Season standing**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/groups/**{CONFERENCE_ID}**/standings](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) [AFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) (CONFERENCE_ID=8) [NFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7/standings) (CONFERENCE_ID=7) ### Games @@ -202,7 +208,7 @@ This page has been updated a lot in the past 2 years. - **Game officials/judges**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/officials](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/officials) - **Expected margin of victory & predicted win percentage**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/powerindex/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30) @@ -286,20 +292,27 @@ This page has been updated a lot in the past 2 years. ### Scoreboard - **Day**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20181213) - **Week**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYY**&seasontype=**{SEASONTYPE}**&week=**{WEEKNUM}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2018&seasontype=2&week=1) - **Year**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYY**&seasontype=2](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2018&seasontype=2) - **Range** (cannot be more than 13 months): [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYYMMDD-YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20210228) --- **Examples**: site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard * [?dates=**2022**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2022) * [?dates=**2022**&seasontype=**2**&week=**1**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2022&seasontype=2&week=1) * [?dates=**20200901-20210228**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20200901-20210228) * [?dates=**20200901**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20200901) ### League @@ -394,7 +407,7 @@ This page has been updated a lot in the past 2 years. - **Private league**: [fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/**{LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav) --- - **Get percent owned of every play**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/players?scoringPeriodId=0&view=players_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?scoringPeriodId=0&view=players_wl) @@ -405,7 +418,7 @@ This page has been updated a lot in the past 2 years. `X-Fantasy-Filter` is required in the request header to get all active players. Omitting this returns only 50 items --- - **Get player info**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leaguedefaults/3?view=kona_player_info](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/segments/0/leaguedefaults/3?view=kona_player_info) @@ -416,7 +429,7 @@ This page has been updated a lot in the past 2 years. `sortPercOwned` is required with `limit` --- - **Get bye week for all teams**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**?view=proTeamSchedules_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023?view=proTeamSchedules_wl) -
Sep 15, 2023 . 1 changed file with 32 additions and 15 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -18,6 +18,14 @@ This page has been updated a lot in the past 2 years. - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html) **Notes** * This page is limited to NFL endpoints but can be refashioned for other leagues (i.e. `/sports/football/leagues/nfl/` => `/sports/baseball/leagues/mlb/`) * [List of ESPN leagues](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e0b844e4d56d0b049747024a04bb7949c2d6c5d/extending-espn-api.md) <br> ## API Endpoints - **{YEAR}**: Football season (`YYYY`) @@ -67,15 +75,15 @@ This page has been updated a lot in the past 2 years. - **Standings**: [cdn.espn.com/core/nfl/standings?xhr=1](https://cdn.espn.com/core/nfl/standings?xhr=1) - **Boxscore**: [cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=**{EVENT_ID}**](https://cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=401220225) - **Recap**: [cdn.espn.com/core/nfl/recap?xhr=1&gameId=**{EVENT_ID}**](https://cdn.espn.com/core/nfl/recap?xhr=1&gameId=401220225) - **Plays**: [cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=**{EVENT_ID}**](https://cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=401220225) - **Game**: [cdn.espn.com/core/nfl/game?xhr=1&gameId=**{EVENT_ID}**](https://cdn.espn.com/core/nfl/game?xhr=1&gameId=401127922) - **Matchup**: [cdn.espn.com/core/nfl/matchup?xhr=1&gameId=**{EVENT_ID}**](https://cdn.espn.com/core/nfl/matchup?xhr=1&gameId=401220225) ### Odds @@ -122,7 +130,8 @@ This page has been updated a lot in the past 2 years. - **Teams (Season)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams) - **Team (season)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) - **Season Leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/leaders](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) @@ -167,19 +176,19 @@ This page has been updated a lot in the past 2 years. [site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=**{EVENT_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) - **Play by Plays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/plays?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300) - **Play probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/probabilities?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=300) - **Linescores**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/linescores](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/linescores) - **Scoring & All Splits**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/statistics](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/statistics) - **Roster (get starters)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/roster](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220225/competitions/401220225/competitors/12/roster) - **Weekly talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEK_NUM}**/talentpicks?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/talentpicks?limit=100) @@ -191,17 +200,26 @@ This page has been updated a lot in the past 2 years. [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEK_NUM}**/qbr/10000?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000?limit=100) - **Game officials/judges**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/officials](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/officials) - **Expected margin of victory & Team's predicted win percentage**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/powerindex/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30) ### Athletes - :star: **Splits**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**{ATHLETE_ID}**/splits](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits) - **Player stats for event**: - **Eventlog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/athletes/**{ATHLETE_ID}**/eventlog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog) - **Event stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/competitors/**{TEAM_ID}**/roster/**{ATHLETE_ID}**/statistics/0](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640/competitors/10/roster/14876/statistics/0) - **Current leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders) @@ -280,7 +298,7 @@ This page has been updated a lot in the past 2 years. - **Season standing**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/groups/**{CONFERENCE_ID}**/standings](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) [AFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) (CONFERENCE_ID=8) [NFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7/standings) (CONFERENCE_ID=7) @@ -432,7 +450,6 @@ This page has been updated a lot in the past 2 years. **TABLE OF CONTENTS** * [ATHLETE PROFILE API](#athlete-profile-api) * [ATHLETE BIO API](#athlete-bio-api) * [ATHLETE EVENTLOG API](#athlete-eventlog-api) -
Sep 13, 2023 . 1 changed file with 98 additions and 33 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -4,7 +4,7 @@ This page has been updated a lot in the past 2 years. **Older revisions you might like more than this one:** - [**June 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/5e0b844e4d56d0b049747024a04bb7949c2d6c5d#file-extending-espn-api-md) - list of endpoints for other sports/leagues (i.e. basketball, baseball, lacrosse, rugby) - [**August 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce#league-history---get-all-historical-data) - get historical fantasy league data - [**September 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9#file-source-txt) - list of endpoints in plain text - [**December 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/e178f6ed83fe806b4a3913a4ba3e3f59e44c2174) - includes example responses for each endpoint @@ -29,7 +29,7 @@ This page has been updated a lot in the past 2 years. --- ### General - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**athletes**?limit=1000&active=true](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) @@ -59,7 +59,7 @@ This page has been updated a lot in the past 2 years. [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) (limit is incompatible with team filter) ### Detailed - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50](https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50) @@ -78,7 +78,7 @@ This page has been updated a lot in the past 2 years. - **Matchup**: [cdn.espn.com/core/nfl/matchup?xhr=1&gameId=**{GAME_ID}**](https://cdn.espn.com/core/nfl/matchup?xhr=1&gameId=401220225) ### Odds - **Win probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/probabilities?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200) @@ -111,15 +111,15 @@ This page has been updated a lot in the past 2 years. [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**{TEAM_ID}**/odds/**{BET_PROVIDER_ID}**/past-performances?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200) ### Teams - **Teams (Current)**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) - **Team**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/1) - **Teams (Season)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) @@ -158,7 +158,7 @@ This page has been updated a lot in the past 2 years. [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/projection](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/projection) ### Games - **Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events) @@ -197,7 +197,10 @@ This page has been updated a lot in the past 2 years. [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/powerindex/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30) ### Athletes - :star: **Splits**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**{ATHLETE_ID}**/splits](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits) - **Current leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders) @@ -214,9 +217,12 @@ This page has been updated a lot in the past 2 years. - **Coaches**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/coaches?limit=50](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/coaches?limit=50) - **Athletes v2**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes) - **Athletes v3**: [sports.core.api.espn.com/v3/sports/football/nfl/athletes](https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?limit=1000) - **Player stats for each game**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/athletes/**{ATHLETE_ID}**/eventlog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog) @@ -236,30 +242,31 @@ This page has been updated a lot in the past 2 years. [site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=**{YEAR}**&draft_round=1](https://site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=2023&draft_round=1) ### Calendar - **Ondays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays) - **Offdays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays) - **Blacklist**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist) - **Whitelist dates**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist) - **Weeks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks) - **Rankings, events, and talentpicks for week**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEKNUM}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1) - **Season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021) ### Scoreboard - **Events in a season**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYY**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2022) @@ -277,7 +284,7 @@ This page has been updated a lot in the past 2 years. [NFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7/standings) (CONFERENCE_ID=7) ### League - **Transactions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions) @@ -292,20 +299,82 @@ This page has been updated a lot in the past 2 years. [site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl](https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl) ### Search - [site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix](https://site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix) - [site.web.api.espn.com/apis/common/v3/search](https://site.web.api.espn.com/apis/common/v3/search) ### Fantasy * **Position map** ```json { "1": "QB", "2": "RB", "3": "WR", "4": "TE", "5": "K", "16": "DST" } ``` * **Player stats map** ```json { "3": "passingYards", "4": "passingTouchdowns", "19": "passing2PtConversions", "20": "passingInterceptions", "24": "rushingYards", "25": "rushingTouchdowns", "26": "rushing2PtConversions", "42": "receivingYards", "43": "receivingTouchdowns", "44": "receiving2PtConversions", "53": "receivingReceptions", "72": "lostFumbles", "74": "madeFieldGoalsFrom50Plus", "77": "madeFieldGoalsFrom40To49", "80": "madeFieldGoalsFromUnder40", "85": "missedFieldGoals", "86": "madeExtraPoints", "88": "missedExtraPoints", "89": "defensive0PointsAllowed", "90": "defensive1To6PointsAllowed", "91": "defensive7To13PointsAllowed", "92": "defensive14To17PointsAllowed", "93": "defensiveBlockedKickForTouchdowns", "95": "defensiveInterceptions", "96": "defensiveFumbles", "97": "defensiveBlockedKicks", "98": "defensiveSafeties", "99": "defensiveSacks", "101": "kickoffReturnTouchdown", "102": "puntReturnTouchdown", "103": "fumbleReturnTouchdown", "104": "interceptionReturnTouchdown", "123": "defensive28To34PointsAllowed", "124": "defensive35To45PointsAllowed", "129": "defensive100To199YardsAllowed", "130": "defensive200To299YardsAllowed", "132": "defensive350To399YardsAllowed", "133": "defensive400To449YardsAllowed", "134": "defensive450To499YardsAllowed", "135": "defensive500To549YardsAllowed", "136": "defensiveOver550YardsAllowed" } ``` - :star: **API structure**: https://fantasy.espn.com/apis/v3/swagger.json - **Current season**: [fantasy.espn.com/apis/v3/games/ffl](https://fantasy.espn.com/apis/v3/games/ffl) - **Player stats in date range**: [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=**YYYYMMDD-YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108) - **Private league**: [fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/**{LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav) ------------------------------------------------------------------------ @@ -348,20 +417,16 @@ This page has been updated a lot in the past 2 years. ```json { "chanceToWinThisWeek": 0.46621, "chanceToWinDivision": 0.228, "projectedWins": 7.899, "projectedLosses": 9.042 } ``` <br> <details><summary>Expand for more</summary> <br> <div id="top"></div> -
Sep 7, 2023 . 1 changed file with 383 additions and 311 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -1,90 +1,81 @@ # List of NFL API Endpoints This page has been updated a lot in the past 2 years. **Older revisions you might like more than this one:** - [**June 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/5e0b844e4d56d0b049747024a04bb7949c2d6c5d#file-extending-espn-api-md) - list of endpoints for other sports/leagues (i.e. basketball, baseball, lacrosse, rugby) - [**August 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce#league-history---get-all-historical-data) - get historical fantasy league data - [**September 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9#file-source-txt) - list of endpoints in plain text - [**December 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/e178f6ed83fe806b4a3913a4ba3e3f59e44c2174) - includes example responses for each endpoint **Additional Resources** - [nfl-nerd](https://github.com/nntrn/nfl-nerd) ([api](https://raw.githubusercontent.com/nntrn/nfl-nerd/master/src/api.js)) - [espn-wiki](https://github.com/nntrn/espn-wiki/wiki) - [ESPN's hidden API endpoints](https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b) - [Using ESPN's new Fantasy API (v3)](https://stmorse.github.io/journal/espn-fantasy-v3.html) - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html) ## API Endpoints - **{YEAR}**: Football season (`YYYY`) - **{SEASONTYPE}**: 1=pre, 2=regular, 3=post, 4=off - **{TEAM_ID}**: 1-32 ([view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams)) - **{ATHLETE_ID}**: [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) - **{LEAGUE_ID}**: Fantasy league id - **{BET_PROVIDER_ID}**: [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers?limit=100) --- ### General: - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**athletes**?limit=1000&active=true](https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32) - **Positions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**positions**?limit=75](https://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](https://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](https://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](https://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](https://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](https://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}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10) (limit is incompatible with team filter) ### Detailed: - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50](https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50) - **Schedule**: [cdn.espn.com/core/nfl/schedule?xhr=1&year=**{YEAR}**&week=**{WEEK_NUM}**](https://cdn.espn.com/core/nfl/schedule?xhr=1&year=2020&week=2) - **Standings**: [cdn.espn.com/core/nfl/standings?xhr=1](https://cdn.espn.com/core/nfl/standings?xhr=1) - **Boxscore**: [cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=**{GAME_ID}**](https://cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=401220225) - **Recap**: [cdn.espn.com/core/nfl/recap?xhr=1&gameId=**{GAME_ID}**](https://cdn.espn.com/core/nfl/recap?xhr=1&gameId=401220225) - **Plays**: [cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=**{GAME_ID}**](https://cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=401220225) - **Game**: [cdn.espn.com/core/nfl/game?xhr=1&gameId=**{GAME_ID}**](https://cdn.espn.com/core/nfl/game?xhr=1&gameId=401127922) - **Matchup**: [cdn.espn.com/core/nfl/matchup?xhr=1&gameId=**{GAME_ID}**](https://cdn.espn.com/core/nfl/matchup?xhr=1&gameId=401220225) ### Odds: @@ -107,8 +98,7 @@ This page has been updated a lot in the past 2 years. - **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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/0/teams/4/odds-records) - **Game odds**: @@ -117,18 +107,20 @@ This page has been updated a lot in the past 2 years. - **QBR Weekly/Game stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/2/weeks/**{WEEK_NUM}**/qbr/10000](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200) ### Teams: - **Teams (Current):** [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) - **Team** [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/1) - **Teams (Season)** [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) @@ -171,13 +163,13 @@ This page has been updated a lot in the past 2 years. - **Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events) - :star: **Game summary**: [site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=**{EVENT_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) - **Play by Plays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/plays?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300) - **Play probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/probabilities?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=300) - **Linescores**: @@ -187,22 +179,22 @@ This page has been updated a lot in the past 2 years. [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/competitors/**{TEAM_ID}**/statistics](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/statistics) - **Roster (get starters)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/competitors/**{TEAM_ID}**/roster](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220225/competitions/401220225/competitors/12/roster) - **Weekly talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEK_NUM}**/talentpicks?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/talentpicks?limit=100) - **Weekly event ids**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEK_NUM}**/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000?limit=100) - **Game officials/judges**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/officials](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/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}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30) ### Athletes: @@ -246,18 +238,19 @@ This page has been updated a lot in the past 2 years. ### Calendar: - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist) - **Whitelist dates**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist](https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/week) - **Weeks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks) @@ -269,19 +262,19 @@ This page has been updated a lot in the past 2 years. ### Scoreboard: - **Events in a season**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYY**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2022) - **Events between dates**: (cannot be more than 13 months) [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYYMMDD-YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20210228) - **Events for a single day**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20181213) - **Season standing**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/groups/**{CONFERENCE_ID}**/standings](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) [AFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings) (CONFERENCE_ID=8) [NFC](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7/standings) (CONFERENCE_ID=7) ### League: @@ -299,6 +292,13 @@ This page has been updated a lot in the past 2 years. [site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl](https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl) ### Search: - [site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix](https://site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix) - [site.web.api.espn.com/apis/common/v3/search](https://site.web.api.espn.com/apis/common/v3/search) ### Fantasy: - [fantasy.espn.com/apis/v3/games/ffl](https://fantasy.espn.com/apis/v3/games/ffl) @@ -307,27 +307,29 @@ This page has been updated a lot in the past 2 years. - [fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/**{LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav) ------------------------------------------------------------------------ - **Get percent owned of every play**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/players?scoringPeriodId=0&view=players_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?scoringPeriodId=0&view=players_wl) ```sh curl -H 'X-Fantasy-Filter: {"filterActive":{"value":true}}' <URL> ``` `X-Fantasy-Filter` is required in the request header to get all active players. Omitting this returns only 50 items ------------------------------------------------------------------------ - **Get player info**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leaguedefaults/3?view=kona_player_info](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/segments/0/leaguedefaults/3?view=kona_player_info) ```sh curl -H 'X-Fantasy-Filter: {"players":{"limit":2000,"sortPercOwned":{"sortPriority":4,"sortAsc":false}}}' <URL> ``` `sortPercOwned` is required with `limit` ------------------------------------------------------------------------ - **Get bye week for all teams**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**?view=proTeamSchedules_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023?view=proTeamSchedules_wl) @@ -337,173 +339,103 @@ This page has been updated a lot in the past 2 years. ``` ## REST API Response Preview ### Get team projection **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/10/projection ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/10/projection", "team": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/10" }, "chanceToWinThisWeek": 0.46621, "chanceToWinDivision": 0.228, "projectedWins": 7.899, "projectedLosses": 9.042 } ``` <br><br> <details><summary>Expand for more</summary> <br><br> <div id="top"></div> **TABLE OF CONTENTS** * [Get team projection](#get-team-projection) * [ATHLETE PROFILE API](#athlete-profile-api) * [ATHLETE BIO API](#athlete-bio-api) * [ATHLETE EVENTLOG API](#athlete-eventlog-api) * [ATHLETE GAMELOG API](#athlete-gamelog-api) * [ATHLETE NOTES API](#athlete-notes-api) * [ATHLETE PROJECTIONS API](#athlete-projections-api) * [ATHLETE SPLITS API](#athlete-splits-api) * [ATHLETE STATISTICS API](#athlete-statistics-api) * [ATHLETE STATISTICSLOG API](#athlete-statisticslog-api) * [ATHLETE STATS API](#athlete-stats-api) * [CALENDAR API](#calendar-api) * [CALENDAR BLACKLIST API](#calendar-blacklist-api) * [CALENDAR WHITELIST API](#calendar-whitelist-api) * [GAME PREDICTION API](#game-prediction-api) * [COMPETITION DRIVES API](#competition-drives-api) * [BETTING ODDS API](#betting-odds-api) * [COMPETITION PLAYS API](#competition-plays-api) * [GETS ALL PLAYS FOR A GAME: API](#gets-all-plays-for-a-game-api) * [COMPETITION PROBABILITIES API](#competition-probabilities-api) * [COMPETITOR ROSTER API](#competitor-roster-api) * [DRAFT ATHLETES API](#draft-athletes-api) * [DRAFT ROUNDS API](#draft-rounds-api) * [DRAFT STATUS API](#draft-status-api) * [EVENTS API](#events-api) * [EVENT COMPETITIONS API](#event-competitions-api) * [FRANCHISES API](#franchises-api) * [GROUP STANDINGS API](#group-standings-api) * [GROUP TEAMS API](#group-teams-api) * [LEADERS API](#leaders-api) * [NEWS API](#news-api) * [ODD PREDICTORS API](#odd-predictors-api) * [POSITIONS API](#positions-api) * [PROVIDERS API](#providers-api) * [SCOREBOARD API](#scoreboard-api) * [SEASONS API](#seasons-api) * [SEASON ATHLETES API](#season-athletes-api) * [SEASON COACHES API](#season-coaches-api) * [SEASON DRAFT API](#season-draft-api) * [SEASON FUTURES API](#season-futures-api) * [SEASON TEAMS API](#season-teams-api) * [SEASON TYPES API](#season-types-api) * [TALENTPICKS API](#talentpicks-api) * [TEAM API](#team-api) * [TEAM ATHLETES API](#team-athletes-api) * [TEAM ATS API](#team-ats-api) * [TEAM ATTENDANCE API](#team-attendance-api) * [TEAM COACHES API](#team-coaches-api) * [TEAM DEPTHCHARTS API](#team-depthcharts-api) * [TEAM EVENTS API](#team-events-api) * [TEAM INJURIES API](#team-injuries-api) * [TEAM LEADERS API](#team-leaders-api) * [TEAM ODDS-RECORDS API](#team-odds-records-api) * [TEAM PROJECTION API](#team-projection-api) * [TEAM RECORD API](#team-record-api) * [TEAM ROSTER API](#team-roster-api) * [TEAM SCHEDULE API](#team-schedule-api) * [TEAM STATISTICS API](#team-statistics-api) * [SEASONTYPE GROUPS API](#seasontype-groups-api) * [SEASONTYPE LEADERS API](#seasontype-leaders-api) * [SEASONTYPE WEEKS API](#seasontype-weeks-api) * [VENUES API](#venues-api) * [WEEKLY EVENTS API](#weekly-events-api) * [WEEKLY QBR API](#weekly-qbr-api) * [WEEKLY TALENTPICKS API](#weekly-talentpicks-api) ### ATHLETE PROFILE API **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876 @@ -565,7 +497,9 @@ This page has been updated a lot in the past 2 years. "weight": 220, ``` [[TOP]](#top) ### ATHLETE BIO API **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/bio @@ -587,7 +521,9 @@ This page has been updated a lot in the past 2 years. "desktop", ``` [[TOP]](#top) ### ATHLETE EVENTLOG API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog @@ -623,7 +559,9 @@ This page has been updated a lot in the past 2 years. }, ``` [[TOP]](#top) ### ATHLETE GAMELOG API **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog @@ -645,7 +583,9 @@ This page has been updated a lot in the past 2 years. { ``` [[TOP]](#top) ### ATHLETE NOTES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/notes @@ -668,7 +608,9 @@ This page has been updated a lot in the past 2 years. } ``` [[TOP]](#top) ### ATHLETE PROJECTIONS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/projections @@ -690,7 +632,9 @@ This page has been updated a lot in the past 2 years. { ``` [[TOP]](#top) ### ATHLETE SPLITS API **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits @@ -712,7 +656,9 @@ This page has been updated a lot in the past 2 years. } ``` [[TOP]](#top) ### ATHLETE STATISTICS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statistics/0 @@ -774,7 +720,9 @@ This page has been updated a lot in the past 2 years. { ``` [[TOP]](#top) ### ATHLETE STATISTICSLOG API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog @@ -796,7 +744,9 @@ This page has been updated a lot in the past 2 years. { ``` [[TOP]](#top) ### ATHLETE STATS API **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/stats @@ -818,7 +768,9 @@ This page has been updated a lot in the past 2 years. } ``` [[TOP]](#top) ### CALENDAR API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar @@ -845,7 +797,9 @@ This page has been updated a lot in the past 2 years. } ``` [[TOP]](#top) ### CALENDAR BLACKLIST API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist @@ -866,7 +820,9 @@ This page has been updated a lot in the past 2 years. "2021-07-23T07:00Z", ``` [[TOP]](#top) ### CALENDAR WHITELIST API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist @@ -887,7 +843,9 @@ This page has been updated a lot in the past 2 years. "2021-08-20T07:00Z", ``` [[TOP]](#top) ### GAME PREDICTION API Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30 @@ -934,7 +892,9 @@ Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/ } ``` [[TOP]](#top) ### COMPETITION DRIVES API http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631 @@ -956,26 +916,41 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "number": 1 ``` [[TOP]](#top) ### BETTING ODDS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds ```json },{ "provider": { "id": "1001", "name": "accuscore", "priority": 0 }, "details": "BAL -7.5", "overUnder": 49, "spread": 7.5, "overOdds": -111, "underOdds": -111, "awayTeamOdds": { "favorite": true, "underdog": false, "moneyLine": -370, "spreadOdds": -111, "team": {} }, "homeTeamOdds": { "favorite": false, "underdog": true, "moneyLine": 280, "spreadOdds": -111, "team": {} }, "moneylineWinner": false, "spreadWinner": false }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003 @@ -998,7 +973,9 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "averageScore": 20.62, ``` [[TOP]](#top) ### COMPETITION PLAYS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631 @@ -1020,7 +997,10 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "period": { ``` [[TOP]](#top) ### GETS ALL PLAYS FOR A GAME: API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?limit=400 ```json @@ -1041,7 +1021,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### COMPETITION PROBABILITIES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631 @@ -1100,7 +1082,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### COMPETITOR ROSTER API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster @@ -1122,7 +1106,9 @@ GETS ALL PLAYS FOR A GAME: "position": { ``` [[TOP]](#top) ### DRAFT ATHLETES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500 @@ -1146,7 +1132,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104933" ``` [[TOP]](#top) ### DRAFT ROUNDS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds @@ -1168,7 +1156,9 @@ GETS ALL PLAYS FOR A GAME: "name": "SELECTION_MADE", ``` [[TOP]](#top) ### DRAFT STATUS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status @@ -1184,7 +1174,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### EVENTS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events @@ -1226,7 +1218,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1" ``` [[TOP]](#top) ### EVENT COMPETITIONS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315 @@ -1247,7 +1241,9 @@ GETS ALL PLAYS FOR A GAME: "necessary": false, ``` [[TOP]](#top) ### FRANCHISES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises @@ -1289,7 +1285,9 @@ GETS ALL PLAYS FOR A GAME: { ``` [[TOP]](#top) ### GROUP STANDINGS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings @@ -1310,7 +1308,9 @@ GETS ALL PLAYS FOR A GAME: "rel": [ ``` [[TOP]](#top) ### GROUP TEAMS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams @@ -1337,7 +1337,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### LEADERS API **URL**: https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021 @@ -1408,7 +1410,9 @@ GETS ALL PLAYS FOR A GAME: "value": 2673, ``` [[TOP]](#top) ### NEWS API **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news @@ -1430,7 +1434,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### ODD PREDICTORS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003/predictors @@ -1461,7 +1467,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### POSITIONS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8 @@ -1499,7 +1507,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### PROVIDERS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003 @@ -1511,7 +1521,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### SCOREBOARD API **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard @@ -1533,7 +1545,9 @@ GETS ALL PLAYS FOR A GAME: "type": 2, ``` [[TOP]](#top) ### SEASONS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons @@ -1575,7 +1589,9 @@ GETS ALL PLAYS FOR A GAME: "endDate": "2022-01-13T07:59Z", ``` [[TOP]](#top) ### SEASON ATHLETES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes @@ -1617,7 +1633,9 @@ GETS ALL PLAYS FOR A GAME: "weight": 217, ``` [[TOP]](#top) ### SEASON COACHES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50 @@ -1674,7 +1692,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### SEASON DRAFT API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft @@ -1696,7 +1716,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds" ``` [[TOP]](#top) ### SEASON FUTURES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures @@ -1738,7 +1760,9 @@ GETS ALL PLAYS FOR A GAME: "team": { ``` [[TOP]](#top) ### SEASON TEAMS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams @@ -1780,7 +1804,9 @@ GETS ALL PLAYS FOR A GAME: "shortDisplayName": "Falcons", ``` [[TOP]](#top) ### SEASON TYPES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types @@ -1827,7 +1853,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### TALENTPICKS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks @@ -1849,7 +1877,9 @@ GETS ALL PLAYS FOR A GAME: "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png", ``` [[TOP]](#top) ### TEAM API **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams @@ -1891,7 +1921,9 @@ GETS ALL PLAYS FOR A GAME: "logos": [ ``` [[TOP]](#top) ### TEAM ATHLETES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes @@ -1913,7 +1945,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### TEAM ATS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/ats @@ -1935,7 +1969,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### TEAM ATTENDANCE API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/attendance @@ -1956,7 +1992,9 @@ GETS ALL PLAYS FOR A GAME: "displayName": "Home Games", ``` [[TOP]](#top) ### TEAM COACHES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/coaches @@ -1970,7 +2008,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### TEAM DEPTHCHARTS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts @@ -1991,7 +2031,9 @@ GETS ALL PLAYS FOR A GAME: "name": "Left Defensive End", ``` [[TOP]](#top) ### TEAM EVENTS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events @@ -2013,7 +2055,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### TEAM INJURIES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries @@ -2035,7 +2079,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### TEAM LEADERS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/leaders @@ -2056,7 +2102,9 @@ GETS ALL PLAYS FOR A GAME: "value": 4052, ``` [[TOP]](#top) ### TEAM ODDS-RECORDS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/odds-records @@ -2078,7 +2126,9 @@ GETS ALL PLAYS FOR A GAME: "abbreviation": "W", ``` [[TOP]](#top) ### TEAM PROJECTION API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/projection @@ -2095,7 +2145,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### TEAM RECORD API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/record @@ -2116,7 +2168,9 @@ GETS ALL PLAYS FOR A GAME: "value": 0.7142857142857143, ``` [[TOP]](#top) ### TEAM ROSTER API **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster @@ -2138,7 +2192,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### TEAM SCHEDULE API **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule @@ -2160,7 +2216,9 @@ GETS ALL PLAYS FOR A GAME: "name": "Falcons", ``` [[TOP]](#top) ### TEAM STATISTICS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics @@ -2202,7 +2260,9 @@ GETS ALL PLAYS FOR A GAME: "name": "general", ``` [[TOP]](#top) ### SEASONTYPE GROUPS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups @@ -2250,7 +2310,9 @@ GETS ALL PLAYS FOR A GAME: } ``` [[TOP]](#top) ### SEASONTYPE LEADERS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders @@ -2285,7 +2347,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` [[TOP]](#top) ### SEASONTYPE WEEKS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks @@ -2327,7 +2391,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20" ``` [[TOP]](#top) ### VENUES API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493 @@ -2348,7 +2414,9 @@ GETS ALL PLAYS FOR A GAME: "href": "https://a.espncdn.com/i/venues/nfl/day/3493.jpg", ``` [[TOP]](#top) ### WEEKLY EVENTS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/events @@ -2370,7 +2438,9 @@ GETS ALL PLAYS FOR A GAME: "count": 14, ``` [[TOP]](#top) ### WEEKLY QBR API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000 @@ -2392,7 +2462,9 @@ GETS ALL PLAYS FOR A GAME: "event": { ``` [[TOP]](#top) ### WEEKLY TALENTPICKS API **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks -
Jun 5, 2023 . 1 changed file with 36 additions and 6 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -1,4 +1,4 @@ # List of NFL API Endpoints This page has been updated a lot in the past 2 years. @@ -16,7 +16,7 @@ This page has been updated a lot in the past 2 years. **Additional Resources** - [nfl-nerd](https://github.com/nntrn/nfl-nerd) - [api](https://raw.githubusercontent.com/nntrn/nfl-nerd/master/src/api.js) - [ESPN's hidden API endpoints](https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b) - [Using ESPN's new Fantasy API (v3)](https://stmorse.github.io/journal/espn-fantasy-v3.html) - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html) @@ -27,7 +27,7 @@ This page has been updated a lot in the past 2 years. > Parameters: > > * **{YEAR}**: Football season (`YYYY`) > * **{SEASONTYPE}**: 1=pre, 2=regular, 3=post, 4=off > * **{TEAM_ID}**: 1-32 ([view all][all_team_id]) > * **{ATHLETE_ID}**: [view all][all_athlete_id] > * **{LEAGUE_ID}**: Fantasy league id @@ -177,13 +177,13 @@ This page has been updated a lot in the past 2 years. - **Detailed plays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/plays?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300) - **Probabilities (play)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/probabilities?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=300) - **Linescores**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/competitors/**{TEAM_ID}**/linescores](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/linescores) - **Scoring & All Splits**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/competitors/**{TEAM_ID}**/statistics](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/statistics) - **Roster (get starters)**: @@ -307,6 +307,36 @@ This page has been updated a lot in the past 2 years. - [fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/**{LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav) --- - **Get percent owned of every play**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/players?scoringPeriodId=0&view=players_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/players?scoringPeriodId=0&view=players_wl) ```sh curl -H 'X-Fantasy-Filter: {"filterActive":{"value":true}}' <URL> ``` `X-Fantasy-Filter` is required in the request header to get all active players. Omitting this returns only 50 items --- - **Get player info**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**/segments/0/leaguedefaults/3?view=kona_player_info](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023/segments/0/leaguedefaults/3?view=kona_player_info) ```sh curl -H 'X-Fantasy-Filter: {"players":{"limit":2000,"sortPercOwned":{"sortPriority":4,"sortAsc":false}}}' <URL> ``` `sortPercOwned` is required with `limit` --- - **Get bye week for all teams**: [fantasy.espn.com/apis/v3/games/ffl/seasons/**{YEAR}**?view=proTeamSchedules_wl](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2023?view=proTeamSchedules_wl) ```sh jq '.settings.proTeams|map({name,byeWeek})' ``` ### Search: -
May 31, 2023 . 1 changed file with 319 additions and 839 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -1,160 +1,169 @@ # ESPN API Cheatsheet for NFL This page has been updated a lot in the past 2 years. **Older revisions you might like more than this one:** * [**June 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/5e0b844e4d56d0b049747024a04bb7949c2d6c5d) - list of [ESPN endpoints for other sports/leagues][espn_api_leagues] (basketball, baseball, MMA, lacrosse, rugby) * [**August 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/9daed3db02cc2661e63ea08741c6053c5aef28ce) - historical fantasy data and notes on combining views * [**September 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/2fa98612cedcbad033d4206b16cd360c9b654ae9) - [source.txt][source_txt] file listing all endpoints * [**December 2021**](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/e178f6ed83fe806b4a3913a4ba3e3f59e44c2174) - data response preview for endpoints [source_txt]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/2fa98612cedcbad033d4206b16cd360c9b654ae9/source.txt [espn_api_leagues]: https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/5e0b844e4d56d0b049747024a04bb7949c2d6c5d/extending-espn-api.md **Additional Resources** - [nfl-nerd](https://github.com/nntrn/nfl-nerd) - [ESPN's hidden API endpoints](https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b) - [Using ESPN's new Fantasy API (v3)](https://stmorse.github.io/journal/espn-fantasy-v3.html) - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html) ## API Endpoints > Parameters: > > * **{YEAR}**: Football season (`YYYY`) > * **{SEASONTYPE}**: 1=pre, 2=regular, 3=post, 4=off > * **{TEAM_ID}**: 1-32 ([view all][all_team_id]) > * **{ATHLETE_ID}**: [view all][all_athlete_id] > * **{LEAGUE_ID}**: Fantasy league id > * **{BET_PROVIDER_ID}**: [view all][all_providers_id] > ### Current: - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**athletes**?limit=1000&active=true][current_Athletes] - **Team** (list of IDs): [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**teams**?limit=32][current_Teams] - **Team** (with more details): [https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams](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][current_Positions] - **Venues**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**venues**?limit=700][current_Venues] - **Leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**leaders**?limit=100][current_Leaders] - **Seasons**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**seasons**?limit=100][current_Seasons] - **Franchises**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**franchises**?limit=50][current_Franchises] - **News**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?limit=50][current_news_limit] - **Team News**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?team=**{TEAM_ID}**][current_news_team] (limit is incompatible with team filter) ### Detailed: - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50][detailed_Scoreboard] - **Schedule**: [cdn.espn.com/core/nfl/schedule?xhr=1&year=**{YEAR}**&week=**{WEEK_NUM}**][detailed_Schedule] - **Standings**: [cdn.espn.com/core/nfl/standings?xhr=1][detailed_Standings] - **Boxscore**: [cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=**{GAME_ID}**][detailed_Boxscore] - **Recap**: [cdn.espn.com/core/nfl/recap?xhr=1&gameId=**{GAME_ID}**][detailed_Recap] - **Plays**: [cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=**{GAME_ID}**][detailed_Plays] - **Game**: [cdn.espn.com/core/nfl/game?xhr=1&gameId=**{GAME_ID}**][detailed_Game] - **Matchup**: [cdn.espn.com/core/nfl/matchup?xhr=1&gameId=**{GAME_ID}**][detailed_Matchup] ### Odds: - **Win probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/probabilities?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200) - **Odds**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/odds](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds) - **Matchup Quality & Game Projection**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{EVENT_ID}**/competitions/**{EVENT_ID}**/predictor](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/predictor) - **Against-the-spread**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/2/teams/**{TEAM_ID}**/ats](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/teams/26/ats) - **Futures**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/futures](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/0/teams/4/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/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][past_performances] ### Teams: - [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) - [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/1) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) - **Season Leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/leaders](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) - **Record**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/teams/**{TEAM_ID}**/record](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/2/teams/6/record) - **Depthcharts**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/depthcharts](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts) - **Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**/roster](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/roster) - **Detailed Team**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**?**enable=roster,projection,stats**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4?enable=roster,projection,stats) - **Roster w/ stats**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**?**enable=roster**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3?enable=roster,projection,stats) - **Schedule**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**{TEAM_ID}**/schedule](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule)[`?season=`**{YEAR}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule?season=2019) - **Injuries**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**{TEAM_ID}**/injuries](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/injuries?limit=100) - **Statistics**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/teams/**{TEAM_ID}**/statistics](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/24/statistics) - **Past performance**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**{TEAM_ID}**/odds/**{BET_PROVIDER_ID}**/past-performances?limit=140](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/odds/1002/past-performances?limit=140) - **Projection**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/teams/**{TEAM_ID}**/projection](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/projection) ### Games: @@ -163,36 +172,37 @@ Name | Description [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://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}**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) - **Detailed plays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/plays?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300) - **Probabilities (play)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/probabilities?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=300) - **Linescores**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/competitors/**{TEAM_ID}**/linescores](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/linescores) - **Scoring & All Splits**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/competitors/**{TEAM_ID}**/statistics](http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437932/competitions/401437932/competitors/6/statistics) - **Roster (get starters)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/competitors/**{TEAM_ID}**/roster][games_roster] - **Weekly talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEK_NUM}**/talentpicks?limit=100][games_talentpicks] - **Weekly event ids**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks/**{WEEK_NUM}**/events][games_weekly_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][games_QBR] - **Game officials/judges**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**{GAME_ID}**/competitions/**{GAME_ID}**/officials][game_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}**][game_predicted_win_percentage] ### Athletes: @@ -201,34 +211,37 @@ Name | Description [sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders](https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) - **Talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks](https://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](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog) - **Coaches**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/coaches?limit=50](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/coaches?limit=50) - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes](https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog) - **statisticslog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/**{ATHLETE_ID}**/statisticslog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2576336/statisticslog) - **Athlete Overview**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**{ATHLETE_ID}**/overview](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/overview) - **Free agents**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/freeagents](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/freeagents) - **Draft**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/draft](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft) - **Draft rounds**: [site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=**{YEAR}**&draft_round=1](https://site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=2023&draft_round=1) ### Calendar: @@ -244,38 +257,40 @@ Name | Description - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist][whitelist] - **All weeks in given season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks][all_weeks_season] - **Weeks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/weeks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks) - **Season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021) ### Scoreboard: - **Events in a season**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYY**][scoreboard_YYYY] - **Events between dates**: (cannot be >13 months) [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYYMMDD-YYYYMMDD**][scoreboard_YYYYMMDD_YYYYMMDD] - **Events for a single day**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD**][scoreboard_YYYYMMDD] - **Season standing**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**{YEAR}**/types/**{SEASONTYPE}**/groups/**{CONFERENCE_ID}**/standings][AFC_season_standing] - [AFC][AFC_season_standing] (CONFERENCE_ID=8) - [NFC][NFC_season_standing] (CONFERENCE_ID=7) ### League: - **Transactions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions](https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4/groups) - **Franchises**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises) @@ -284,14 +299,13 @@ Name | Description [site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl](https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl) ### Fantasy: - [fantasy.espn.com/apis/v3/games/ffl](https://fantasy.espn.com/apis/v3/games/ffl) - [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=**YYYYMMDD-YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108) - [fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/**{LEAGUE_ID}**](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav) ### Search: @@ -300,18 +314,52 @@ Name | Description - [site.web.api.espn.com/apis/common/v3/search](https://site.web.api.espn.com/apis/common/v3/search) --- [current_Athletes]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true [current_Teams]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32 [current_Positions]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75 [current_Venues]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues?limit=700 [current_news_limit]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50 [current_news_team]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10 [current_Leaders]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders?limit=100 [current_Seasons]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons?limit=100 [current_Franchises]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises?limit=50 [detailed_Scoreboard]: https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50 [detailed_Schedule]: https://cdn.espn.com/core/nfl/schedule?xhr=1&year=2020&week=2 [detailed_Standings]: https://cdn.espn.com/core/nfl/standings?xhr=1 [detailed_Boxscore]: https://cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=401220225 [detailed_Recap]: https://cdn.espn.com/core/nfl/recap?xhr=1&gameId=401220225 [detailed_Plays]: https://cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=401220225 [detailed_Game]: https://cdn.espn.com/core/nfl/game?xhr=1&gameId=401127922 [detailed_Matchup]: https://cdn.espn.com/core/nfl/matchup?xhr=1&gameId=401220225 [games_talentpicks]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/talentpicks?limit=100 [games_roster]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220225/competitions/401220225/competitors/12/roster [games_weekly_events]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1/events [games_QBR]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000?limit=100 [game_officials]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/officials [game_predicted_win_percentage]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30 [scoreboard_YYYYMMDD]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20181213 [scoreboard_YYYY]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2022 [scoreboard_YYYYMMDD_YYYYMMDD]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20210228 [AFC_season_standing]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8/standings [NFC_season_standing]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7/standings [all_team_id]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams [all_athlete_id]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true [all_providers_id]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers?limit=100 [past_performances]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200 [calendar]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar [ondays]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays [offdays]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays [blacklist]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist [whitelist]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist [all_weeks_season]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/week ## REST API Response Preview <details><summary>Expand</summary> **URL**: https://site.web.api.espn.com/apis/common/v3/search?limit=100&query=nfl ```json { @@ -334,14 +382,7 @@ Name | Description "abbreviation": "NFL", ``` **URL**: https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108 ```json { @@ -361,14 +402,7 @@ Name | Description "3": 379, ``` **URL**: https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl ```json { @@ -406,14 +440,7 @@ Name | Description "seasonEndDate": "2022-01-13T07:59:00Z", ``` **URL**: https://sports.core.api.espn.com/v3/colleges/2509 ```json { @@ -426,14 +453,7 @@ Name | Description } ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl ```json { @@ -453,16 +473,9 @@ Name | Description "endDate": "2022-02-16T07:59Z", ``` ### ATHLETES **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876 ```json { @@ -482,14 +495,7 @@ Name | Description "language": "en", ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000 ```json { @@ -499,24 +505,17 @@ Name | Description "pageCount": 5, "items": [ { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2576336" }, { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3049325" }, { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3915373" }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876 ```json { @@ -536,16 +535,9 @@ Name | Description "weight": 220, ``` ### ATHLETE BIO **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/bio ```json { @@ -565,45 +557,45 @@ Name | Description "desktop", ``` ### ATHLETE EVENTLOG **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog", "teams": { "10": { "team": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/teams/10" }, "id": "10" } }, "events": { "count": 17, "pageIndex": 1, "pageSize": 25, "pageCount": 1, "items": [ { "event": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640" }, "competition": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640" }, "statistics": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640/competitors/10/roster/14876/statistics/0" }, "teamId": "10", "played": true }, ``` ### ATHLETE GAMELOG **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog ```json { @@ -623,16 +615,9 @@ Name | Description { ``` ### ATHLETE NOTES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/notes ```json { @@ -653,16 +638,9 @@ Name | Description } ``` ### ATHLETE PROJECTIONS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/projections ```json { @@ -682,16 +660,9 @@ Name | Description { ``` ### ATHLETE SPLITS **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits ```json { @@ -711,16 +682,9 @@ Name | Description } ``` ### ATHLETE STATISTICS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statistics/0 ```json { @@ -740,14 +704,7 @@ Name | Description "abbreviation": "gen", ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics ```json { @@ -767,14 +724,7 @@ Name | Description { ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0 ```json { @@ -794,16 +744,9 @@ Name | Description { ``` ### ATHLETE STATISTICSLOG **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog ```json { @@ -823,16 +766,9 @@ Name | Description { ``` ### ATHLETE STATS **URL**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/stats ```json { @@ -852,16 +788,9 @@ Name | Description } ``` ### CALENDAR **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar ```json { @@ -886,16 +815,9 @@ Name | Description } ``` ### CALENDAR BLACKLIST **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist ```json { @@ -914,16 +836,9 @@ Name | Description "2021-07-23T07:00Z", ``` ### CALENDAR WHITELIST **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist ```json { @@ -942,17 +857,57 @@ Name | Description "2021-08-20T07:00Z", ``` ### GAME PREDICTION Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30 ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30?lang=en®ion=us", "team": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/teams/30?lang=en®ion=us" }, "season": 2022, "stats": [ { "name": "teampredptdiff", "displayName": "PRED PT DIFF", "description": "Expected margin of victory for the FPI favorite.", "abbreviation": "PRED PT DIFF", "value": 12.175, "displayValue": "12.2" }, { "name": "gameprojection", "displayName": "WIN PROB", "description": "Team's predicted win percentage in this game at time of given BPI run", "abbreviation": "GAME PROJ", "value": 84.81, "displayValue": "84.8%" }, { "name": "matchupquality", "displayName": "MATCHUP QUALITY", "description": "A measure of projected competitiveness and excitement in the game, using a 0 to 100 scale, with 100 as the most exciting", "abbreviation": "MATCHUP QUALITY", "value": 35.261, "displayValue": "35.3" }, { "name": "teamadjgamescore", "displayName": "GAME SCORE", "description": "A measure of how well a team performed compared to their expected performance and the expected performance of a typical top 25 team.", "abbreviation": "TEAM ADJ GAMESCORE", "displayValue": "" } ] } ``` ### COMPETITION DRIVES http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631 ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631", @@ -971,16 +926,9 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "number": 1 ``` ### COMPETITION ODDS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds ```json { @@ -1000,14 +948,7 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "overUnder": 49.5, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003 ```json { @@ -1027,16 +968,9 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "averageScore": 20.62, ``` ### COMPETITION PLAYS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631 ```json { @@ -1056,15 +990,8 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "period": { ``` GETS ALL PLAYS FOR A GAME: **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?limit=400 ```json { @@ -1084,16 +1011,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### COMPETITION PROBABILITIES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631 ```json { @@ -1113,14 +1033,7 @@ GETS ALL PLAYS FOR A GAME: "tiePercentage": 0, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=200 ```json { @@ -1157,16 +1070,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### COMPETITOR ROSTER **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster ```json { @@ -1186,16 +1092,9 @@ GETS ALL PLAYS FOR A GAME: "position": { ``` ### DRAFT ATHLETES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500 ```json { @@ -1217,16 +1116,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104933" ``` ### DRAFT ROUNDS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds ```json { @@ -1246,16 +1138,9 @@ GETS ALL PLAYS FOR A GAME: "name": "SELECTION_MADE", ``` ### DRAFT STATUS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status ```json { @@ -1269,16 +1154,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### EVENTS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events ```json { @@ -1298,14 +1176,7 @@ GETS ALL PLAYS FOR A GAME: "count": 16, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 ```json { @@ -1325,16 +1196,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1" ``` ### EVENT COMPETITIONS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315 ```json { @@ -1353,16 +1217,9 @@ GETS ALL PLAYS FOR A GAME: "necessary": false, ``` ### FRANCHISES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises ```json { @@ -1382,14 +1239,7 @@ GETS ALL PLAYS FOR A GAME: }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1 ```json { @@ -1409,16 +1259,9 @@ GETS ALL PLAYS FOR A GAME: { ``` ### GROUP STANDINGS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings ```json { @@ -1437,16 +1280,9 @@ GETS ALL PLAYS FOR A GAME: "rel": [ ``` ### GROUP TEAMS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams ```json { @@ -1469,18 +1305,11 @@ GETS ALL PLAYS FOR A GAME: } ] } ``` ### LEADERS **URL**: https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021 ```json "leaders": { @@ -1509,14 +1338,7 @@ GETS ALL PLAYS FOR A GAME: "fullName": "Patrick Mahomes", ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders ```json { @@ -1536,14 +1358,7 @@ GETS ALL PLAYS FOR A GAME: "value": 2673, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0 ```json { @@ -1563,16 +1378,9 @@ GETS ALL PLAYS FOR A GAME: "value": 2673, ``` ### NEWS **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news ```json { @@ -1592,16 +1400,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### ODD PREDICTORS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003/predictors ```json { @@ -1630,16 +1431,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### POSITIONS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8 ```json { @@ -1655,14 +1449,7 @@ GETS ALL PLAYS FOR A GAME: } ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100 ```json { @@ -1682,16 +1469,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### PROVIDERS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003 ```json { @@ -1701,16 +1481,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### SCOREBOARD **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard ```json { @@ -1730,16 +1503,9 @@ GETS ALL PLAYS FOR A GAME: "type": 2, ``` ### SEASONS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons ```json { @@ -1759,14 +1525,7 @@ GETS ALL PLAYS FOR A GAME: }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021 ```json { @@ -1786,16 +1545,9 @@ GETS ALL PLAYS FOR A GAME: "endDate": "2022-01-13T07:59Z", ``` ### SEASON ATHLETES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes ```json { @@ -1815,14 +1567,7 @@ GETS ALL PLAYS FOR A GAME: }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876 ```json { @@ -1842,16 +1587,9 @@ GETS ALL PLAYS FOR A GAME: "weight": 217, ``` ### SEASON COACHES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50 ```json { @@ -1871,14 +1609,7 @@ GETS ALL PLAYS FOR A GAME: }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695 ```json { @@ -1913,16 +1644,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### SEASON DRAFT **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft ```json { @@ -1942,16 +1666,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds" ``` ### SEASON FUTURES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures ```json { @@ -1971,14 +1688,7 @@ GETS ALL PLAYS FOR A GAME: "name": "DraftKings", ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561 ```json { @@ -1998,16 +1708,9 @@ GETS ALL PLAYS FOR A GAME: "team": { ``` ### SEASON TEAMS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams ```json { @@ -2027,14 +1730,7 @@ GETS ALL PLAYS FOR A GAME: }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12 ```json { @@ -2054,16 +1750,9 @@ GETS ALL PLAYS FOR A GAME: "shortDisplayName": "Falcons", ``` ### SEASON TYPES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types ```json { @@ -2088,14 +1777,7 @@ GETS ALL PLAYS FOR A GAME: } ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2 ```json { @@ -2115,16 +1797,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### TALENTPICKS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks ```json { @@ -2144,16 +1819,9 @@ GETS ALL PLAYS FOR A GAME: "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png", ``` ### TEAM **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams ```json { @@ -2173,14 +1841,7 @@ GETS ALL PLAYS FOR A GAME: "slug": "nfl", ``` **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12 ```json { @@ -2200,16 +1861,9 @@ GETS ALL PLAYS FOR A GAME: "logos": [ ``` ### TEAM ATHLETES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes ```json { @@ -2229,16 +1883,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### TEAM ATS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/ats ```json { @@ -2258,16 +1905,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### TEAM ATTENDANCE **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/attendance ```json { @@ -2286,16 +1926,9 @@ GETS ALL PLAYS FOR A GAME: "displayName": "Home Games", ``` ### TEAM COACHES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/coaches ```json { @@ -2307,16 +1940,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### TEAM DEPTHCHARTS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts ```json { @@ -2335,16 +1961,9 @@ GETS ALL PLAYS FOR A GAME: "name": "Left Defensive End", ``` ### TEAM EVENTS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events ```json { @@ -2364,16 +1983,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### TEAM INJURIES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries ```json { @@ -2393,16 +2005,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### TEAM LEADERS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/leaders ```json { @@ -2421,16 +2026,9 @@ GETS ALL PLAYS FOR A GAME: "value": 4052, ``` ### TEAM ODDS-RECORDS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/odds-records ```json { @@ -2450,16 +2048,9 @@ GETS ALL PLAYS FOR A GAME: "abbreviation": "W", ``` ### TEAM PROJECTION **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/projection ```json { @@ -2474,16 +2065,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### TEAM RECORD **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/record ```json { @@ -2502,16 +2086,9 @@ GETS ALL PLAYS FOR A GAME: "value": 0.7142857142857143, ``` ### TEAM ROSTER **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster ```json { @@ -2531,16 +2108,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### TEAM SCHEDULE **URL**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule ```json { @@ -2560,16 +2130,9 @@ GETS ALL PLAYS FOR A GAME: "name": "Falcons", ``` ### TEAM STATISTICS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics ```json { @@ -2589,14 +2152,7 @@ GETS ALL PLAYS FOR A GAME: "name": "general", ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0 ```json { @@ -2616,16 +2172,9 @@ GETS ALL PLAYS FOR A GAME: "name": "general", ``` ### SEASONTYPE GROUPS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups ```json { @@ -2644,14 +2193,7 @@ GETS ALL PLAYS FOR A GAME: } ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1 ```json { @@ -2678,16 +2220,9 @@ GETS ALL PLAYS FOR A GAME: } ``` ### SEASONTYPE LEADERS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders ```json { @@ -2720,16 +2255,9 @@ GETS ALL PLAYS FOR A GAME: }, ``` ### SEASONTYPE WEEKS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks ```json { @@ -2749,14 +2277,7 @@ GETS ALL PLAYS FOR A GAME: }, ``` **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6 ```json { @@ -2776,16 +2297,9 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20" ``` ### VENUES **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493 ```json { @@ -2804,16 +2318,9 @@ GETS ALL PLAYS FOR A GAME: "href": "https://a.espncdn.com/i/venues/nfl/day/3493.jpg", ``` ### WEEKLY EVENTS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/events ```json { @@ -2833,16 +2340,9 @@ GETS ALL PLAYS FOR A GAME: "count": 14, ``` ### WEEKLY QBR **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000 ```json { @@ -2862,16 +2362,9 @@ GETS ALL PLAYS FOR A GAME: "event": { ``` ### WEEKLY TALENTPICKS **URL**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks ```json { @@ -2892,16 +2385,3 @@ GETS ALL PLAYS FOR A GAME: ``` </details> -
May 26, 2023 . 1 changed file with 228 additions and 108 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -18,185 +18,294 @@ This page is limited to NFL endpoints but can be refashioned for other sports le Name | Description :------------------|:------------- `:YEAR` | Integer year in which the season started (`YYYY`) `:SEASONTYPE` | 1=pre, 2=regular, 3=post, 4=off `: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 `:TEAM_ID` | 1-32 ([view all][all_team_id]) `:ATHLETE_ID` | [view all][all_athlete_id] ### Current: - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**athletes**?limit=1000&active=true][current_Athletes] - **Teams**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**teams**?limit=32][current_Teams] - **Positions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**positions**?limit=75][current_Positions] - **Venues**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**venues**?limit=700][current_Venues] - **News**: [site.api.espn.com/apis/site/v2/sports/football/nfl/**news**?limit=50][current_News] - **Leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**leaders**?limit=100][current_Leaders] - **Seasons**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**seasons**?limit=100][current_Seasons] - **Franchises**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/**franchises**?limit=50][current_Franchises] [current_Athletes]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true [current_Teams]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32 [current_Positions]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75 [current_Venues]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues?limit=700 [current_News]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50 [current_Leaders]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders?limit=100 [current_Seasons]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons?limit=100 [current_Franchises]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises?limit=50 ### Detailed: - **Scoreboard**: [cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50][detailed_Scoreboard] - **Schedule**: [cdn.espn.com/core/nfl/schedule?xhr=1&year=**:YEAR**&week=**:WEEK_NUM**][detailed_Schedule] - **Standings**: [cdn.espn.com/core/nfl/standings?xhr=1][detailed_Standings] - **Boxscore**: [cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=**:GAME_ID**][detailed_Boxscore] - **Recap**: [cdn.espn.com/core/nfl/recap?xhr=1&gameId=**:GAME_ID**][detailed_Recap] - **Plays**: [cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=**:GAME_ID**][detailed_Plays] - **Game**: [cdn.espn.com/core/nfl/game?xhr=1&gameId=**:GAME_ID**][detailed_Game] - **Matchup**: [cdn.espn.com/core/nfl/matchup?xhr=1&gameId=**:GAME_ID**][detailed_Matchup] [detailed_Scoreboard]: https://cdn.espn.com/core/nfl/scoreboard?xhr=1&limit=50 [detailed_Schedule]: https://cdn.espn.com/core/nfl/schedule?xhr=1&year=2020&week=2 [detailed_Standings]: https://cdn.espn.com/core/nfl/standings?xhr=1 [detailed_Boxscore]: https://cdn.espn.com/core/nfl/boxscore?xhr=1&gameId=401220225 [detailed_Recap]: https://cdn.espn.com/core/nfl/recap?xhr=1&gameId=401220225 [detailed_Plays]: https://cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=401220225 [detailed_Game]: https://cdn.espn.com/core/nfl/game?xhr=1&gameId=401127922 [detailed_Matchup]: https://cdn.espn.com/core/nfl/matchup?xhr=1&gameId=401220225 ### Odds: - **Win probabilities**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:EVENT_ID**/competitions/**:EVENT_ID**/probabilities?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200) - **Odds**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:EVENT_ID**/competitions/**:EVENT_ID**/odds](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds) - **Against-the-spread**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/2/teams/**:TEAM_ID**/ats](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/teams/26/ats) - **Futures**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/futures](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/head-to-heads) - **Odds records**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/0/teams/**:TEAM_ID**/odds-records](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/0/teams/4/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/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][past_performances] ### Teams: - [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) - [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:TEAM_ID**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/1) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/teams](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams) - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/teams/**:TEAM_ID**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) - **Record**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/teams/**:TEAM_ID**/record](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/2/teams/6/record) - **Depthcharts**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/teams/**:TEAM_ID**/depthcharts](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts) - **Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:TEAM_ID**/roster](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/roster) - **Detailed Team**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:TEAM_ID**?**enable=roster,projection,stats**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4?enable=roster,projection,stats) - **Roster w/ stats**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:TEAM_ID**?**enable=roster**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3?enable=roster,projection,stats) - **Schedule**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:TEAM_ID**/schedule](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule)[`?season=`**:YEAR**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule?season=2019) - **Injuries**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**:TEAM_ID**/injuries](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/injuries?limit=100) - **Statistics**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/teams/**:TEAM_ID**/statistics](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/24/statistics) - **Past performance**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**:TEAM_ID**/odds/**:BET_PROVIDER_ID**/past-performances?limit=140](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/odds/1002/past-performances?limit=140) - **Projection**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/teams/**:TEAM_ID**/projection](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/projection) ### Games: - **Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://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**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) - **Detailed plays**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:GAME_ID**/competitions/**:GAME_ID**/plays?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300) - **Probabilities (play)** [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:GAME_ID**/competitions/**:GAME_ID**/probabilities?limit=300](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=300) - **Weeks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/weeks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks) - **Season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021) - **Event roster (get starter data)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:GAME_ID**/competitions/**:GAME_ID**/competitors/**:TEAM_ID**/roster][games_roster] - **Weekly talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/weeks/**:WEEK_NUM**/talentpicks?limit=100][games_talentpicks] - **Weekly event ids**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/weeks/**:WEEK_NUM**/events][games_weekly_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][games_QBR] [games_talentpicks]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/talentpicks?limit=100 [games_roster]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220225/competitions/401220225/competitors/12/roster [games_weekly_events]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1/events [games_QBR]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000?limit=100 ### Athletes: - **Current leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders](https://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](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) - **Talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks](https://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](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog) - **Coaches**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/coaches?limit=50](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/coaches?limit=50) - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes) - **statisticslog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/**:ATHLETE_ID**/statisticslog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2576336/statisticslog) - **Athlete Overview**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**:ATHLETE_ID**/overview](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/overview) - **Free agents**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/freeagents](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/freeagents) - **Draft**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/draft](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft) - **Draft rounds**: [site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=**:YEAR**&draft_round=1](https://site.web.api.espn.com/apis/v2/scoreboard/header?draft_year=2023&draft_round=1) ### Calendar: - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar][calendar] - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays][ondays] - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays][offdays] - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist][blacklist] - [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist][whitelist] - **All weeks in given season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/weeks][all_weeks_season] ### Scoreboard: - **Events in a season**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYY**][scoreboard_YYYY] - **Events between dates**: (cannot be >13 months) [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=**YYYYMMDD-YYYYMMDD**][scoreboard_YYYYMMDD_YYYYMMDD] - **Events for a single day**: [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD**][scoreboard_YYYYMMDD] [scoreboard_YYYYMMDD]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20181213 [scoreboard_YYYY]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2022 [scoreboard_YYYYMMDD_YYYYMMDD]: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20210228 ### League: - **Transactions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions) - **Group**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/groups/**:GROUP_ID**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4/groups/9) - **Groups**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:YEAR**/types/**:SEASONTYPE**/groups](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4/groups) - **Franchises**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises](https://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](https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl) ### Fantasy: - [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=**YYYYMMDD-YYYYMMDD**](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108) - [fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav](https://fantasy.espn.com/apis/v3/games/ffl/seasons/2019/segments/0/leagues/1241838?view=mDraftDetail&view=mLiveScoring&view=mMatchupScore&view=mPendingTransactions&view=mPositionalRatings&view=mSettings&view=mTeam&view=modular&view=mNav) - https://fantasy.espn.com/apis/v3/games/ffl ### Search: - [site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix](https://site.web.api.espn.com/apis/common/v3/search?query=nfl&limit=5&mode=prefix) - [site.web.api.espn.com/apis/common/v3/search](https://site.web.api.espn.com/apis/common/v3/search) --- --- <details><summary>View more</summary> /apis/common/v3/search @@ -1818,7 +1927,7 @@ GETS ALL PLAYS FOR A GAME: ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft", "uid": "s:20~l:28~e:DRAFT~y:2021", "year": 2021, "numberOfRounds": 7, "displayName": "2021 National Football League Draft", @@ -2784,4 +2893,15 @@ GETS ALL PLAYS FOR A GAME: </details> </details> [all_team_id]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams [all_athlete_id]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true [past_performances]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200 [calendar]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar [ondays]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays [offdays]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays [blacklist]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist [whitelist]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist [all_weeks_season]: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/week -
May 16, 2023 . 1 changed file with 758 additions and 253 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -1,11 +1,31 @@ # 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](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c) This page is limited to NFL endpoints but can be refashioned for other sports leagues (i.e. `/sports/football/leagues/nfl/` => `/sports/baseball/leagues/mlb/`) ## Additional Resources / Further Reading - [nfl-nerd](https://github.com/nntrn/nfl-nerd) - [ESPN's hidden API endpoints](https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b) - [Using ESPN's new Fantasy API (v3)](https://stmorse.github.io/journal/espn-fantasy-v3.html) - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html) --- ## Parameters Name | Description :------------------|:------------- `:year` | Integer year in which the season started (`YYYY`) `:seasontype` | 1=pre, 2=regular, 3=post `: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 `:team_id` | 1-32 ([view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams)) `:athlete_id` | [view all](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true) ## Getting started API for getting ids: @@ -14,128 +34,176 @@ API for getting ids: - **Positions**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75 - **Venues**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues?limit=700 Odds: * **Win probabilities:** [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:game_id**/competitions/**:game_id**/probabilities?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200) * **Odds**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:game_id**/competitions/**:game_id**/odds](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds) * **Against-the-spread**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/types/2/teams/**:team_id**/ats](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/teams/26/ats) * **Futures**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/futures](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/futures) * **Head-to-head (game)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:game_id**/competitions/**:game_id**/odds/**:bet_provider_id**/head-to-heads](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/head-to-heads) * **Odds records**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/types/0/teams/**:team_id**/odds-records](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/0/teams/4/odds-records) * **Game odds**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/**:bet_provider_id**/history/0/movement?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/history/0/movement?limit=100) * **Team odds**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**:team_id**/odds/**:bet_provider_id**/past-performances?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200) * **Positions (enum)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100) * **QBR Weekly/Game stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/types/2/weeks/**:week_num**/qbr/10000](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000) * **Past performances**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**:team_id**/odds/**:bet_provider_id**/past-performances?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=134) Teams: * [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams)[**/:team_id**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/1) * [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/teams](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams)[**/:team_id**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24) * [site.api.espn.com/apis/site/v2/sports/football/nfl/teams](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams) - **Depthcharts**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/teams/**:team_id**/depthcharts](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts) * **Roster**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:team_id**/roster](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/roster)[`?enable=roster,projection,stats`](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4?enable=roster,projection,stats) - **Roster w/ stats**:[site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:team_id**?**enable=roster**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3?enable=roster,projection,stats) * **Schedule**: [site.api.espn.com/apis/site/v2/sports/football/nfl/teams/**:team_id**/schedule](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule)[`?season=`**:year**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule?season=2019) - **Injuries**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**:team_id**/injuries](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/injuries?limit=100) - **Statistics**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/types/**:seasontype**/teams/**:team_id**/statistics](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/24/statistics) - **Past performance**:[sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**:team_id**/odds/1002/past-performances?limit=140](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/odds/1002/past-performances?limit=140) - **Projection**:[sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/teams/**:team_id**/projection](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/projection) Games: * **Game summary**: [site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=**:game_id**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315) * **News**: [site.api.espn.com/apis/site/v2/sports/football/nfl/news](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?limit=50&page=1) - **Weeks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/types/**:seasontype**/weeks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks?lang=en®ion=us) - **Season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021) - **Events**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events) - **get game ids**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/types/**:seasontype**/weeks/**:week**/events](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1/events?lang=en®ion=us) - **Draft**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/draft](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft) - **free agents**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/freeagents](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/freeagents) - **calendar**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar) - **current season game dates**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist) - **blacklist**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist) - **whitelist**: http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist League: - **transactions**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions) - **group**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/types/**:seasontype**/groups/**:group_id**](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4/groups/9) - **groups**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/types/**:seasontype**/groups](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4/groups) - **franchises**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises) Scoreboard: * [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20180901) * [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYYMMDD-YYYYMMDD**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20180901-20181001) * [site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=**YYYY**](https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=2018) * **All weeks in given season**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/types/**:seasontype**/weeks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks) Performance: - **Current leaders**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders) * **Leaders (filter)**: [site.api.espn.com/apis/site/v3/sports/football/nfl/leaders`{?season,seasontype}`](https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021&seasontype=2) * **Leaders (year):** [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:year**/types/**:seasontype**/leaders](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders) - **Talent picks**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks) - **Athletes**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes)[`?limits=200`](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=200) - **statisticslog**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2/statisticslog](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2/statisticslog) - **Athlete Overview**: [site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/**:athlete_id**/overview](https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/overview) Search: * [site.web.api.espn.com/apis/common/v3/search?region=us&lang=en&query=nfl&limit=5&mode=prefix](https://site.web.api.espn.com/apis/common/v3/search?region=us&lang=en&query=nfl&limit=5&mode=prefix) * [site.web.api.espn.com/apis/common/v3/search](https://site.web.api.espn.com/apis/common/v3/search) * [site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?**dates={YYYYMMDD}-{YYYYMMDD}**&pbpOnly=true](https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108&pbpOnly=true) * **News**: [site.api.espn.com/apis/site/v2/sports/football/nfl/news](https://site.api.espn.com/apis/site/v2/sports/football/nfl/news) * **Header**: [site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl](https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl) --- /apis/common/v3/search **Example**: https://site.web.api.espn.com/apis/common/v3/search?limit=100&query=nfl <details><summary>Results</summary> ```json { "count": 8, @@ -157,10 +225,15 @@ Odds: "abbreviation": "NFL", ``` </details> /apis/fantasy/v2/games/ffl/games **Example**: https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108 <details><summary>Results</summary> ```json { "statistics": [ @@ -179,10 +252,15 @@ Odds: "3": 379, ``` </details> /apis/v2/scoreboard/header **Example**: https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl <details><summary>Results</summary> ```json { "sports": [ @@ -219,10 +297,15 @@ Odds: "seasonEndDate": "2022-01-13T07:59:00Z", ``` </details> /v3/colleges/2509 **Example**: https://sports.core.api.espn.com/v3/colleges/2509 <details><summary>Results</summary> ```json { "id": "2509", @@ -234,10 +317,15 @@ Odds: } ``` </details> /v2/sports/football/leagues/nfl **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl", @@ -256,12 +344,17 @@ Odds: "endDate": "2022-02-16T07:59Z", ``` </details> ### ATHLETES /apis/common/v3/sports/football/nfl/athletes/`athlete_id` **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876 <details><summary>Results</summary> ```json { "athlete": { @@ -280,10 +373,15 @@ Odds: "language": "en", ``` </details> /v2/sports/football/leagues/nfl/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000 <details><summary>Results</summary> ```json { "count": 4559, @@ -302,10 +400,15 @@ Odds: }, ``` </details> /v2/sports/football/leagues/nfl/athletes/`athlete_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/12483", @@ -324,12 +427,17 @@ Odds: "weight": 220, ``` </details> ### ATHLETE BIO /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/bio **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/bio <details><summary>Results</summary> ```json { "teamHistory": [ @@ -348,12 +456,17 @@ Odds: "desktop", ``` </details> ### ATHLETE EVENTLOG /v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id`/eventlog **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/eventlog <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/eventlog", @@ -372,12 +485,17 @@ Odds: "pageCount": 1, ``` </details> ### ATHLETE GAMELOG /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/gamelog **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog <details><summary>Results</summary> ```json { "categories": [ @@ -396,12 +514,17 @@ Odds: { ``` </details> ### ATHLETE NOTES /v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id`/notes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/notes <details><summary>Results</summary> ```json { "count": 1, @@ -421,12 +544,17 @@ Odds: } ``` </details> ### ATHLETE PROJECTIONS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/projections **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/projections <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0", @@ -445,12 +573,17 @@ Odds: { ``` </details> ### ATHLETE SPLITS /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/splits **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits <details><summary>Results</summary> ```json { "filters": [ @@ -469,12 +602,17 @@ Odds: } ``` </details> ### ATHLETE STATISTICS /v2/sports/football/leagues/nfl/athletes/`athlete_id`/statistics/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statistics/0 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/12483/statistics/0", @@ -493,10 +631,15 @@ Odds: "abbreviation": "gen", ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/statistics **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0", @@ -515,10 +658,15 @@ Odds: { ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/statistics/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/12483/statistics/0", @@ -537,12 +685,17 @@ Odds: { ``` </details> ### ATHLETE STATISTICSLOG /v2/sports/football/leagues/nfl/athletes/`athlete_id`/statisticslog **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog", @@ -561,12 +714,17 @@ Odds: { ``` </details> ### ATHLETE STATS /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/stats **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/stats <details><summary>Results</summary> ```json { "filters": [ @@ -585,12 +743,17 @@ Odds: } ``` </details> ### CALENDAR /v2/sports/football/leagues/nfl/calendar **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar <details><summary>Results</summary> ```json { "count": 4, @@ -614,12 +777,17 @@ Odds: } ``` </details> ### CALENDAR BLACKLIST /v2/sports/football/leagues/nfl/calendar/blacklist **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist <details><summary>Results</summary> ```json { "type": "list", @@ -637,12 +805,17 @@ Odds: "2021-07-23T07:00Z", ``` </details> ### CALENDAR WHITELIST /v2/sports/football/leagues/nfl/calendar/whitelist **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist <details><summary>Results</summary> ```json { "type": "list", @@ -660,12 +833,17 @@ Odds: "2021-08-20T07:00Z", ``` </details> ### COMPETITION DRIVES /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/drives/`drive_id` http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631", @@ -684,12 +862,17 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "number": 1 ``` </details> ### COMPETITION ODDS /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds <details><summary>Results</summary> ```json { "count": 11, @@ -708,10 +891,15 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "overUnder": 49.5, ``` </details> /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds/`provider_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003", @@ -730,12 +918,17 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "averageScore": 20.62, ``` </details> ### COMPETITION PLAYS /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/plays/`play_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631", @@ -754,11 +947,16 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ "period": { ``` </details> /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/plays GETS ALL PLAYS FOR A GAME: **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?limit=400 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?source=2", @@ -777,12 +975,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### COMPETITION PROBABILITIES /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/probabilities/`probabilities_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631", @@ -801,10 +1004,15 @@ GETS ALL PLAYS FOR A GAME: "tiePercentage": 0, ``` </details> /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/probabilities **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=200 <details><summary>Results</summary> ```json { "count": 166, @@ -840,12 +1048,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### COMPETITOR ROSTER /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/competitors/`competitors_id`/roster **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster", @@ -864,12 +1077,17 @@ GETS ALL PLAYS FOR A GAME: "position": { ``` </details> ### DRAFT ATHLETES /v2/sports/football/leagues/nfl/seasons/`year`/draft/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500 <details><summary>Results</summary> ```json { "count": 366, @@ -890,12 +1108,17 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104933" ``` </details> ### DRAFT ROUNDS /v2/sports/football/leagues/nfl/seasons/`year`/draft/rounds **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds <details><summary>Results</summary> ```json { "count": 7, @@ -914,12 +1137,17 @@ GETS ALL PLAYS FOR A GAME: "name": "SELECTION_MADE", ``` </details> ### DRAFT STATUS /v2/sports/football/leagues/nfl/seasons/`year`/draft/status **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status <details><summary>Results</summary> ```json { "round": 7, @@ -932,12 +1160,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### EVENTS /v2/sports/football/leagues/nfl/events **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events <details><summary>Results</summary> ```json { "$meta": { @@ -956,10 +1189,15 @@ GETS ALL PLAYS FOR A GAME: "count": 16, ``` </details> /v2/sports/football/leagues/nfl/events/`event_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315", @@ -978,12 +1216,17 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1" ``` </details> ### EVENT COMPETITIONS /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315 <details><summary>Results</summary> ```json { "id": "401326315", @@ -1001,12 +1244,17 @@ GETS ALL PLAYS FOR A GAME: "necessary": false, ``` </details> ### FRANCHISES /v2/sports/football/leagues/nfl/franchises **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises <details><summary>Results</summary> ```json { "count": 32, @@ -1025,10 +1273,15 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> /v2/sports/football/leagues/nfl/franchises/`franchise_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1", @@ -1047,12 +1300,17 @@ GETS ALL PLAYS FOR A GAME: { ``` </details> ### GROUP STANDINGS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id`/standings **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings <details><summary>Results</summary> ```json { "count": 4, @@ -1070,12 +1328,17 @@ GETS ALL PLAYS FOR A GAME: "rel": [ ``` </details> ### GROUP TEAMS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id`/teams **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams <details><summary>Results</summary> ```json { "count": 4, @@ -1099,12 +1362,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### LEADERS /apis/site/v3/sports/football/nfl/leaders **Example**: https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021 <details><summary>Results</summary> ```json "leaders": { "id": "0", @@ -1132,10 +1400,15 @@ GETS ALL PLAYS FOR A GAME: "fullName": "Patrick Mahomes", ``` </details> /v2/sports/football/leagues/nfl/leaders **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0", @@ -1154,10 +1427,15 @@ GETS ALL PLAYS FOR A GAME: "value": 2673, ``` </details> /v2/sports/football/leagues/nfl/leaders/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0", @@ -1176,12 +1454,17 @@ GETS ALL PLAYS FOR A GAME: "value": 2673, ``` </details> ### NEWS /apis/site/v2/sports/football/nfl/news **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news <details><summary>Results</summary> ```json { "header": "NFL News", @@ -1200,12 +1483,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### ODD PREDICTORS /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds/`provider_id`/predictors **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003/predictors <details><summary>Results</summary> ```json { "count": 5, @@ -1233,12 +1521,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### POSITIONS /v2/sports/football/leagues/nfl/positions/`position_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8", @@ -1253,10 +1546,15 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> /v2/sports/football/leagues/nfl/positions **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100 <details><summary>Results</summary> ```json { "count": 73, @@ -1275,12 +1573,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### PROVIDERS /v2/sports/football/leagues/nfl/providers/`provider_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003 <details><summary>Results</summary> ```json { "id": "1003", @@ -1289,12 +1592,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### SCOREBOARD /apis/site/v2/sports/football/nfl/scoreboard **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard <details><summary>Results</summary> ```json { "leagues": [ @@ -1313,12 +1621,17 @@ GETS ALL PLAYS FOR A GAME: "type": 2, ``` </details> ### SEASONS /v2/sports/football/leagues/nfl/seasons **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons <details><summary>Results</summary> ```json { "count": 100, @@ -1337,10 +1650,15 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> /v2/sports/football/leagues/nfl/seasons/`year` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021", @@ -1359,12 +1677,17 @@ GETS ALL PLAYS FOR A GAME: "endDate": "2022-01-13T07:59Z", ``` </details> ### SEASON ATHLETES /v2/sports/football/leagues/nfl/seasons/`year`/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes <details><summary>Results</summary> ```json { "count": 16438, @@ -1383,10 +1706,15 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876", @@ -1405,12 +1733,17 @@ GETS ALL PLAYS FOR A GAME: "weight": 217, ``` </details> ### SEASON COACHES /v2/sports/football/leagues/nfl/seasons/`year`/coaches **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50 <details><summary>Results</summary> ```json { "count": 32, @@ -1429,10 +1762,15 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/coaches/`coach_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695", @@ -1466,12 +1804,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### SEASON DRAFT /v2/sports/football/leagues/nfl/seasons/`year`/draft **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft", @@ -1490,12 +1833,17 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds" ``` </details> ### SEASON FUTURES /v2/sports/football/leagues/nfl/seasons/`year`/futures **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures <details><summary>Results</summary> ```json { "count": 7, @@ -1514,10 +1862,15 @@ GETS ALL PLAYS FOR A GAME: "name": "DraftKings", ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/futures/`future_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561", @@ -1536,12 +1889,17 @@ GETS ALL PLAYS FOR A GAME: "team": { ``` </details> ### SEASON TEAMS /v2/sports/football/leagues/nfl/seasons/`year`/teams **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams <details><summary>Results</summary> ```json { "count": 32, @@ -1560,10 +1918,15 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1", @@ -1582,12 +1945,17 @@ GETS ALL PLAYS FOR A GAME: "shortDisplayName": "Falcons", ``` </details> ### SEASON TYPES /v2/sports/football/leagues/nfl/seasons/`year`/types **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types <details><summary>Results</summary> ```json { "count": 4, @@ -1611,10 +1979,15 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2", @@ -1633,12 +2006,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### TALENTPICKS /v2/sports/football/leagues/nfl/talentpicks **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks <details><summary>Results</summary> ```json { "count": 176, @@ -1657,12 +2035,17 @@ GETS ALL PLAYS FOR A GAME: "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png", ``` </details> ### TEAM /apis/site/v2/sports/football/nfl/teams **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams <details><summary>Results</summary> ```json { "sports": [ @@ -1681,10 +2064,15 @@ GETS ALL PLAYS FOR A GAME: "slug": "nfl", ``` </details> /apis/site/v2/sports/football/nfl/teams/`team_id` **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12 <details><summary>Results</summary> ```json { "team": { @@ -1703,12 +2091,17 @@ GETS ALL PLAYS FOR A GAME: "logos": [ ``` </details> ### TEAM ATHLETES /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes <details><summary>Results</summary> ```json { "count": 76, @@ -1727,12 +2120,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### TEAM ATS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/ats **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/ats <details><summary>Results</summary> ```json { "count": 9, @@ -1751,12 +2149,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### TEAM ATTENDANCE /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/attendance **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/attendance <details><summary>Results</summary> ```json { "id": "0", @@ -1774,12 +2177,17 @@ GETS ALL PLAYS FOR A GAME: "displayName": "Home Games", ``` </details> ### TEAM COACHES /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/coaches **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/coaches <details><summary>Results</summary> ```json { "count": 1, @@ -1790,12 +2198,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### TEAM DEPTHCHARTS /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/depthcharts **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts <details><summary>Results</summary> ```json { "count": 3, @@ -1813,12 +2226,17 @@ GETS ALL PLAYS FOR A GAME: "name": "Left Defensive End", ``` </details> ### TEAM EVENTS /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/events **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events <details><summary>Results</summary> ```json { "count": 20, @@ -1837,12 +2255,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### TEAM INJURIES /v2/sports/football/leagues/nfl/teams/`team_id`/injuries **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries <details><summary>Results</summary> ```json { "count": 63, @@ -1861,12 +2284,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### TEAM LEADERS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/leaders **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/leaders <details><summary>Results</summary> ```json { "id": "0", @@ -1884,12 +2312,17 @@ GETS ALL PLAYS FOR A GAME: "value": 4052, ``` </details> ### TEAM ODDS-RECORDS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/odds-records **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/odds-records <details><summary>Results</summary> ```json { "count": 10, @@ -1908,12 +2341,17 @@ GETS ALL PLAYS FOR A GAME: "abbreviation": "W", ``` </details> ### TEAM PROJECTION /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/projection **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/projection <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/projection", @@ -1927,12 +2365,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### TEAM RECORD /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/record **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/record <details><summary>Results</summary> ```json { "count": 5, @@ -1950,12 +2393,17 @@ GETS ALL PLAYS FOR A GAME: "value": 0.7142857142857143, ``` </details> ### TEAM ROSTER /apis/site/v2/sports/football/nfl/teams/`team_id`/roster **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster <details><summary>Results</summary> ```json { "timestamp": "2021-12-21T12:39:06Z", @@ -1974,12 +2422,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### TEAM SCHEDULE /apis/site/v2/sports/football/nfl/teams/`team_id`/schedule **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule <details><summary>Results</summary> ```json { "timestamp": "2021-12-21T12:39:07Z", @@ -1998,12 +2451,17 @@ GETS ALL PLAYS FOR A GAME: "name": "Falcons", ``` </details> ### TEAM STATISTICS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/statistics **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/1/statistics/0", @@ -2022,10 +2480,15 @@ GETS ALL PLAYS FOR A GAME: "name": "general", ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/statistics/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0", @@ -2044,12 +2507,17 @@ GETS ALL PLAYS FOR A GAME: "name": "general", ``` </details> ### SEASONTYPE GROUPS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups <details><summary>Results</summary> ```json { "count": 2, @@ -2067,10 +2535,15 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9", @@ -2096,12 +2569,17 @@ GETS ALL PLAYS FOR A GAME: } ``` </details> ### SEASONTYPE LEADERS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/leaders **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/3/leaders", @@ -2133,12 +2611,17 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> ### SEASONTYPE WEEKS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks <details><summary>Results</summary> ```json { "count": 18, @@ -2157,10 +2640,15 @@ GETS ALL PLAYS FOR A GAME: }, ``` </details> /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6", @@ -2179,12 +2667,17 @@ GETS ALL PLAYS FOR A GAME: "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20" ``` </details> ### VENUES /v2/sports/football/leagues/nfl/venues/`venue_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493 <details><summary>Results</summary> ```json { "id": "3493", @@ -2202,12 +2695,17 @@ GETS ALL PLAYS FOR A GAME: "href": "https://a.espncdn.com/i/venues/nfl/day/3493.jpg", ``` </details> ### WEEKLY EVENTS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/events **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/events <details><summary>Results</summary> ```json { "$meta": { @@ -2226,12 +2724,17 @@ GETS ALL PLAYS FOR A GAME: "count": 14, ``` </details> ### WEEKLY QBR /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/qbr/10000 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000 <details><summary>Results</summary> ```json { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000", @@ -2250,12 +2753,17 @@ GETS ALL PLAYS FOR A GAME: "event": { ``` </details> ### WEEKLY TALENTPICKS /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/talentpicks **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks <details><summary>Results</summary> ```json { "count": 154, @@ -2274,9 +2782,6 @@ GETS ALL PLAYS FOR A GAME: "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png", ``` </details> -
Jul 15, 2022 . 1 changed file with 289 additions and 256 deletions.There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode charactersOriginal file line number Diff line number Diff line change @@ -1,139 +1,165 @@ # List of NFL API Endpoints View updated list [here](https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c) This page is limited to NFL endpoints but can be refashioned for other sports leagues (i.e. `/sports/football/leagues/nfl/` => `/sports/baseball/leagues/mlb/`) --- ## Getting started API for getting ids: - **Athletes**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true - **Teams**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32 - **Positions**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75 - **Venues**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues?limit=700 Odds: * **Win probabilities:** [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:game_id**/competitions/**:game_id**/probabilities?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200) * **Odds**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:game_id**/competitions/**:game_id**/odds](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds) * **Against-the-spread**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/types/2/teams/**:team_id**/ats](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/teams/26/ats) * **Futures**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/futures](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/futures) * **Head-to-head (game)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/**:game_id**/competitions/**:game_id**/odds/**:bet_provider_id**/head-to-heads](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/head-to-heads) * **Odds records**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/types/0/teams/**:team_id**/odds-records](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/0/teams/4/odds-records) * **Odds history - Game**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/**:bet_provider_id**/history/0/movement?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/history/0/movement?limit=100) * **Odds history - Team**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/**:team_id**/odds/**:bet_provider_id**/past-performances?limit=200](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200) * **Positions (enum)**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100) * **QBR Weekly/Game stats**: [sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/**:season**/types/2/weeks/**:week_num**/qbr/10000](https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000) ## Endpoints * [/apis/common/v3/search](#apiscommonv3search) * [/apis/fantasy/v2/games/ffl/games](#apisfantasyv2gamesfflgames) * [/apis/v2/scoreboard/header](#apisv2scoreboardheader) * [/v3/colleges/2509](#v2colleges2509) * [/v2/sports/football/leagues/nfl](#v2sportsfootballleaguesnfl) * [/apis/common/v3/sports/football/nfl/athletes/`athlete_id`](#apiscommonv3sportsfootballnflathletesathlete_id) * [/v2/sports/football/leagues/nfl/athletes](#v2sportsfootballleaguesnflathletes) * [/v2/sports/football/leagues/nfl/athletes/`athlete_id`](#v2sportsfootballleaguesnflathletesathlete_id) * [/apis/common/v3/sports/football/nfl/athletes/`athlete_id`/bio](#apiscommonv3sportsfootballnflathletesathlete_idbio) * [/v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id`/eventlog](#v2sportsfootballleaguesnflseasonsyearathletesathlete_ideventlog) * [/apis/common/v3/sports/football/nfl/athletes/`athlete_id`/gamelog](#apiscommonv3sportsfootballnflathletesathlete_idgamelog) * [/v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id`/notes](#v2sportsfootballleaguesnflseasonsyearathletesathlete_idnotes) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/projections](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeathletesathlete_idprojections) * [/apis/common/v3/sports/football/nfl/athletes/`athlete_id`/splits](#apiscommonv3sportsfootballnflathletesathlete_idsplits) * [/v2/sports/football/leagues/nfl/athletes/`athlete_id`/statistics/0](#v2sportsfootballleaguesnflathletesathlete_idstatistics0) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/statistics](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeathletesathlete_idstatistics) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/statistics/0](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeathletesathlete_idstatistics0) * [/v2/sports/football/leagues/nfl/athletes/`athlete_id`/statisticslog](#v2sportsfootballleaguesnflathletesathlete_idstatisticslog) * [/apis/common/v3/sports/football/nfl/athletes/`athlete_id`/stats](#apiscommonv3sportsfootballnflathletesathlete_idstats) * [/v2/sports/football/leagues/nfl/calendar](#v2sportsfootballleaguesnflcalendar) * [/v2/sports/football/leagues/nfl/calendar/blacklist](#v2sportsfootballleaguesnflcalendarblacklist) * [/v2/sports/football/leagues/nfl/calendar/whitelist](#v2sportsfootballleaguesnflcalendarwhitelist) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/drives/`drive_id`](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_iddrivesdrive_id) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idodds) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds/`provider_id`](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idoddsprovider_id) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/plays/`play_id`](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idplaysplay_id) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/plays](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idplays) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/probabilities/`probabilities_id`](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idprobabilitiesprobabilities_id) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/probabilities](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idprobabilities) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/competitors/`competitors_id`/roster](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idcompetitorscompetitors_idroster) * [/v2/sports/football/leagues/nfl/seasons/`year`/draft/athletes](#v2sportsfootballleaguesnflseasonsyeardraftathletes) * [/v2/sports/football/leagues/nfl/seasons/`year`/draft/rounds](#v2sportsfootballleaguesnflseasonsyeardraftrounds) * [/v2/sports/football/leagues/nfl/seasons/`year`/draft/status](#v2sportsfootballleaguesnflseasonsyeardraftstatus) * [/v2/sports/football/leagues/nfl/events](#v2sportsfootballleaguesnflevents) * [/v2/sports/football/leagues/nfl/events/`event_id`](#v2sportsfootballleaguesnfleventsevent_id) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_id) * [/v2/sports/football/leagues/nfl/franchises](#v2sportsfootballleaguesnflfranchises) * [/v2/sports/football/leagues/nfl/franchises/`franchise_id`](#v2sportsfootballleaguesnflfranchisesfranchise_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id`/standings](#v2sportsfootballleaguesnflseasonsyeartypesseasontypegroupsgroup_idstandings) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id`/teams](#v2sportsfootballleaguesnflseasonsyeartypesseasontypegroupsgroup_idteams) * [/apis/site/v3/sports/football/nfl/leaders](#apissitev3sportsfootballnflleaders) * [/v2/sports/football/leagues/nfl/leaders](#v2sportsfootballleaguesnflleaders) * [/v2/sports/football/leagues/nfl/leaders/0](#v2sportsfootballleaguesnflleaders0) * [/apis/site/v2/sports/football/nfl/news](#apissitev2sportsfootballnflnews) * [/v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds/`provider_id`/predictors](#v2sportsfootballleaguesnfleventsevent_idcompetitionsevent_idoddsprovider_idpredictors) * [/v2/sports/football/leagues/nfl/positions/`position_id`](#v2sportsfootballleaguesnflpositionsposition_id) * [/v2/sports/football/leagues/nfl/positions](#v2sportsfootballleaguesnflpositions) * [/v2/sports/football/leagues/nfl/providers/`provider_id`](#v2sportsfootballleaguesnflprovidersprovider_id) * [/apis/site/v2/sports/football/nfl/scoreboard](#apissitev2sportsfootballnflscoreboard) * [/v2/sports/football/leagues/nfl/seasons](#v2sportsfootballleaguesnflseasons) * [/v2/sports/football/leagues/nfl/seasons/`year`](#v2sportsfootballleaguesnflseasonsyear) * [/v2/sports/football/leagues/nfl/seasons/`year`/athletes](#v2sportsfootballleaguesnflseasonsyearathletes) * [/v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id`](#v2sportsfootballleaguesnflseasonsyearathletesathlete_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/coaches](#v2sportsfootballleaguesnflseasonsyearcoaches) * [/v2/sports/football/leagues/nfl/seasons/`year`/coaches/`coach_id`](#v2sportsfootballleaguesnflseasonsyearcoachescoach_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/draft](#v2sportsfootballleaguesnflseasonsyeardraft) * [/v2/sports/football/leagues/nfl/seasons/`year`/futures](#v2sportsfootballleaguesnflseasonsyearfutures) * [/v2/sports/football/leagues/nfl/seasons/`year`/futures/`future_id`](#v2sportsfootballleaguesnflseasonsyearfuturesfuture_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/teams](#v2sportsfootballleaguesnflseasonsyearteams) * [/v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`](#v2sportsfootballleaguesnflseasonsyearteamsteam_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/types](#v2sportsfootballleaguesnflseasonsyeartypes) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`](#v2sportsfootballleaguesnflseasonsyeartypesseasontype) * [/v2/sports/football/leagues/nfl/talentpicks](#v2sportsfootballleaguesnfltalentpicks) * [/apis/site/v2/sports/football/nfl/teams](#apissitev2sportsfootballnflteams) * [/apis/site/v2/sports/football/nfl/teams/`team_id`](#apissitev2sportsfootballnflteamsteam_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/athletes](#v2sportsfootballleaguesnflseasonsyearteamsteam_idathletes) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/ats](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeteamsteam_idats) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/attendance](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeteamsteam_idattendance) * [/v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/coaches](#v2sportsfootballleaguesnflseasonsyearteamsteam_idcoaches) * [/v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/depthcharts](#v2sportsfootballleaguesnflseasonsyearteamsteam_iddepthcharts) * [/v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/events](#v2sportsfootballleaguesnflseasonsyearteamsteam_idevents) * [/v2/sports/football/leagues/nfl/teams/`team_id`/injuries](#v2sportsfootballleaguesnflteamsteam_idinjuries) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/leaders](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeteamsteam_idleaders) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/odds-records](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeteamsteam_idodds-records) * [/v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/projection](#v2sportsfootballleaguesnflseasonsyearteamsteam_idprojection) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/record](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeteamsteam_idrecord) * [/apis/site/v2/sports/football/nfl/teams/`team_id`/roster](#apissitev2sportsfootballnflteamsteam_idroster) * [/apis/site/v2/sports/football/nfl/teams/`team_id`/schedule](#apissitev2sportsfootballnflteamsteam_idschedule) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/statistics](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeteamsteam_idstatistics) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/statistics/0](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeteamsteam_idstatistics0) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups](#v2sportsfootballleaguesnflseasonsyeartypesseasontypegroups) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id`](#v2sportsfootballleaguesnflseasonsyeartypesseasontypegroupsgroup_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/leaders](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeleaders) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeweeks) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeweeksweeknum) * [/v2/sports/football/leagues/nfl/venues/`venue_id`](#v2sportsfootballleaguesnflvenuesvenue_id) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/events](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeweeksweeknumevents) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/qbr/10000](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeweeksweeknumqbr10000) * [/v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/talentpicks](#v2sportsfootballleaguesnflseasonsyeartypesseasontypeweeksweeknumtalentpicks) ## GET Requests ### /apis/common/v3/search **Example**: https://site.web.api.espn.com/apis/common/v3/search?limit=100&query=nfl ```json { "count": 8, "pageIndex": 1, "pageSize": 205, "pageCount": 1, "items": [ { "id": "28", "uuid": "ad4c3bd2-ddb6-3f8c-8abf-744855a08fa4", "guid": "ad4c3bd2-ddb6-3f8c-8abf-744855a08fa4", "displayName": "National Football League", "type": "league", "sport": "football", "league": "nfl", "relevance": "559650519", "defaultLeagueSlug": "nfl", "uid": "s:20~l:28", "abbreviation": "NFL", ``` ### /apis/fantasy/v2/games/ffl/games **Example**: https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108 ```json { @@ -155,7 +181,7 @@ https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-202 ### /apis/v2/scoreboard/header **Example**: https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl ```json { @@ -193,24 +219,24 @@ https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nf "seasonEndDate": "2022-01-13T07:59:00Z", ``` ### /v3/colleges/2509 **Example**: https://sports.core.api.espn.com/v3/colleges/2509 ```json { "id": "2509", "mascot": "Boilermakers", "name": "Purdue", "longName": "Purdue University", "shortName": "Purdue", "abbreviation": "PUR" } ``` ### /v2/sports/football/leagues/nfl **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl ```json { @@ -232,9 +258,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl ## ATHLETES ### /apis/common/v3/sports/football/nfl/athletes/`athlete_id` **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876 ```json { @@ -256,29 +282,29 @@ https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876 ### /v2/sports/football/leagues/nfl/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000 ```json { "count": 4559, "pageIndex": 1, "pageSize": 1000, "pageCount": 5, "items": [ { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2576336?lang=en®ion=us" }, { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3049325?lang=en®ion=us" }, { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3915373?lang=en®ion=us" }, ``` ### /v2/sports/football/leagues/nfl/athletes/`athlete_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876 ```json { @@ -300,9 +326,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876 ## ATHLETE BIO ### /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/bio **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/bio ```json { @@ -324,9 +350,9 @@ https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/ ## ATHLETE EVENTLOG ### /v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id`/eventlog **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/eventlog ```json { @@ -348,9 +374,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/ath ## ATHLETE GAMELOG ### /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/gamelog **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/gamelog ```json { @@ -372,9 +398,9 @@ https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/ ## ATHLETE NOTES ### /v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id`/notes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/notes ```json { @@ -397,9 +423,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/ath ## ATHLETE PROJECTIONS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/projections **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/projections ```json { @@ -421,9 +447,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## ATHLETE SPLITS ### /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/splits **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits ```json { @@ -445,9 +471,9 @@ https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/ ## ATHLETE STATISTICS ### /v2/sports/football/leagues/nfl/athletes/`athlete_id`/statistics/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statistics/0 ```json { @@ -467,9 +493,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/s "abbreviation": "gen", ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/statistics **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics ```json { @@ -489,9 +515,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ { ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/athletes/`athlete_id`/statistics/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0 ```json { @@ -513,9 +539,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## ATHLETE STATISTICSLOG ### /v2/sports/football/leagues/nfl/athletes/`athlete_id`/statisticslog **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog ```json { @@ -537,9 +563,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/s ## ATHLETE STATS ### /apis/common/v3/sports/football/nfl/athletes/`athlete_id`/stats **Example**: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/stats ```json { @@ -563,7 +589,7 @@ https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/ ### /v2/sports/football/leagues/nfl/calendar **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar ```json { @@ -592,7 +618,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar ### /v2/sports/football/leagues/nfl/calendar/blacklist **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist ```json { @@ -615,7 +641,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blackli ### /v2/sports/football/leagues/nfl/calendar/whitelist **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist ```json { @@ -636,7 +662,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whiteli ## COMPETITION DRIVES ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/drives/`drive_id` http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631 @@ -660,9 +686,9 @@ http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/ ## COMPETITION ODDS ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds ```json { @@ -682,9 +708,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181 "overUnder": 49.5, ``` ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds/`provider_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003 ```json { @@ -706,9 +732,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 ## COMPETITION PLAYS ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/plays/`play_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631 ```json { @@ -728,10 +754,10 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063 "period": { ``` ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/plays GETS ALL PLAYS FOR A GAME: **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?limit=400 ```json { @@ -753,9 +779,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181 ## COMPETITION PROBABILITIES ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/probabilities/`probabilities_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631 ```json { @@ -775,9 +801,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 "tiePercentage": 0, ``` ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/probabilities **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=200 ```json { @@ -816,9 +842,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181 ## COMPETITOR ROSTER ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/competitors/`competitors_id`/roster **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster ```json { @@ -840,9 +866,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181 ## DRAFT ATHLETES ### /v2/sports/football/leagues/nfl/seasons/`year`/draft/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500 ```json { @@ -866,9 +892,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/dra ## DRAFT ROUNDS ### /v2/sports/football/leagues/nfl/seasons/`year`/draft/rounds **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds ```json { @@ -890,9 +916,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/dra ## DRAFT STATUS ### /v2/sports/football/leagues/nfl/seasons/`year`/draft/status **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status ```json { @@ -910,7 +936,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/dra ### /v2/sports/football/leagues/nfl/events **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events ```json { @@ -930,9 +956,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events "count": 16, ``` ### /v2/sports/football/leagues/nfl/events/`event_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 ```json { @@ -954,9 +980,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 ## EVENT COMPETITIONS ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315 ```json { @@ -979,7 +1005,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 ### /v2/sports/football/leagues/nfl/franchises **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises ```json { @@ -999,9 +1025,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises }, ``` ### /v2/sports/football/leagues/nfl/franchises/`franchise_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1 ```json { @@ -1023,9 +1049,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1 ## GROUP STANDINGS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id`/standings **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings ```json { @@ -1046,9 +1072,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## GROUP TEAMS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id`/teams **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams ```json { @@ -1077,7 +1103,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ### /apis/site/v3/sports/football/nfl/leaders **Example**: https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021 ```json "leaders": { @@ -1108,7 +1134,7 @@ https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021 ### /v2/sports/football/leagues/nfl/leaders **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders ```json { @@ -1130,7 +1156,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders ### /v2/sports/football/leagues/nfl/leaders/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0 ```json { @@ -1154,7 +1180,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0 ### /apis/site/v2/sports/football/nfl/news **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news ```json { @@ -1176,9 +1202,9 @@ https://site.api.espn.com/apis/site/v2/sports/football/nfl/news ## ODD PREDICTORS ### /v2/sports/football/leagues/nfl/events/`event_id`/competitions/`event_id`/odds/`provider_id`/predictors **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003/predictors ```json { @@ -1209,9 +1235,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315 ## POSITIONS ### /v2/sports/football/leagues/nfl/positions/`position_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8 ```json { @@ -1229,7 +1255,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8 ### /v2/sports/football/leagues/nfl/positions **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100 ```json { @@ -1251,9 +1277,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit= ## PROVIDERS ### /v2/sports/football/leagues/nfl/providers/`provider_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003 ```json { @@ -1267,7 +1293,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003 ### /apis/site/v2/sports/football/nfl/scoreboard **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard ```json { @@ -1291,7 +1317,7 @@ https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard ### /v2/sports/football/leagues/nfl/seasons **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons ```json { @@ -1311,9 +1337,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons }, ``` ### /v2/sports/football/leagues/nfl/seasons/`year` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021 ```json { @@ -1335,9 +1361,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021 ## SEASON ATHLETES ### /v2/sports/football/leagues/nfl/seasons/`year`/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes ```json { @@ -1357,9 +1383,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/ath }, ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/athletes/`athlete_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876 ```json { @@ -1381,9 +1407,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/ath ## SEASON COACHES ### /v2/sports/football/leagues/nfl/seasons/`year`/coaches **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50 ```json { @@ -1403,9 +1429,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coa }, ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/coaches/`coach_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695 ```json { @@ -1442,9 +1468,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695 ## SEASON DRAFT ### /v2/sports/football/leagues/nfl/seasons/`year`/draft **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft ```json { @@ -1466,9 +1492,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/dra ## SEASON FUTURES ### /v2/sports/football/leagues/nfl/seasons/`year`/futures **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures ```json { @@ -1488,9 +1514,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/fut "name": "DraftKings", ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/futures/`future_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561 ```json { @@ -1512,9 +1538,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/fut ## SEASON TEAMS ### /v2/sports/football/leagues/nfl/seasons/`year`/teams **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams ```json { @@ -1534,9 +1560,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/tea }, ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12 ```json { @@ -1558,9 +1584,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/tea ## SEASON TYPES ### /v2/sports/football/leagues/nfl/seasons/`year`/types **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types ```json { @@ -1585,9 +1611,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ } ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2 ```json { @@ -1611,7 +1637,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ### /v2/sports/football/leagues/nfl/talentpicks **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks ```json { @@ -1635,7 +1661,7 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks ### /apis/site/v2/sports/football/nfl/teams **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams ```json { @@ -1655,9 +1681,9 @@ https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams "slug": "nfl", ``` ### /apis/site/v2/sports/football/nfl/teams/`team_id` **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12 ```json { @@ -1679,9 +1705,9 @@ https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12 ## TEAM ATHLETES ### /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/athletes **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes ```json { @@ -1703,9 +1729,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/tea ## TEAM ATS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/ats **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/ats ```json { @@ -1727,9 +1753,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## TEAM ATTENDANCE ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/attendance **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/attendance ```json { @@ -1750,9 +1776,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## TEAM COACHES ### /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/coaches **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/coaches ```json { @@ -1766,9 +1792,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/tea ## TEAM DEPTHCHARTS ### /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/depthcharts **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts ```json { @@ -1789,9 +1815,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/tea ## TEAM EVENTS ### /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/events **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events ```json { @@ -1813,9 +1839,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/tea ## TEAM INJURIES ### /v2/sports/football/leagues/nfl/teams/`team_id`/injuries **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries ```json { @@ -1837,9 +1863,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injurie ## TEAM LEADERS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/leaders **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/leaders ```json { @@ -1860,9 +1886,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## TEAM ODDS-RECORDS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/odds-records **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/odds-records ```json { @@ -1884,9 +1910,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## TEAM PROJECTION ### /v2/sports/football/leagues/nfl/seasons/`year`/teams/`team_id`/projection **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/projection ```json { @@ -1903,9 +1929,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/tea ## TEAM RECORD ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/record **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/record ```json { @@ -1926,9 +1952,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## TEAM ROSTER ### /apis/site/v2/sports/football/nfl/teams/`team_id`/roster **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster ```json { @@ -1950,9 +1976,9 @@ https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/roster ## TEAM SCHEDULE ### /apis/site/v2/sports/football/nfl/teams/`team_id`/schedule **Example**: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule ```json { @@ -1974,9 +2000,9 @@ https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/12/schedule ## TEAM STATISTICS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/statistics **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics ```json { @@ -1996,9 +2022,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ "name": "general", ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/teams/`team_id`/statistics/0 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0 ```json { @@ -2020,9 +2046,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## SEASONTYPE GROUPS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups ```json { @@ -2041,9 +2067,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ } ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/groups/`group_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1 ```json { @@ -2072,9 +2098,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## SEASONTYPE LEADERS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/leaders **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders ```json { @@ -2109,9 +2135,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## SEASONTYPE WEEKS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks ```json { @@ -2131,9 +2157,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ }, ``` ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6 ```json { @@ -2155,9 +2181,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## VENUES ### /v2/sports/football/leagues/nfl/venues/`venue_id` **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493 ```json { @@ -2178,9 +2204,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493 ## WEEKLY EVENTS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/events **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/events ```json { @@ -2202,9 +2228,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## WEEKLY QBR ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/qbr/10000 **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000 ```json { @@ -2226,9 +2252,9 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ ## WEEKLY TALENTPICKS ### /v2/sports/football/leagues/nfl/seasons/`year`/types/`seasontype`/weeks/`weeknum`/talentpicks **Example**: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks ```json { @@ -2247,3 +2273,10 @@ https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/typ "headshot": { "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png", ``` ### Additional Resources / Further Reading - [nfl-nerd](https://github.com/nntrn/nfl-nerd) - [ESPN's hidden API endpoints](https://gist.github.com/akeaswaran/b48b02f1c94f873c6655e7129910fc3b) - [Using ESPN's new Fantasy API (v3)](https://stmorse.github.io/journal/espn-fantasy-v3.html) - [ESPN: Get Endpoint (CRAN Package)](https://cran.r-project.org/web/packages/ffscrapr/vignettes/espn_getendpoint.html)
NewerOlder