This page is limited to NFL endpoints but can be refashioned for other leagues (i.e.
/sports/football/leagues/nfl/
=>/sports/baseball/leagues/mlb/
)
Name | Description |
---|---|
season |
Integer year in which the season started (YYYY ) |
seasontype |
1=pre, 2=regular, 3=post |
league_id |
league Id from |
bet_provider_id |
view under odds |
Base URL: sports.core.api.espn.com
- season: /v2/sports/football/leagues/nfl/seasons/:seasontype
- seasons: /v2/sports/football/leagues/nfl/seasons
- franchises: /v2/sports/football/leagues/nfl/franchises
- teams: /v2/sports/football/leagues/nfl/seasons/:seasontype/teams
- group: /v2/sports/football/leagues/nfl/seasons/:seasontype/types/:type_id/groups/:group_id
- groups: /v2/sports/football/leagues/nfl/seasons/:seasontype/types/:type_id/groups
- events: /v2/sports/football/leagues/nfl/events
- notes: /v2/sports/football/leagues/nfl/notes
- rankings: /v2/sports/football/leagues/nfl/rankings
- draft: /v2/sports/football/leagues/nfl/seasons/:seasontype/draft
- athletes: /v2/sports/football/leagues/nfl/athletes
- freeAgents: /v2/sports/football/leagues/nfl/seasons/:seasontype/freeagents
- calendar: /v2/sports/football/leagues/nfl/calendar
- transactions: /v2/sports/football/leagues/nfl/transactions
- talentPicks: /v2/sports/football/leagues/nfl/talentpicks
- leaders: /v2/sports/football/leagues/nfl/leaders
- ATL: /v2/sports/football/leagues/nfl/seasons/2021/teams/1
- BUF: /v2/sports/football/leagues/nfl/seasons/2021/teams/2
- CHI: /v2/sports/football/leagues/nfl/seasons/2021/teams/3
- CIN: /v2/sports/football/leagues/nfl/seasons/2021/teams/4
- CLE: /v2/sports/football/leagues/nfl/seasons/2021/teams/5
- DAL: /v2/sports/football/leagues/nfl/seasons/2021/teams/6
- DEN: /v2/sports/football/leagues/nfl/seasons/2021/teams/7
- DET: /v2/sports/football/leagues/nfl/seasons/2021/teams/8
- GB: /v2/sports/football/leagues/nfl/seasons/2021/teams/9
- TEN: /v2/sports/football/leagues/nfl/seasons/2021/teams/10
- IND: /v2/sports/football/leagues/nfl/seasons/2021/teams/11
- KC: /v2/sports/football/leagues/nfl/seasons/2021/teams/12
- LV: /v2/sports/football/leagues/nfl/seasons/2021/teams/13
- LAR: /v2/sports/football/leagues/nfl/seasons/2021/teams/14
- MIA: /v2/sports/football/leagues/nfl/seasons/2021/teams/15
- MIN: /v2/sports/football/leagues/nfl/seasons/2021/teams/16
- NE: /v2/sports/football/leagues/nfl/seasons/2021/teams/17
- NO: /v2/sports/football/leagues/nfl/seasons/2021/teams/18
- NYG: /v2/sports/football/leagues/nfl/seasons/2021/teams/19
- NYJ: /v2/sports/football/leagues/nfl/seasons/2021/teams/20
- PHI: /v2/sports/football/leagues/nfl/seasons/2021/teams/21
- ARI: /v2/sports/football/leagues/nfl/seasons/2021/teams/22
- PIT: /v2/sports/football/leagues/nfl/seasons/2021/teams/23
- LAC: /v2/sports/football/leagues/nfl/seasons/2021/teams/24
- SF: /v2/sports/football/leagues/nfl/seasons/2021/teams/25
- SEA: /v2/sports/football/leagues/nfl/seasons/2021/teams/26
- TB: /v2/sports/football/leagues/nfl/seasons/2021/teams/27
- WSH: /v2/sports/football/leagues/nfl/seasons/2021/teams/28
- CAR: /v2/sports/football/leagues/nfl/seasons/2021/teams/29
- JAX: /v2/sports/football/leagues/nfl/seasons/2021/teams/30
- BAL: /v2/sports/football/leagues/nfl/seasons/2021/teams/33
- HOU: /v2/sports/football/leagues/nfl/seasons/2021/teams/34
fantasy.espn.com/apis/v3/games/ffl/seasons/:season/segments/0/leagues/:league_id
- view=mLiveScoring
- view=mMatchupScore
- view=mPendingTransactions
- view=mPositionalRatings
- view=mSettings
- view=mTeam
- view=modular
- view=mNav
- view=mDraftDetail
fantasy.espn.com/apis/v3/games/ffl/leagueHistory/:league_id?seasonId=:season
- &view=mLiveScoring
- &view=mMatchupScore
- &view=mPendingTransactions
- &view=mPositionalRatings
- &view=mSettings
- &view=mTeam
- &view=modular
- &view=mNav
- &view=mDraftDetail
Leagues: sports.core.api.espn.com/v2/sports/football/leagues/nfl
Athletes: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/athletes/:athlete_id
Teams: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/teams
Team: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/teams/:team_id
Depth charts: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/teams/:team_id/depthcharts
Whitelist dates: sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist
Season: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season
Week: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/:season_type/weeks/:week
All weeks sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/types/:season_type/weeks
List of games via date-range: site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20210228
- add
&1577413600
at the end for overriding the cache - date range cannot exceed 13 months
- format for date can be full date or year
- YYYYMMDD,
- YYYY
- 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
Win probabilities sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/probabilities?limit=200
Odds: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds
Against-the-spread: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/types/2/teams/:team_id/ats
Futures: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/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
Odds records: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/types/0/teams/:team_id/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
Odds history - Team: sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/odds/:bet_provider_id/past-performances?limit=200
Positions (enum): 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
all active athletes: sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?active=true
site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id
site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/splits?season=2020
site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/gamelog
site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/stats
site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/bio
site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/overview
site.api.espn.com/apis/site/v2/sports/football/nfl/teams
site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id
site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id/roster
site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id/schedule{?season,seasontype}
sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/teams/:team_id/projection
sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/competitors/:team_id/roster?season=YYYY
site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3?enable=roster
sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/teams/:team_id/projection
site.api.espn.com/apis/site/v3/sports/football/nfl/leaders{?season,seasontype}
site.api.espn.com/apis/site/v2/sports/football/college-football/scoreboard{?dates=YYYYMMDD}
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
site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates={YYYYMMDD}-{YYYYMMDD}&pbpOnly=true
site.api.espn.com/apis/site/v2/sports/football/nfl/news
site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl
https://stmorse.github.io/journal/espn-fantasy-v3.html
sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2/statisticslog
sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/teams/:team_id
--
- ESPN's hidden API endpoints, gist by by akeaswaran
- nfl-nerd: api
- Using ESPN's new Fantasy API (v3)
You're probably right!!!
Here is another random question for anyone to figure out:
Check out this link: https://static.www.nfl.com/gamecenter/ae9d66f7-1312-11ef-afd1-646009f18b2e.pdf
This the game book you can download from any NFL.com link on the box score page.
Particularly look at K.Mitchell KOR statistics. He has 3 for 79 yards.
When I look through the play by play descriptions I see:
Can anyone make it make sense how the NFL determines that K. Mitchell has 3 returns for 79 yards?
To me the ones without the penalties are easy:
26 yards
29 yards
55 yards on those two.
So to end with 3 for 79 the third one calculated must be 24 yards, right?
Does that mean they credit the Return yards all the way up to WHERE the penalty occurred? The ball ends on the 14 yard line after the 10 yard penalty. To me it feels like K. Mitchell should get a 14 yard return on the one with the penalty, but it's pretty clear they give him the 24 yards from the 0 yard line to the 24 where the Holding occurred. Versus where the BALL ends up after the holding is enforced.
Is that the same way they would do a running play? If a RB has a 35 yard run, but after a holding downfield on a WR is enforced the gain on the play is 10 total yards from the LOS. Would that mean the RB gets a 20 yard run on his stats? That seems wierd to me.