Skip to content

Instantly share code, notes, and snippets.

@nntrn
Last active April 27, 2025 17:50
Show Gist options
  • Save nntrn/ee26cb2a0716de0947a0a4e9a157bc1c to your computer and use it in GitHub Desktop.
Save nntrn/ee26cb2a0716de0947a0a4e9a157bc1c to your computer and use it in GitHub Desktop.
List of nfl api endpoints from espn

List of NFL API Endpoints

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/)

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 Sports betting operator, view under odds
:team_id 1-32 (view all)
:athlete_id view all

Table of Contents:


ESPN Base Urls

site.api.espn[.com]

sports.core.api.espn[.com]


Teams

team api
ATL
/v2/sports/football/leagues/nfl/seasons/2021/teams/1 /athletes, /depthcharts, /record, /events, /projections
BUF
/v2/sports/football/leagues/nfl/seasons/2021/teams/2 /athletes, /depthcharts, /record, /events, /projections
CHI
/v2/sports/football/leagues/nfl/seasons/2021/teams/3 /athletes, /depthcharts, /record, /events, /projections
CIN
/v2/sports/football/leagues/nfl/seasons/2021/teams/4 /athletes, /depthcharts, /record, /events, /projections
CLE
/v2/sports/football/leagues/nfl/seasons/2021/teams/5 /athletes, /depthcharts, /record, /events, /projections
DAL
/v2/sports/football/leagues/nfl/seasons/2021/teams/6 /athletes, /depthcharts, /record, /events, /projections
DEN
/v2/sports/football/leagues/nfl/seasons/2021/teams/7 /athletes, /depthcharts, /record, /events, /projections
DET
/v2/sports/football/leagues/nfl/seasons/2021/teams/8 /athletes, /depthcharts, /record, /events, /projections
GB
/v2/sports/football/leagues/nfl/seasons/2021/teams/9 /athletes, /depthcharts, /record, /events, /projections
TEN
/v2/sports/football/leagues/nfl/seasons/2021/teams/10 /athletes, /depthcharts, /record, /events, /projections
IND
/v2/sports/football/leagues/nfl/seasons/2021/teams/11 /athletes, /depthcharts, /record, /events, /projections
KC
/v2/sports/football/leagues/nfl/seasons/2021/teams/12 /athletes, /depthcharts, /record, /events, /projections
LV
/v2/sports/football/leagues/nfl/seasons/2021/teams/13 /athletes, /depthcharts, /record, /events, /projections
LAR
/v2/sports/football/leagues/nfl/seasons/2021/teams/14 /athletes, /depthcharts, /record, /events, /projections
MIA
/v2/sports/football/leagues/nfl/seasons/2021/teams/15 /athletes, /depthcharts, /record, /events, /projections
MIN
/v2/sports/football/leagues/nfl/seasons/2021/teams/16 /athletes, /depthcharts, /record, /events, /projections
NE
/v2/sports/football/leagues/nfl/seasons/2021/teams/17 /athletes, /depthcharts, /record, /events, /projections
NO
/v2/sports/football/leagues/nfl/seasons/2021/teams/18 /athletes, /depthcharts, /record, /events, /projections
NYG
/v2/sports/football/leagues/nfl/seasons/2021/teams/19 /athletes, /depthcharts, /record, /events, /projections
NYJ
/v2/sports/football/leagues/nfl/seasons/2021/teams/20 /athletes, /depthcharts, /record, /events, /projections
PHI
/v2/sports/football/leagues/nfl/seasons/2021/teams/21 /athletes, /depthcharts, /record, /events, /projections
ARI
/v2/sports/football/leagues/nfl/seasons/2021/teams/22 /athletes, /depthcharts, /record, /events, /projections
PIT
/v2/sports/football/leagues/nfl/seasons/2021/teams/23 /athletes, /depthcharts, /record, /events, /projections
LAC
/v2/sports/football/leagues/nfl/seasons/2021/teams/24 /athletes, /depthcharts, /record, /events, /projections
SF
/v2/sports/football/leagues/nfl/seasons/2021/teams/25 /athletes, /depthcharts, /record, /events, /projections
SEA
/v2/sports/football/leagues/nfl/seasons/2021/teams/26 /athletes, /depthcharts, /record, /events, /projections
TB
/v2/sports/football/leagues/nfl/seasons/2021/teams/27 /athletes, /depthcharts, /record, /events, /projections
WSH
/v2/sports/football/leagues/nfl/seasons/2021/teams/28 /athletes, /depthcharts, /record, /events, /projections
CAR
/v2/sports/football/leagues/nfl/seasons/2021/teams/29 /athletes, /depthcharts, /record, /events, /projections
JAX
/v2/sports/football/leagues/nfl/seasons/2021/teams/30 /athletes, /depthcharts, /record, /events, /projections
BAL
/v2/sports/football/leagues/nfl/seasons/2021/teams/33 /athletes, /depthcharts, /record, /events, /projections
HOU
/v2/sports/football/leagues/nfl/seasons/2021/teams/34 /athletes, /depthcharts, /record, /events, /projections

