Skip to content

Instantly share code, notes, and snippets.

@KevinDuganJr
Forked from nntrn/espn-api-list.md
Created May 13, 2021 18:51
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save KevinDuganJr/0a536510645d6483be8d6114dd1f4917 to your computer and use it in GitHub Desktop.
Save KevinDuganJr/0a536510645d6483be8d6114dd1f4917 to your computer and use it in GitHub Desktop.
List of api endpoints for espn

ESPN API ENDPOINTS FOR NFL

This page is limited to NFL but can be refashioned for other sports (i.e. /sports/football/leagues/nfl/ => /sports/baseball/leagues/mlb/)

Game

detailed plays: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/plays?limit=300

detailed win probabilities sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/probabilities?limit=200

detailed odds: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds


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

athlete: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/athletes/:athlete_id

teams: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams

team: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id

depthcharts: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/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/:year

odds

against-the-spread: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/2/teams/:team_id/ats

futures: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/futures

head-to-head (game): sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/: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/:year/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

providers:

  • 38: Caesars
  • 31: William Hill
  • 41: SugarHouse
  • 36: Unibet
  • 2000: Bet 365
  • 25: Westgate
  • 45: William Hill (New Jersey)
  • 1001: accuscore
  • 1004: consensus
  • 1003: numberfire
  • 1002: teamrankings

positions (enum): sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100

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/:year/types/:season_type/weeks

QBR Weekly/Game stats: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/:week_num/qbr/10000

list of games via date-range: site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20210228

  • date range cannot exceed 13 months
  • dates can also be = YYYYMMDD, YYYY
  • add &1577413600 at the end for overriding the cache (

Athlete

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

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/2/athletes/:athlete_id/statistics

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/athletes/:athlete_id/projections

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/competitors/:team_id/roster/:athlete_id/statistics/0

Team

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/types/2/teams/:team_id/statistics

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/teams/:team_id/odds/1002/past-performances?limit=140

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/:year/teams/:team_id/projection

sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/odds/:bet_provider_id/past-performances?limit=200

Leaders

site.api.espn.com/apis/site/v3/sports/football/nfl/leaders{?season,seasontype}

Scoreboard

site.api.espn.com/apis/site/v2/sports/football/college-football**/scoreboard**{?dates=YYYYMMDD}

Search

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

News

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

fantasy

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

Resources

seasontype

  • year - Integer year in which the season started.
  • type - Integer corresponding to the season type (1 = preseason, 2 = regular season, 3 = postseason).
  • description - String representation of the season type. For example, "regular" for season type 2.

$ref

sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2/statisticslog

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id

team's athlete: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/athletes?limit=200

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment