list of nfl api endpoints from espn

Nội Dung Chính

List of NFL API Endpoints

View updated list here

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:

Endpoints

GET Requests

Example: https://site.web.api.espn.com/apis/common/v3/search?limit=100&query=nfl

{  

"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

"

,

Example: https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108

{  

"statistics"

: [ {

"id"

:

2330

,

"gameId"

:

"

401326322

"

,

"proTeamId"

:

"

27

"

,

"positionId"

:

"

1

"

,

"stats"

: {

"210"

:

1

,

"21"

:

64

,

"1"

:

32

,

"20"

:

2

,

"0"

:

50

,

"4"

:

4

,

"3"

:

379

,

Example: https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl

{  

"sports"

: [ {

"id"

:

"

20

"

,

"uid"

:

"

s:20

"

,

"name"

:

"

Football

"

,

"slug"

:

"

football

"

,

"leagues"

: [ {

"id"

:

"

28

"

,

"uid"

:

"

s:20~l:28

"

,

"name"

:

"

National Football League

"

,

"abbreviation"

:

"

NFL

"

,

"shortName"

:

"

NFL

"

,

"slug"

:

"

nfl

"

,

"isTournament"

:

false

,

"events"

: [ {

"gamecastAvailable"

:

true

,

"playByPlayAvailable"

:

true

,

"commentaryAvailable"

:

false

,

"recent"

:

false

,

"id"

:

"

401326598

"

,

"competitionId"

:

"

401326598

"

,

"uid"

:

"

s:20~l:28~e:401326598~c:401326598

"

,

"date"

:

"

2022-01-08T21:30:00Z

"

,

"timeValid"

:

true

,

"name"

:

"

Kansas City Chiefs at Denver Broncos

"

,

"shortName"

:

"

KC @ DEN

"

,

"location"

:

"

Empower Field at Mile High

"

,

"season"

:

2021

,

"seasonStartDate"

:

"

2021-07-17T07:00:00Z

"

,

"seasonEndDate"

:

"

2022-01-13T07:59:00Z

"

,

Example: https://sports.core.api.espn.com/v3/colleges/2509

{  

"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

{  

"$ref"

:

"

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

"

,

"id"

:

"

28

"

,

"guid"

:

"

ad4c3bd2-ddb6-3f8c-8abf-744855a08fa4

"

,

"uid"

:

"

s:20~l:28

"

,

"name"

:

"

National Football League

"

,

"abbreviation"

:

"

NFL

"

,

"shortName"

:

"

NFL

"

,

"slug"

:

"

nfl

"

,

"isTournament"

:

false

,

"season"

: {

"$ref"

:

"

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

"

,

"year"

:

2021

,

"startDate"

:

"

2021-07-17T07:00Z

"

,

"endDate"

:

"

2022-02-16T07:59Z

"

,

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

{  

"athlete"

: {

"id"

:

"

14876

"

,

"uid"

:

"

s:20~l:28~a:14876

"

,

"guid"

:

"

2d6af5dcb3d3e2d4cf7227d4a8eb93cd

"

,

"type"

:

"

football

"

,

"firstName"

:

"

Ryan

"

,

"lastName"

:

"

Tannehill

"

,

"displayName"

:

"

Ryan Tannehill

"

,

"fullName"

:

"

Ryan Tannehill

"

,

"debutYear"

:

2012

,

"jersey"

:

"

17

"

,

"links"

: [ {

"language"

:

"

en

"

,

/v2/sports/football/leagues/nfl/athletes

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000

{  

"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&region=us

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3049325?lang=en&region=us

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3915373?lang=en&region=us

"

},

/v2/sports/football/leagues/nfl/athletes/athlete_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876

{  

"$ref"

:

"

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

"

,

"id"

:

"

12483

"

,

"uid"

:

"

s:20~l:28~a:12483

"

,

"guid"

:

"

20c41c33a33f6dc27e1f0771e39ce49a

"

,

"type"

:

"

football

"

,

"alternateIds"

: {

"sdr"

:

"

2219510

"

},

"firstName"

:

"

Matthew

"

,

"lastName"

:

"

Stafford

"

,

"fullName"

:

"

Matthew Stafford

"

,

"displayName"

:

"

Matthew Stafford

"

,

"shortName"

:

"

M. Stafford

"

,

"weight"

:

220

,

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

{  

"teamHistory"

: [ {

"id"

:

"

10

"

,

"uid"

:

"

s:20~l:28~t:10

"

,

"slug"

:

"

tennessee-titans

"

,

"displayName"

:

"

Tennessee Titans

"

,

"logo"

:

"

https://a.espncdn.com/i/teamlogos/nfl/500/ten.png

"

,

"seasons"

:

"

2019-CURRENT

"

,

"links"

: [ {

"language"

:

"

en

"

,

"rel"

: [

"

clubhouse

"

,

"

desktop

"

,

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876/eventlog

"

,

"teams"

: {

"10"

: {

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/10

"

},

"id"

:

"

10

"

} },

"events"

: {

"count"

:

14

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

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

{  

"categories"

: [ {

"name"

:

"

passing

"

,

"displayName"

:

"

Passing

"

,

"count"

:

11

}, {

"name"

:

"

rushing

"

,

"displayName"

:

"

Rushing

"

,

"count"

:

5

} ],

"filters"

: [ {

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

{  

"count"

:

1

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"id"

:

"

498444

"

,

"type"

:

"

news

"

,

"date"

:

"

2021-12-17T20:14Z

"

,

"headline"

:

"

Stafford and the Rams aren't in line to play the Seahawks on Sunday, with the NFL expected to reschedule the game for Tuesday at 7 p.m. ET, pending official confirmation, Adam Schefter of ESPN reports.

"

,

"text"

:

"

Due to ongoing COVID-19-related issues within the Rams organization, the NFL is hopeful that by delaying the game two days, Los Angeles will be able to restore enough players from the reserve/COVID-19 list to alleviate depth concerns on the roster. After Tuesday's game, the Rams will face a quick turnaround for Week 16 with a Sunday game in Minnesota on Dec. 26.

"

,

"source"

:

"

RotoWire

"

} ]}

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0

"

,

"season"

: {

"$ref"

:

"

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

"

},

"athlete"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876

"

},

"splits"

: {

"id"

:

"

0

"

,

"name"

:

"

All Splits

"

,

"abbreviation"

:

"

Any

"

,

"type"

:

"

total

"

,

"categories"

: [ {

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

{  

"filters"

: [ {

"displayName"

:

"

League

"

,

"name"

:

"

league

"

,

"value"

:

"

nfl

"

,

"options"

: [ {

"value"

:

"

college-football

"

,

"displayValue"

:

"

NCAAF

"

}, {

"value"

:

"

nfl

"

,

"displayValue"

:

"

NFL

"

}

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/12483/statistics/0

"

,

"athlete"

: {

"$ref"

:

"

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

"

},

"splits"

: {

"id"

:

"

0

"

,

"name"

:

"

All Splits

"

,

"abbreviation"

:

"

Any

"

,

"categories"

: [ {

"name"

:

"

general

"

,

"displayName"

:

"

General

"

,

"shortDisplayName"

:

"

General

"

,

"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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0

"

,

"season"

: {

"$ref"

:

"

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

"

},

"athlete"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876

"

},

"splits"

: {

"id"

:

"

0

"

,

"name"

:

"

All Splits

"

,

"abbreviation"

:

"

Any

"

,

"type"

:

"

total

"

,

"categories"

: [ {

/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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/12483/statistics/0

"

,

"season"

: {

"$ref"

:

"

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

"

},

"athlete"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/12483

"

},

"splits"

: {

"id"

:

"

0

"

,

"name"

:

"

All Splits

"

,

"abbreviation"

:

"

Any

"

,

"type"

:

"

total

"

,

"categories"

: [ {

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog

"

,

"entries"

: [ {

"season"

: {

"$ref"

:

"

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

"

},

"statistics"

: [ {

"type"

:

"

total

"

,

"statistics"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/athletes/14876/statistics/0

"

} }, {

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

{  

"filters"

: [ {

"displayName"

:

"

League

"

,

"name"

:

"

league

"

,

"value"

:

"

nfl

"

,

"options"

: [ {

"value"

:

"

college-football

"

,

"displayValue"

:

"

NCAAF

"

}, {

"value"

:

"

nfl

"

,

"displayValue"

:

"

NFL

"

}

CALENDAR

/v2/sports/football/leagues/nfl/calendar

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

{  

"count"

:

4

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

} ]}

CALENDAR BLACKLIST

/v2/sports/football/leagues/nfl/calendar/blacklist

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist

{  

"type"

:

"

list

"

,

"startDate"

:

"

2021-07-17T07:00Z

"

,

"endDate"

:

"

2022-02-16T07:59Z

"

,

"eventDate"

: {

"type"

:

"

blacklist

"

,

"dates"

: [

"

2021-07-17T07:00Z

"

,

"

2021-07-18T07:00Z

"

,

"

2021-07-19T07:00Z

"

,

"

2021-07-20T07:00Z

"

,

"

2021-07-21T07:00Z

"

,

"

2021-07-22T07:00Z

"

,

"

2021-07-23T07:00Z

"

,

CALENDAR WHITELIST

/v2/sports/football/leagues/nfl/calendar/whitelist

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist

{  

"type"

:

"

list

"

,

"startDate"

:

"

2021-07-17T07:00Z

"

,

"endDate"

:

"

2022-02-16T07:59Z

"

,

"eventDate"

: {

"type"

:

"

whitelist

"

,

"dates"

: [

"

2021-08-05T07:00Z

"

,

"

2021-08-12T07:00Z

"

,

"

2021-08-13T07:00Z

"

,

"

2021-08-14T07:00Z

"

,

"

2021-08-15T07:00Z

"

,

"

2021-08-19T07:00Z

"

,

"

2021-08-20T07:00Z

"

,

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/drives/4012490631

"

,

"id"

:

"

4012490631

"

,

"description"

:

"

16 plays, 75 yards, 9:18

"

,

"sequenceNumber"

:

"

1

"

,

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23

"

},

"endTeam"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/23

"

},

"start"

: {

"period"

: {

"type"

:

"

quarter

"

,

"number"

:

1

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

{  

"count"

:

11

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/odds/43

"

,

"provider"

: {

"$ref"

:

"

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

"

,

"id"

:

"

43

"

,

"name"

:

"

Caesars Sportsbook (Pennsylvania)

"

,

"priority"

:

1

},

"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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/odds/1003

"

,

"provider"

: {

"$ref"

:

"

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

"

,

"id"

:

"

1003

"

,

"name"

:

"

numberfire

"

,

"priority"

:

0

},

"details"

:

"

ATL -3.5

"

,

"overUnder"

:

48.5

,

"spread"

:

-3.5

,

"overOdds"

:

45.31

,

"underOdds"

:

54.69

,

"awayTeamOdds"

: {

"averageScore"

:

20.62

,

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401249063/competitions/401249063/plays/4012490631

"

,

"id"

:

"

4012490631

"

,

"sequenceNumber"

:

"

100

"

,

"type"

: {

"id"

:

"

70

"

,

"text"

:

"

Coin Toss

"

},

"text"

:

"

GAME

"

,

"shortText"

:

"

PIT Win Toss, Elect to Receive

"

,

"alternativeText"

:

"

GAME

"

,

"shortAlternativeText"

:

"

PIT Win Toss, Elect to Receive

"

,

"awayScore"

:

0

,

"homeScore"

:

0

,

"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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays?source=2

"

,

"count"

:

167

,

"pageIndex"

:

1

,

"pageSize"

:

100

,

"pageCount"

:

2

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays/4012201811

"

,

"id"

:

"

4012201811

"

,

"sequenceNumber"

:

"

100

"

,

"type"

: {

"id"

:

"

70

"

,

"text"

:

"

Coin Toss

"

},

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/probabilities/4012490631

"

,

"competition"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315

"

},

"play"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315/plays/4012490631

"

},

"homeTeam"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1

"

},

"awayTeam"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21

"

},

"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

{  

"count"

:

166

,

"pageIndex"

:

1

,

"pageSize"

:

200

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities/4012201811

"

,

"competition"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181

"

},

"play"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays/4012201811

"

},

"homeTeam"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/teams/34

"

},

"awayTeam"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/teams/33

"

},

"tiePercentage"

:

0

,

"homeWinPercentage"

:

0.312

,

"awayWinPercentage"

:

0.688

,

"lastModified"

:

"

2020-09-21T00:14Z

"

,

"sequenceNumber"

:

"

100

"

,

"source"

: {

"id"

:

"

2

"

,

"description"

:

"

feed

"

,

"state"

:

"

full

"

},

"secondsLeft"

:

0

},

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/competitors/34/roster

"

,

"entries"

: [ {

"playerId"

:

13979

,

"period"

:

0

,

"active"

:

false

,

"starter"

:

true

,

"forPlayerId"

:

0

,

"jersey"

:

"

99

"

,

"valid"

:

true

,

"athlete"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/athletes/13979

"

},

"position"

: {

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

{  

"count"

:

366

,

"pageIndex"

:

1

,

"pageSize"

:

500

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104734

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104760

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104737

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes/104933

"

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

{  

"count"

:

7

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"number"

:

1

,

"displayName"

:

"

1st Round

"

,

"shortDisplayName"

:

"

1st

"

,

"picks"

: [ {

"status"

: {

"id"

:

3

,

"name"

:

"

SELECTION_MADE

"

,

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

{  

"round"

:

7

,

"type"

: {

"id"

:

3

,

"name"

:

"

COMPLETED

"

,

"state"

:

"

post

"

,

"description"

:

"

Completed

"

}}

EVENTS

/v2/sports/football/leagues/nfl/events

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

{  

"$meta"

: {

"parameters"

: {

"week"

: [

"

15

"

],

"season"

: [

"

2021

"

],

"seasontypes"

: [

"

2

"

] } },

"count"

:

16

,

/v2/sports/football/leagues/nfl/events/event_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315

{  

"$ref"

:

"

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

"

,

"id"

:

"

401326315

"

,

"uid"

:

"

s:20~l:28~e:401326315

"

,

"date"

:

"

2021-09-12T17:00Z

"

,

"name"

:

"

Philadelphia Eagles at Atlanta Falcons

"

,

"shortName"

:

"

PHI @ ATL

"

,

"season"

: {

"$ref"

:

"

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

"

},

"seasonType"

: {

"$ref"

:

"

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

"

},

"week"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1

"

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

{  

"id"

:

"

401326315

"

,

"guid"

:

"

b64e5dc5-c943-33e6-a6c9-44008b28b11a

"

,

"uid"

:

"

s:20~l:28~e:401326315~c:401326315

"

,

"date"

:

"

2021-09-12T17:00Z

"

,

"attendance"

:

68633

,

"type"

: {

"id"

:

"

1

"

,

"text"

:

"

Standard

"

,

"abbreviation"

:

"

STD

"

,

"slug"

:

"

standard

"

,

"type"

:

"

standard

"

},

"necessary"

:

false

,

FRANCHISES

/v2/sports/football/leagues/nfl/franchises

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

{  

"count"

:

32

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

2

,

"items"

: [ {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

},

/v2/sports/football/leagues/nfl/franchises/franchise_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises/1

{  

"$ref"

:

"

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

"

,

"id"

:

"

1

"

,

"uid"

:

"

s:20~l:28~f:1

"

,

"slug"

:

"

atlanta-falcons

"

,

"location"

:

"

Atlanta

"

,

"name"

:

"

Falcons

"

,

"nickname"

:

"

Atlanta

"

,

"abbreviation"

:

"

ATL

"

,

"displayName"

:

"

Atlanta Falcons

"

,

"shortDisplayName"

:

"

Falcons

"

,

"color"

:

"

000000

"

,

"isActive"

:

true

,

"logos"

: [ {

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

{  

"count"

:

4

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"id"

:

"

0

"

,

"name"

:

"

overall

"

,

"displayName"

:

"

Overall Standings

"

,

"links"

: [ {

"language"

:

"

en-US

"

,

"rel"

: [

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

{  

"count"

:

4

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28

"

} ]}

LEADERS

/apis/site/v3/sports/football/nfl/leaders

Example: https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021

  

"leaders"

: {

"id"

:

"

0

"

,

"name"

:

"

TOTAL

"

,

"abbreviation"

:

"

Any

"

,

"categories"

: [ {

"name"

:

"

passingYards

"

,

"displayName"

:

"

Passing Yards

"

,

"abbreviation"

:

"

YDS

"

,

"leaders"

: [ {

"displayValue"

:

"

404

"

,

"value"

:

404

,

"rel"

: [

"

athlete

"

],

"athlete"

: {

"id"

:

"

3139477

"

,

"uid"

:

"

s:20~l:28~a:3139477

"

,

"guid"

:

"

37d87523280a9d4a0adb22cfc6d3619c

"

,

"firstName"

:

"

Patrick

"

,

"lastName"

:

"

Mahomes

"

,

"displayName"

:

"

Patrick Mahomes

"

,

"fullName"

:

"

Patrick Mahomes

"

,

/v2/sports/football/leagues/nfl/leaders

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

{  

"$ref"

:

"

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

"

,

"id"

:

"

0

"

,

"name"

:

"

total

"

,

"abbreviation"

:

"

TOTAL

"

,

"categories"

: [ {

"name"

:

"

totalPoints

"

,

"displayName"

:

"

Total Points

"

,

"shortDisplayName"

:

"

TP

"

,

"abbreviation"

:

"

TP

"

,

"leaders"

: [ {

"displayValue"

:

"

2673

"

,

"value"

:

2673

,

/v2/sports/football/leagues/nfl/leaders/0

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders/0

{  

"$ref"

:

"

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

"

,

"id"

:

"

0

"

,

"name"

:

"

total

"

,

"abbreviation"

:

"

TOTAL

"

,

"categories"

: [ {

"name"

:

"

totalPoints

"

,

"displayName"

:

"

Total Points

"

,

"shortDisplayName"

:

"

TP

"

,

"abbreviation"

:

"

TP

"

,

"leaders"

: [ {

"displayValue"

:

"

2673

"

,

"value"

:

2673

,

NEWS

/apis/site/v2/sports/football/nfl/news

Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news

{  

"header"

:

"

NFL News

"

,

"link"

: {

"language"

:

"

en

"

,

"rel"

: [

"

index

"

,

"

desktop

"

,

"

league

"

],

"href"

:

"

https://www.espn.com/nfl/

"

,

"text"

:

"

All NFL News

"

,

"shortText"

:

"

All News

"

,

"isExternal"

:

false

,

"isPremium"

:

false

},

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

{  

"count"

:

5

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"rank"

:

1

,

"total"

:

"

OVER

"

,

"value"

:

90.363

,

"displayValue"

:

"

90.4

"

,

"predictorCompetition"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401326315/competitions/401326315

"

},

"projectedWinner"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8

"

},

"cover"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/8

"

},

"projectedCover"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1

"

} },

POSITIONS

/v2/sports/football/leagues/nfl/positions/position_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8

{  

"$ref"

:

"

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

"

,

"id"

:

"

8

"

,

"name"

:

"

Quarterback

"

,

"displayName"

:

"

Quarterback

"

,

"abbreviation"

:

"

QB

"

,

"leaf"

:

true

,

"parent"

: {

"$ref"

:

"

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

"

}}

/v2/sports/football/leagues/nfl/positions

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100

{  

"count"

:

73

,

"pageIndex"

:

1

,

"pageSize"

:

100

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

},

PROVIDERS

/v2/sports/football/leagues/nfl/providers/provider_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003

{  

"id"

:

"

1003

"

,

"name"

:

"

numberfire

"

,

"priority"

:

0

}

SCOREBOARD

/apis/site/v2/sports/football/nfl/scoreboard

Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard

{  

"leagues"

: [ {

"id"

:

"

28

"

,

"uid"

:

"

s:20~l:28

"

,

"name"

:

"

National Football League

"

,

"abbreviation"

:

"

NFL

"

,

"slug"

:

"

nfl

"

,

"season"

: {

"year"

:

2021

,

"startDate"

:

"

2021-07-17T07:00Z

"

,

"endDate"

:

"

2022-02-16T07:59Z

"

,

"type"

: {

"id"

:

"

2

"

,

"type"

:

2

,

SEASONS

/v2/sports/football/leagues/nfl/seasons

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

{  

"count"

:

100

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

4

,

"items"

: [ {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

},

/v2/sports/football/leagues/nfl/seasons/year

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021

{  

"$ref"

:

"

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

"

,

"year"

:

2021

,

"startDate"

:

"

2021-07-17T07:00Z

"

,

"endDate"

:

"

2022-02-16T07:59Z

"

,

"displayName"

:

"

2021

"

,

"type"

: {

"$ref"

:

"

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

"

,

"id"

:

"

2

"

,

"type"

:

2

,

"name"

:

"

Regular Season

"

,

"abbreviation"

:

"

reg

"

,

"year"

:

2021

,

"startDate"

:

"

2021-09-09T07:00Z

"

,

"endDate"

:

"

2022-01-13T07:59Z

"

,

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

{  

"count"

:

16438

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

658

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4246273

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4246281

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4246289

"

},

/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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/14876

"

,

"id"

:

"

14876

"

,

"uid"

:

"

s:20~l:28~a:14876

"

,

"guid"

:

"

2d6af5dcb3d3e2d4cf7227d4a8eb93cd

"

,

"type"

:

"

football

"

,

"alternateIds"

: {

"sdr"

:

"

2268110

"

},

"firstName"

:

"

Ryan

"

,

"lastName"

:

"

Tannehill

"

,

"fullName"

:

"

Ryan Tannehill

"

,

"displayName"

:

"

Ryan Tannehill

"

,

"shortName"

:

"

R. Tannehill

"

,

"weight"

:

217

,

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

{  

"count"

:

32

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

2

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/17739

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/2552857

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/13162

"

},

/v2/sports/football/leagues/nfl/seasons/year/coaches/coach_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695

{  

"$ref"

:

"

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

"

,

"id"

:

"

4408695

"

,

"uid"

:

"

s:20~l:28~co:4408695

"

,

"firstName"

:

"

Kevin

"

,

"lastName"

:

"

Stefanski

"

,

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/5

"

},

"experience"

:

1

,

"careerRecords"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695/record/0

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695/record/2

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/4408695/record/3

"

} ],

"coachSeasons"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/coaches/4408695

"

}, {

"$ref"

:

"

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

{  

"$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

"

,

"shortDisplayName"

:

"

2021 NFL Draft

"

,

"status"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/status

"

},

"athletes"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes

"

},

"rounds"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/rounds

"

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

{  

"count"

:

7

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561

"

,

"id"

:

1561

,

"name"

:

"

Pro Football Champion

"

,

"futures"

: [ {

"provider"

: {

"id"

:

"

40

"

,

"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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures/1561

"

,

"id"

:

1561

,

"name"

:

"

Pro Football Champion

"

,

"futures"

: [ {

"provider"

: {

"id"

:

"

40

"

,

"name"

:

"

DraftKings

"

,

"active"

:

1

,

"priority"

:

0

},

"books"

: [ {

"team"

: {

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

{  

"count"

:

32

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

2

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/2

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/3

"

},

/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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1

"

,

"id"

:

"

1

"

,

"guid"

:

"

49fd392a86fe4df31b779bbfa18b2ad5

"

,

"uid"

:

"

s:20~l:28~t:1

"

,

"alternateIds"

: {

"sdr"

:

"

8802

"

},

"slug"

:

"

atlanta-falcons

"

,

"location"

:

"

Atlanta

"

,

"name"

:

"

Falcons

"

,

"nickname"

:

"

Atlanta

"

,

"abbreviation"

:

"

ATL

"

,

"displayName"

:

"

Atlanta Falcons

"

,

"shortDisplayName"

:

"

Falcons

"

,

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

{  

"count"

:

4

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/1

"

}, {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/3

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/4

"

} ]}

/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

{  

"$ref"

:

"

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

"

,

"id"

:

"

2

"

,

"type"

:

2

,

"name"

:

"

Regular Season

"

,

"abbreviation"

:

"

reg

"

,

"year"

:

2021

,

"startDate"

:

"

2021-09-09T07:00Z

"

,

"endDate"

:

"

2022-01-13T07:59Z

"

,

"hasGroups"

:

false

,

"hasStandings"

:

true

,

"hasLegs"

:

false

,

"groups"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups

"

},

TALENTPICKS

/v2/sports/football/leagues/nfl/talentpicks

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

{  

"count"

:

176

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

8

,

"items"

: [ {

"pick"

: {

"person"

: {

"id"

:

"

1768

"

,

"firstName"

:

"

Damien

"

,

"lastName"

:

"

Woody

"

,

"displayName"

:

"

Damien Woody

"

,

"headshot"

: {

"href"

:

"

https://a.espncdn.com/i/columnists/full/woody_damien.png

"

,

TEAM

/apis/site/v2/sports/football/nfl/teams

Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams

{  

"sports"

: [ {

"id"

:

"

20

"

,

"uid"

:

"

s:20

"

,

"name"

:

"

Football

"

,

"slug"

:

"

football

"

,

"leagues"

: [ {

"id"

:

"

28

"

,

"uid"

:

"

s:20~l:28

"

,

"name"

:

"

National Football League

"

,

"abbreviation"

:

"

NFL

"

,

"shortName"

:

"

NFL

"

,

"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

{  

"team"

: {

"id"

:

"

1

"

,

"uid"

:

"

s:20~l:28~t:1

"

,

"slug"

:

"

atlanta-falcons

"

,

"location"

:

"

Atlanta

"

,

"name"

:

"

Falcons

"

,

"nickname"

:

"

Atlanta

"

,

"abbreviation"

:

"

ATL

"

,

"displayName"

:

"

Atlanta Falcons

"

,

"shortDisplayName"

:

"

Falcons

"

,

"color"

:

"

000000

"

,

"alternateColor"

:

"

000000

"

,

"isActive"

:

true

,

"logos"

: [

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

{  

"count"

:

76

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

4

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/16963

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3123963

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/16299

"

},

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

{  

"count"

:

9

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"wins"

:

6

,

"losses"

:

8

,

"pushes"

:

0

,

"type"

: {

"id"

:

"

0

"

,

"name"

:

"

atsOverall

"

,

"description"

:

"

Overall team season record against the spread

"

}

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

{  

"id"

:

"

0

"

,

"name"

:

"

Attendance

"

,

"abbreviation"

:

"

ATTND

"

,

"categories"

: [ {

"name"

:

"

home

"

,

"displayName"

:

"

Home

"

,

"shortDisplayName"

:

"

Home

"

,

"abbreviation"

:

"

home

"

,

"stats"

: [ {

"name"

:

"

games

"

,

"displayName"

:

"

Home Games

"

,

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

{  

"count"

:

1

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [{}]}

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

{  

"count"

:

3

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"id"

:

"

15

"

,

"name"

:

"

Base 3-4 D

"

,

"positions"

: {

"lde"

: {

"position"

: {

"id"

:

"

11

"

,

"name"

:

"

Left Defensive End

"

,

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

{  

"count"

:

20

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

}, {

"$ref"

:

"

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

"

},

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

{  

"count"

:

63

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

3

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4408854/injuries/-1252999

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3048898/injuries/499227

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3055899/injuries/499204

"

},

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

{  

"id"

:

"

0

"

,

"name"

:

"

TOTAL

"

,

"abbreviation"

:

"

Any

"

,

"categories"

: [ {

"name"

:

"

passingLeader

"

,

"displayName"

:

"

Passing Leader

"

,

"shortDisplayName"

:

"

PASS

"

,

"abbreviation"

:

"

PYDS

"

,

"leaders"

: [ {

"displayValue"

:

"

360-549, 4052 YDS, 30 TD, 13 INT

"

,

"value"

:

4052

,

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

{  

"count"

:

10

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"abbreviation"

:

"

ML

"

,

"displayName"

:

"

Money Line Overall Record

"

,

"shortDisplayName"

:

"

Money Line

"

,

"type"

:

"

moneyLineOverall

"

,

"stats"

: [ {

"displayName"

:

"

Wins

"

,

"abbreviation"

:

"

W

"

,

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1/projection

"

,

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1

"

},

"chanceToWinThisWeek"

:

0.59114

,

"chanceToWinDivision"

:

0

,

"projectedWins"

:

7.085

,

"projectedLosses"

:

9.908

}

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

{  

"count"

:

5

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"id"

:

"

0

"

,

"name"

:

"

All Splits

"

,

"abbreviation"

:

"

Any

"

,

"type"

:

"

total

"

,

"summary"

:

"

10-4

"

,

"displayValue"

:

"

10-4

"

,

"value"

:

0.7142857142857143

,

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

{  

"timestamp"

:

"

2021-12-21T12:39:06Z

"

,

"status"

:

"

success

"

,

"season"

: {

"year"

:

2021

,

"type"

:

2

,

"name"

:

"

Regular Season

"

},

"coach"

: [ {

"id"

:

"

17739

"

,

"firstName"

:

"

Arthur

"

,

"lastName"

:

"

Smith

"

,

"experience"

:

0

}

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

{  

"timestamp"

:

"

2021-12-21T12:39:07Z

"

,

"status"

:

"

success

"

,

"season"

: {

"year"

:

2021

,

"type"

:

2

,

"name"

:

"

Regular Season

"

,

"displayName"

:

"

2021

"

,

"half"

:

1

},

"team"

: {

"id"

:

"

1

"

,

"abbreviation"

:

"

ATL

"

,

"location"

:

"

Atlanta

"

,

"name"

:

"

Falcons

"

,

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/1/statistics/0

"

,

"season"

: {

"$ref"

:

"

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

"

},

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1

"

},

"splits"

: {

"id"

:

"

0

"

,

"name"

:

"

All Splits

"

,

"abbreviation"

:

"

Any

"

,

"categories"

: [ {

"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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/teams/12/statistics/0

"

,

"season"

: {

"$ref"

:

"

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

"

},

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12

"

},

"splits"

: {

"id"

:

"

0

"

,

"name"

:

"

All Splits

"

,

"abbreviation"

:

"

Any

"

,

"categories"

: [ {

"name"

:

"

general

"

,

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

{  

"count"

:

2

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/8

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/7

"

} ]}

/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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9

"

,

"uid"

:

"

s:20~l:28~g:9

"

,

"id"

:

"

9

"

,

"name"

:

"

National Football League

"

,

"abbreviation"

:

"

NFL

"

,

"shortName"

:

"

NFL

"

,

"season"

: {

"$ref"

:

"

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

"

},

"children"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9/children

"

},

"standings"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9/standings

"

},

"isConference"

:

false

,

"slug"

:

"

national-football-league

"

,

"teams"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/9/teams

"

}}

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/3/leaders

"

,

"id"

:

"

0

"

,

"name"

:

"

TOTAL

"

,

"abbreviation"

:

"

Any

"

,

"categories"

: [ {

"name"

:

"

passingYards

"

,

"displayName"

:

"

Passing Yards

"

,

"shortDisplayName"

:

"

PYDS

"

,

"abbreviation"

:

"

YDS

"

,

"leaders"

: [ {

"displayValue"

:

"

404

"

,

"value"

:

404

,

"rel"

: [

"

athlete

"

],

"athlete"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3139477

"

},

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12

"

},

"statistics"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/3/athletes/3139477/statistics/0

"

} },

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

{  

"count"

:

18

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

1

,

"items"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/1

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/2

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/3

"

},

/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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6

"

,

"number"

:

6

,

"startDate"

:

"

2021-10-13T07:00Z

"

,

"endDate"

:

"

2021-10-20T06:59Z

"

,

"text"

:

"

Week 6

"

,

"teamsOnBye"

: [ {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/1

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/18

"

}, {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/20

"

VENUES

/v2/sports/football/leagues/nfl/venues/venue_id

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493

{  

"id"

:

"

3493

"

,

"fullName"

:

"

Caesars Superdome

"

,

"address"

: {

"city"

:

"

New Orleans

"

,

"state"

:

"

LA

"

,

"zipCode"

:

"

70112

"

},

"capacity"

:

73000

,

"grass"

:

false

,

"indoor"

:

true

,

"images"

: [ {

"href"

:

"

https://a.espncdn.com/i/venues/nfl/day/3493.jpg

"

,

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

{  

"$meta"

: {

"parameters"

: {

"week"

: [

"

6

"

],

"season"

: [

"

2021

"

],

"seasontypes"

: [

"

2

"

] } },

"count"

:

14

,

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

{  

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/qbr/10000

"

,

"count"

:

28

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

2

,

"items"

: [ {

"athlete"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/2330

"

},

"team"

: {

"$ref"

:

"

http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27

"

},

"event"

: {

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

{  

"count"

:

154

,

"pageIndex"

:

1

,

"pageSize"

:

25

,

"pageCount"

:

7

,

"items"

: [ {

"pick"

: {

"person"

: {

"id"

:

"

1768

"

,

"firstName"

:

"

Damien

"

,

"lastName"

:

"

Woody

"

,

"displayName"

:

"

Damien Woody

"

,

"headshot"

: {

"href"

:

"

https://a.espncdn.com/i/columnists/full/woody_damien.png

"

,

Additional Resources / Further Reading