Fantasy

Current season and last 3 years

fantasy.espn.com/apis/v3/games/ffl/seasons/:year/segments/0/leagues/:league_id

League History - get all historical data

fantasy.espn.com/apis/v3/games/ffl/leagueHistory/:league_id?seasonId=:year


Example combining views

https://fantasy.espn.com/apis/v3/games/ffl/leagueHistory/1241838?seasonId=2019&view=mMatchup&view=mMatchupScore

View example combining all

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

Detailed API

Leagues

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

Athletes

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

Plays

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

Depth charts

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

Week

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:week

All weeks

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks

List of games via date-range

site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=YYYYMMDD-YYYYMMDD

  • Add &1577413600 at the end for overriding the cache
  • Date range cannot exceed 13 months
  • Format for date can be date range, single date, or year

Betting

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

Odds

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

Win probabilities

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

Against the spread (ATS)

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

future_id
1561 Super Bowl Winner
2737 AFC South Division Winner
2738 AFC North Division Winner
2739 AFC West Division Winner
2740 AFC East Division Winner
2757 AFC Champion
3904 NFC Champion
3905 NFC North Division Winner
3906 NFC East Division Winner
3907 NFC West Division Winner
3908 NFC South Division Winner

Futures

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

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

Game Odds

sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds/:bet_provider_id/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

Stats

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/:year/types/2/weeks/:week_num/qbr/10000

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=2021

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/:seasontype/athletes/:athlete_id/statistics

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

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

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

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/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/:team_id?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}

sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/leaders

Scoreboard

site.api.espn.com/apis/site/v2/sports/football/nfl/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

Misc

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

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


Resources

================================================================================
SOURCE
================================================================================
List of endpoints used in this gist
GIST
https://gist.github.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c
BASE URLS
* https://site.api.espn.com
* https://site.web.api.espn.com
* https://sports.core.api.espn.com
ALL ENDPOINTS
* https://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
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20180901
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20200901-20201022
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2021
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=20210901
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=401326315
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/1
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3/roster
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3/schedule?season=2020&seasontype=2
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/3?enable=roster,projection,stats
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/roster
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4/schedule?season=2019
* https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams/4?enable=roster,projection,stats
* https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021&seasontype=2
* https://site.web.api.espn.com/apis/common/v3/search
* https://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/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
* 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/splits
* https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/splits?season=2021
* https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876/stats
* https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108&pbpOnly=true
* https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes
* https://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?active=true
* 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?limit=200
* 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/401220181/competitions/401220181/competitors/34/roster/2508176/statistics/0
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220225/competitions/401220225/competitors/12/roster
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220225/competitions/401220225/competitors/12/roster?season=2019
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/head-to-heads
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/odds/1002/history/0/movement?limit=100
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays?limit=300
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/probabilities?limit=200
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders
* 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/seasons
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/athletes/2330/eventlog
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/athletes/2972304/statistics
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/athletes/3061612/projections
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/types/2/weeks/6/qbr/10000
* 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/2580
* 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/freeagents
* 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/1
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/11
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/11/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/11/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/11/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/11/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/11/record
* 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/teams/12/athletes
* 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/teams/12/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/13
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/13/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/13/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/13/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/13/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/13/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/14
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/14/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/14/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/14/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/14/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/14/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/15
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/15/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/15/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/15/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/15/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/15/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/16
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/16/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/16/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/16/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/16/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/16/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/17
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/17/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/17/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/17/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/17/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/17/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/athletes?limit=200
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/22
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/22/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/22/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/22/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/22/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/22/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/24/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/25
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/25/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/25/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/25/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/25/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/25/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/26
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/26/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/26/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/26/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/26/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/26/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/29
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/29/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/29/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/29/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/29/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/29/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/30
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/30/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/30/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/30/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/30/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/30/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/33
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/33/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/33/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/33/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/33/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/33/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/34
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/34/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/34/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/34/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/34/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/34/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/4
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/4/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/4/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/4/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/4/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/4/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/7
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/7/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/7/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/7/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/7/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/7/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/9
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/9/athletes
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/9/depthcharts
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/9/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/9/projection
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/9/record
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/0/teams/4/odds-records
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/3061612/projections
* 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/teams/24/statistics
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/26/ats
* 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/1/events
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/9
* 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/4/groups
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4/groups/9
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=134
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/10/odds/1002/past-performances?limit=200
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/injuries?limit=100
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/8/odds/1002/past-performances?limit=140
* https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions
@JimNayzium
Copy link

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:

C.Boswell kicks 62 yards from PIT 35 to BLT 3. K.Mitchell to BLT 29 for 26 yards (M.Robinson).

C.Boswell kicks 65 yards from PIT 35 to BLT 0. K.Mitchell to BLT 28 for 28 yards (B.Bishop).
PENALTY on BLT-M.Harrison, Offensive Holding, 10 yards, enforced at BLT 24.

C.Boswell kicks 63 yards from PIT 35 to BLT 2. K.Mitchell pushed ob at BLT 31 for 29 yards (B.Bishop).

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.

@chisox721
Copy link

right now https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/types/2/athletes/3915416/statistics and https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/types/2/athletes/3915416/projections

show the same stats. Is this suppose to happen since it is the off-season meaning it will update when the 2025 season comes around?

Was looking into something similar recently. My assumption is you're right but maybe just check the projections endpoint for 2025 once in awhile prior to July 31st.

@chisox721
Copy link

The description text in the plays feeds refers to the players who get penalties like this:

PENALTY on BUF-Do.Williams.

But I cannot find any references from the feeds on where that short name gets defined. The athlete individual end points have a shortName property that in this case would be equal to:

D. Williams

But no where in the feeds can I find Dorian Williams referenced as BUF-Do.Williams or Do.Williams.

Which is not the biggest deal as we can recreate a player database to match them all I guess, but it just feels like ESPN has this information out there if we could find it. They clearly add the second and third letter to the abbreviation when multiple players on the same team would match if they left it one letter.

Anyone seen this information in a roster feed or team feed somewhere?

I can't check until later today but am 99% sure you just need to work with the "core" prefix instead of "site".

@JimNayzium
Copy link

I can't check until later today but am 99% sure you just need to work with the "core" prefix instead of "site".

Not sure exactly what you mean, as all the links I am asking about do start with sports.core?

@JimNayzium
Copy link

Has anyone else noticed that Kickoff Returners are not assigned a participant type of returner sometimes? Meaning, if we want to accumulate or track kickoff yardage that was not returned for a touchdown from the plays or drives, we have to just do a string parsing of the description texts. That seems insane on ESPN's side of things. Surely I am missing something?

@chisox721
Copy link

I can't check until later today but am 99% sure you just need to work with the "core" prefix instead of "site".

Not sure exactly what you mean, as all the links I am asking about do start with sports.core?

Oh my fault I was just assuming you hadn't gotten that deep in the weeds yet. My approach is to just take play--> participant->$ref - that way you have 100% certainty on the participant. Then just load the json locally after saving it once before the season or whatever approach you prefer.

Also I came across your previous discussion about rate limiting. For whatever reason I used to get popped routinely when sending requests to the site prefix but have never had issues with core. I'm not even gonna say how many I've sent in 1 day but 2500 is nothing.

@JimNayzium
Copy link

No worries, and thanks for the input!!! That's great to know!
And not all relevant player_id's make it into the participants array, which is why I was asking about that short name.
Often the play is not a penalty type id, if it was declined or enforced betweened downs etc... So I guess I was asking "For player names NOT in the participants array who DO appear in the description, does anyone know where those short names are referenced?"

It's obvious that it's just First initial and last name, UNLESS teh current roster has 2 of those, then it's first two letters and last name, and first three letters and so on and so forth... but just wasn't really able to easily find that information so it's a pain when you are trying to reverse engineer that stuff. Especially when you realize Sauce Gardner is referenced with A.Gardner hahahaah and all sorts of other things like that that make it maddening!

@chisox721
Copy link

No worries, and thanks for the input!!! That's great to know! And not all relevant player_id's make it into the participants array, which is why I was asking about that short name. Often the play is not a penalty type id, if it was declined or enforced betweened downs etc... So I guess I was asking "For player names NOT in the participants array who DO appear in the description, does anyone know where those short names are referenced?"

It's obvious that it's just First initial and last name, UNLESS teh current roster has 2 of those, then it's first two letters and last name, and first three letters and so on and so forth... but just wasn't really able to easily find that information so it's a pain when you are trying to reverse engineer that stuff. Especially when you realize Sauce Gardner is referenced with A.Gardner hahahaah and all sorts of other things like that that make it maddening!

Oh man I get the issue now. Got me having flashbacks to when the NBA broke my code after Marcus and Markieff Morris both ended up on the Suns. Doing a ton of random things with core api the next couple days - if I come across anything that may help I'll report back.

@JimNayzium
Copy link

JimNayzium commented Mar 5, 2025

Can anyone see how we are supposed to know that Josh Downs had 13 rushing yards credited on this play, And Anthony Richardson gets 3? OTHER than parsing through the text or shortText properties and figuring it out?

The statYardage property is 3 yards. The start and end of the play would be different from the statYardage obviously so we could possibly sniff it out that way.

But if feels like Anthony Richardson should also be in the participants array with his own "rusher" value and each participant have their own statYardage.

If you look at the stats array under Josh Downs participant item, it says 13 yards, but had he already had 20 rushing yards in the game that number would be 32.

https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401671856/competitions/401671856/plays/4016718562290

@tdart5
Copy link

tdart5 commented Mar 8, 2025

This is awesome stuff! This is kind of what I have been looking for. I just don't know if this is possible what I am trying to do.

Is it possible to get live scoring of an actual NFL playoff game for fantasy stats? We do our fantasy playoffs during the actual playoffs and we have been calculated scores by hand, but would love to be able to just connect this API to a google sheet and then create formulas to get our scores. We would use the following score types from the fantasy section.

id   displayid  abbrev    description
---  ---------  --------  --------------------------------
3    0          PY        Passing Yards
4    14         PTD       TD Pass
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

24   23         RY        Rushing Yards
25   33         RTD       TD Rush
26   37         2PR       2pt Rushing Conversion
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

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
53   47         REC       Each reception
56   55         REY100    100-199 yard receiving game
57   56         REY200    200+ yard receiving game

63   66         FTD       Fumble Recovered for TD
72   68         FUML      Total Fumbles Lost
101  64         KRTD      Kickoff Return TD
102  65         PRTD      Punt Return TD
103  71         INTTD     Interception Return TD
104  72         FRTD      Fumble Return TD

74   84         FG50P     FG Made (50+ yards)
76   172        FGM50P    FG Missed (50+ yards)
77   83         FG40      FG Made (40-49 yards)
79   89         FGM40     FG Missed (40-49 yards)
80   82         FG0       FG Made (0-39 yards)
82   88         FGM0      FG Missed (0-39 yards)
86   76         PAT       Each PAT Made
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
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
206  74         2PRET     2pt Return
209  75         1PSF      1pt Safety

@SuspectAG
Copy link

I am currently trying to find the endpoints of certain reporters on every sport. However, I am encountering an error on NFL, I just can't get the API endpoint out.

So far I could somehow find out all team IDs, but not the contributor ID or that of Reporter.
Does anyone have a clue?

@MABeatty1978
Copy link

Any chance someone has found an endpoint for the American Hockey League (AHL)?

@JimNayzium
Copy link

I am currently trying to find the endpoints of certain reporters on every sport. However, I am encountering an error on NFL, I just can't get the API endpoint out.

So far I could somehow find out all team IDs, but not the contributor ID or that of Reporter. Does anyone have a clue?

Everything I find that acts like it attributes a "source" to any information is at best "inconsistent" and at worst usually just useless.

@JimNayzium
Copy link

JimNayzium commented Mar 9, 2025

Is there a special end point just for kick off returns? Has anyone else noticed that none of the 2024 participant arrays on any kickoff include a "returner" participant like the punt plays do? Is it possible ESPN calculates KOR yardage purely from text-parsing the descriptions? Surely not?

There is a play-type-id of 53 which is Kickoff (Defense) and play-type-id 12 which is Kickoff Returns, but the play-type-id of 12 is just NEVER in the 2024 drives or plays end points at all.

And to be clear, in the play-type-id 53, often there are "returner" types present in the participants array, but as often, even when the play is not a touchback and not a penalty, there is NOT a returner in the participants array. Its very strange.

@JimNayzium
Copy link

Is there a special end point just for kick off returns? Has anyone else noticed that none of the 2024 participant arrays on any kickoff include a "returner" participant like the punt plays do? Is it possible ESPN calculates KOR yardage purely from text-parsing the descriptions? Surely not?

There is a play-type-id of 53 which is Kickoff (Defense) and play-type-id 12 which is Kickoff Returns, but the play-type-id of 12 is just NEVER in the 2024 drives or plays end points at all.

And to be clear, in the play-type-id 53, often there are "returner" types present in the participants array, but as often, even when the play is not a touchback and not a penalty, there is NOT a returner in the participants array. Its very strange.

I have a little data to update this frustration, that could be useful to anyone else.

It would appear that all kickoffs stopped getting a play-type-id of "12" after week 10 of 2024. Before that, going back to 2022, Espn's play-type-id could be 53,12, or 32 for a kickoff. 32 being a TD return. 12 being an offensive returned kick, and 53 being a touchback or otherwise no returner relevant.

BUT after week 10 of 2024, the id of 53 stayed, and became the only one, and the "returner" type was LEFT out OFF the participants array! Super frustrating if that is what will be the norm moving forward.

Maybe it was an oversight that gets corrected next season somehow.

I HAVE TO imagine this impacted EsPN fantasy leagues who award return yards without leagues even realizing it happened! Crazy.

@ryanbuckner
Copy link

ryanbuckner commented Mar 10, 2025 via email

@JimNayzium
Copy link

It makes sense why odds would be removed, but play by play line score, box score stats in my experience stick around for a good while.

