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)
When I heavily involved in DFS my approach was to use the NBA injury report page and twitter. Maybe things have changed the past couple years but ESPN was always super sketchy with updates.