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®ion=us"
},
{
"$ref"
: "
http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3049325?lang=en®ion=us"
},
{
"$ref"
: "
http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3915373?lang=en®ion=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"
,