I am more just curious why individual plays in different games are not enforced with the same rules statistically from game to game week to week.

Sometimes on a play with laterals, all the recipients of the lateral get stat yards, and other times they do not.

Also, a glaring thing to me is it would appear from the play by play data that if a player intercepts a pass, then during that play laterals to a teammate, that the final player with the ball when the play ends is labelled by ESPN as both the "returner" and the "passDefender" which means the "passDefender" is credited with the interception statistically.

Surely they must go back and manually reallocate that interception statistic?

@SuspectAG
Copy link

I am currently trying to find the endpoints of certain reporters on every sport. However, I am encountering an error on NFL, I just can't get the API endpoint out.
So far I could somehow find out all team IDs, but not the contributor ID or that of Reporter. Does anyone have a clue?

Everything I find that acts like it attributes a "source" to any information is at best "inconsistent" and at worst usually just useless.

I'm a bit lost :D I still can't figure it out

For example, I want to pull the posts from Adam Schefter [https://www.espn.com/contributor/adam-schefter] directly to my Discord server
But somehow I cannot find his endpoint / ID

@nntrn
Copy link
Author

nntrn commented Mar 10, 2025

For example, I want to pull the posts from Adam Schefter [https://www.espn.com/contributor/adam-schefter] directly to my Discord server But somehow I cannot find his endpoint / ID

@SuspectAG - here ya go

https://site.web.api.espn.com/apis/v2/flex?region=us&lang=en&contentorigin=espn&contributor=adam-schefter&limit=100&pubkey=contributor-page

@SuspectAG
Copy link

SuspectAG commented Mar 10, 2025

For example, I want to pull the posts from Adam Schefter [https://www.espn.com/contributor/adam-schefter] directly to my Discord server But somehow I cannot find his endpoint / ID

@SuspectAG - here ya go

https://site.web.api.espn.com/apis/v2/flex?region=us&lang=en&contentorigin=espn&contributor=adam-schefter&limit=100&pubkey=contributor-page

Wow you are goated, thanks! <3

edit:
and it works like charm! the way I wanted it, for my Server no more X/Twitter 👍
Tested it and with some tweaks its fine

@nntrn
Copy link
Author

nntrn commented Mar 11, 2025

Any chance someone has found an endpoint for the American Hockey League (AHL)?

@MABeatty1978
https://sports.core.api.espn.com/v2/sports/hockey/leagues/nhl

List of endpoints for other leagues (mlb, mma, rugby, soccer, etc)
https://gist.githubusercontent.com/nntrn/ee26cb2a0716de0947a0a4e9a157bc1c/raw/b99b9e0d2df72470fa622e2f76cecb0362111e9a/extending-espn-api.md

@nntrn
Copy link
Author

nntrn commented Mar 11, 2025

Is it possible to get live scoring of an actual NFL playoff game for fantasy stats? We do our fantasy playoffs during the actual playoffs and we have been calculated scores by hand, but would love to be able to just connect this API to a google sheet and then create formulas to get our scores. We would use the following score types from the fantasy section.

@tdart5 - i threw a bunch of stuff together but i hope something helps

https://site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=2977187

https://gambit-api.fantasy.espn.com/apis/v1/dashboards/espn-en?view=allon
https://gambit-api.fantasy.espn.com/apis/v1/challenges/tournament-challenge-bracket-2024/groups/6e682872-7e5f-3aa2-84bf-003cb6a630ae?view=chui_pagetype_group_picks

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/players?view=kona_player_info
https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?scoringPeriodId=0&view=allon
https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=proTeamSchedules_wl
https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024?view=chui_default_platformsettings

Header for increasing the limit returned: X-Fantasy-Filter: {"players":{"limit":3000}}

Example
curl -H 'X-Fantasy-Filter: {"players":{"limit":3000}}' 'https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?view=players_wl'

@adamruehle
Copy link

As far as I can tell, this url "https://sports.core.api.espn.com/v2/sports/{sport}/leagues/{espn_league}/events/{espn_event_id}/competitions/{espn_event_id}/competitors/{espn_team_id}/roster"
doesn't work for college-football. For example:
https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/%7Bespn_event_id%7D/competitions/401628322/competitors/57/roster
This url is a game between florida and uMiami. The team_id is for Florida. The url doesn't work and returns:
{"error":{"message":"Bad event id: '{espn_event_id}' or league 'college-football' not allowed","code":400}}

@propsdaily
Copy link

propsdaily commented Apr 3, 2025

As far as I can tell, this url "https://sports.core.api.espn.com/v2/sports/{sport}/leagues/{espn_league}/events/{espn_event_id}/competitions/{espn_event_id}/competitors/{espn_team_id}/roster" doesn't work for college-football. For example: https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/%7Bespn_event_id%7D/competitions/401628322/competitors/57/roster This url is a game between florida and uMiami. The team_id is for Florida. The url doesn't work and returns: {"error":{"message":"Bad event id: '{espn_event_id}' or league 'college-football' not allowed","code":400}}

@adamruehle Read the error message, you have a typo in your url (passing '{espn_event_id}' as the first event id in the url:
sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/%7Bespn_event_id%7D/competitions/401628322/competitors/57/roster

Should be:
https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/401628322/competitions/401628322/competitors/57/roster

@dice-bet
Copy link

dice-bet commented Apr 6, 2025

hello, need help getting detailed injury reports per team. I can get it from :
https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/teams/3/injuries

but returns links to individual players without names

i know the roster endpoint gives Status Out/Active but im looking for an endpoint that gives full team statuses with injury report. the ESPN injury page has it all for teams
https://www.espn.com/nba/team/injuries/_/name/chi/chicago-bulls

just cant get it in an endpoint, any help is appreciated thanks

update:

got this to work for individual nba teams

https://site.api.espn.com/apis/site/v2/sports/basketball/nba/injuries?team=ATL

for a matchup

https://site.api.espn.com/apis/site/v2/sports/basketball/nba/injuries?team=ATL&team=NYK
https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/injuries?team=ATL&team=NYY

Looks like you need to use abbreviations

@Azami1990
Copy link

Heyho,

is there a way to get the NFL MVP from the API besides searching the news?

Thanks in advance!

@adamruehle
Copy link

Hi, I'm having trouble figuring out how to get the games for college basketball within a specific date range. This link works:
https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard
But then it only shows me recent or upcoming events like the championship between florida and houston. If I try this link:
https://site.api.espn.com/apis/site/v2/sports/basketball/mens-college-basketball/scoreboard?limit=1000&dates=20231218-20240107
I see this error on the webpage {"code":404,"message":"Failed to get events endpoint."}

@bakersoft
Copy link

My 2 cents on the ESPN NBA data - it's unreliable and incomplete. You're better off using the NBA static JSON data they have because 1, most of their JSONs contain everything you need to know in a single request, and 2, it's more conducive to better quality data. The ESPN play by play data for example - there are player ID's in recent data for players who aren't active anymore. There are missing data points - my best example is 3 pointers. You only have descriptions to rely on to pull out the data. Sometimes the player names in the descriptions don't match the player ID's. I reverted to pulling the data from ESPN's website and even then, there are not enough data points to pull the info I wanted. The NBA data has the data points built in and there's little guessing.

@JimNayzium
Copy link

Concerning the NFL only,
Does anyone know any other status text ESPN uses to signify whehter a game is live in progress or not other than these?

  "STATUS_SCHEDULED" ,
  "STATUS_IN_PROGRESS",
  "STATUS_HALFTIME",
  "STATUS_END_PERIOD",
  "STATUS_FINAL"

For example is there a STATUS_OVERTIME or *_OVER_TIME maybe?
Or STATUS_POST_PONED? etc...

thanks!

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