This page has been updated a lot in the past 2 years. It might be helpful to look at older revisions. View latest 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/
)
- nfl-nerd
- ESPN's hidden API endpoints
- Using ESPN's new Fantasy API (v3)
- ESPN: Get Endpoint (CRAN Package)
Name | Description |
---|---|
:year |
Integer year in which the season started (YYYY ) |
:seasontype |
1=pre, 2=regular, 3=post |
:league_id |
Fantasy league id |
:bet_provider_id |
38=Caesars, 31=William Hill, 41=SugarHouse, 36=Unibet, 2000=Bet 365, 25=Westgate, 45=William Hill (NJ), 1001=accuscore, 1004=consensus, 1003=numberfire, 1002=teamrankings |
:team_id |
1-32 (view all) |
:athlete_id |
view all |
API for getting ids:
- Athletes: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true
- Teams: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams?limit=32
- Positions: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=75
- Venues: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues?limit=700
Odds:
-
Win probabilities: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/probabilities?limit=200
-
Odds: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds
-
Against-the-spread: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/types/2/teams/:team_id/ats
-
Futures: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/futures
-
Head-to-head (game): sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/:game_id/competitions/:game_id/odds/:bet_provider_id/head-to-heads
-
Odds records: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/types/0/teams/:team_id/odds-records
-
Positions (enum): sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions?limit=100
-
QBR Weekly/Game stats: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:season/types/2/weeks/:week_num/qbr/10000
-
Past performances: sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/odds/:bet_provider_id/past-performances?limit=200
Teams:
- site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id
- sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id
- site.api.espn.com/apis/site/v2/sports/football/nfl/teams
- Depthcharts: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/depthcharts
- Roster:
site.api.espn.com/apis/site/v2/sports/football/nfl/teams/:team_id/roster
?enable=roster,projection,stats
-
Injuries: sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/injuries
-
Past performance:sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/:team_id/odds/1002/past-performances?limit=140
-
Projection:sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/teams/:team_id/projection
Games:
-
Game summary: site.api.espn.com/apis/site/v2/sports/football/nfl/summary?event=:game_id
-
News: site.api.espn.com/apis/site/v2/sports/football/nfl/news
-
Weeks: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks
-
Season: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year
-
Events: sports.core.api.espn.com/v2/sports/football/leagues/nfl/events
-
get game ids: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks/:week/events
-
Draft: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/draft
-
free agents: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/freeagents
-
calendar: sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar
-
current season game dates: sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist
-
blacklist: sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist
-
whitelist: http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist
League:
-
transactions: sports.core.api.espn.com/v2/sports/football/leagues/nfl/transactions
-
groups: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/groups
-
franchises: sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises
Scoreboard:
-
site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=YYYYMMDD
-
site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=YYYYMMDD-YYYYMMDD
-
site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=YYYY
-
All weeks in given season: sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/weeks
Performance:
- Current leaders: sports.core.api.espn.com/v2/sports/football/leagues/nfl/leaders
-
Leaders (filter): site.api.espn.com/apis/site/v3/sports/football/nfl/leaders
{?season,seasontype}
-
Leaders (year): sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/:year/types/:seasontype/leaders
-
Talent picks: sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks
-
Athletes: sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes
?limits=200
-
statisticslog: sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/2/statisticslog
-
Athlete Overview: site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/:athlete_id/overview
Search:
-
site.web.api.espn.com/apis/common/v3/search?region=us&lang=en&query=nfl&limit=5&mode=prefix
-
site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates={YYYYMMDD}-{YYYYMMDD}&pbpOnly=true
-
News: site.api.espn.com/apis/site/v2/sports/football/nfl/news
-
Header: site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl
/apis/common/v3/search
Example: https://site.web.api.espn.com/apis/common/v3/search?limit=100&query=nfl
Results
{
"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",
/apis/fantasy/v2/games/ffl/games
Example: https://site.web.api.espn.com/apis/fantasy/v2/games/ffl/games?dates=20210901-20211108
Results
{
"statistics": [
{
"id": 2330,
"gameId": "401326322",
"proTeamId": "27",
"positionId": "1",
"stats": {
"210": 1,
"21": 64,
"1": 32,
"20": 2,
"0": 50,
"4": 4,
"3": 379,
/apis/v2/scoreboard/header
Example: https://site.web.api.espn.com/apis/v2/scoreboard/header?sport=football&league=nfl
Results
{
"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",
/v3/colleges/2509
Example: https://sports.core.api.espn.com/v3/colleges/2509
Results
{
"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
Results
{
"$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",
/apis/common/v3/sports/football/nfl/athletes/athlete_id
Example: https://site.web.api.espn.com/apis/common/v3/sports/football/nfl/athletes/14876
Results
{
"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
Results
{
"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
Results
{
"$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,
/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
Results
{
"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",
/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
Results
{
"$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,
/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
Results
{
"categories": [
{
"name": "passing",
"displayName": "Passing",
"count": 11
},
{
"name": "rushing",
"displayName": "Rushing",
"count": 5
}
],
"filters": [
{
/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
Results
{
"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"
}
]
}
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/athletes/athlete_id
/projections
Results
{
"$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": [
{
/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
Results
{
"filters": [
{
"displayName": "League",
"name": "league",
"value": "nfl",
"options": [
{
"value": "college-football",
"displayValue": "NCAAF"
},
{
"value": "nfl",
"displayValue": "NFL"
}
/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
Results
{
"$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
Results
{
"$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
Results
{
"$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": [
{
/v2/sports/football/leagues/nfl/athletes/athlete_id
/statisticslog
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/14876/statisticslog
Results
{
"$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"
}
},
{
/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
Results
{
"filters": [
{
"displayName": "League",
"name": "league",
"value": "nfl",
"options": [
{
"value": "college-football",
"displayValue": "NCAAF"
},
{
"value": "nfl",
"displayValue": "NFL"
}
/v2/sports/football/leagues/nfl/calendar
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar
Results
{
"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"
}
]
}
/v2/sports/football/leagues/nfl/calendar/blacklist
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist
Results
{
"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",
/v2/sports/football/leagues/nfl/calendar/whitelist
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist
Results
{
"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",
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/drives/drive_id
Results
{
"$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
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/odds
Results
{
"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
Results
{
"$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,
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/plays/play_id
Results
{
"$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
Results
{
"$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"
},
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/probabilities/probabilities_id
Results
{
"$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
Results
{
"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
},
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/competitors/competitors_id
/roster
Results
{
"$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": {
/v2/sports/football/leagues/nfl/seasons/year
/draft/athletes
Results
{
"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"
/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
Results
{
"count": 7,
"pageIndex": 1,
"pageSize": 25,
"pageCount": 1,
"items": [
{
"number": 1,
"displayName": "1st Round",
"shortDisplayName": "1st",
"picks": [
{
"status": {
"id": 3,
"name": "SELECTION_MADE",
/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
Results
{
"round": 7,
"type": {
"id": 3,
"name": "COMPLETED",
"state": "post",
"description": "Completed"
}
}
/v2/sports/football/leagues/nfl/events
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events
Results
{
"$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
Results
{
"$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"
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
Results
{
"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,
/v2/sports/football/leagues/nfl/franchises
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/franchises
Results
{
"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
Results
{
"$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": [
{
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/groups/group_id
/standings
Results
{
"count": 4,
"pageIndex": 1,
"pageSize": 25,
"pageCount": 1,
"items": [
{
"id": "0",
"name": "overall",
"displayName": "Overall Standings",
"links": [
{
"language": "en-US",
"rel": [
/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
Results
{
"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"
}
]
}
/apis/site/v3/sports/football/nfl/leaders
Example: https://site.api.espn.com/apis/site/v3/sports/football/nfl/leaders?season=2021
Results
"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
Results
{
"$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
Results
{
"$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,
/apis/site/v2/sports/football/nfl/news
Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/news
Results
{
"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
},
/v2/sports/football/leagues/nfl/events/event_id
/competitions/event_id
/odds/provider_id
/predictors
Results
{
"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"
}
},
/v2/sports/football/leagues/nfl/positions/position_id
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8
Results
{
"$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
Results
{
"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"
},
/v2/sports/football/leagues/nfl/providers/provider_id
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/providers/1003
Results
{
"id": "1003",
"name": "numberfire",
"priority": 0
}
/apis/site/v2/sports/football/nfl/scoreboard
Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard
Results
{
"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,
/v2/sports/football/leagues/nfl/seasons
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons
Results
{
"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
Results
{
"$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",
/v2/sports/football/leagues/nfl/seasons/year
/athletes
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes
Results
{
"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
Results
{
"$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,
/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
Results
{
"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
Results
{
"$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"
}
]
}
/v2/sports/football/leagues/nfl/seasons/year
/draft
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft
Results
{
"$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"
/v2/sports/football/leagues/nfl/seasons/year
/futures
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures
Results
{
"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
Results
{
"$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": {
/v2/sports/football/leagues/nfl/seasons/year
/teams
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams
Results
{
"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
Results
{
"$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",
/v2/sports/football/leagues/nfl/seasons/year
/types
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types
Results
{
"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
Results
{
"$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"
},
/v2/sports/football/leagues/nfl/talentpicks
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/talentpicks
Results
{
"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",
/apis/site/v2/sports/football/nfl/teams
Example: https://site.api.espn.com/apis/site/v2/sports/football/nfl/teams
Results
{
"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
Results
{
"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": [
/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
Results
{
"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"
},
/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
Results
{
"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"
}
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/attendance
Results
{
"id": "0",
"name": "Attendance",
"abbreviation": "ATTND",
"categories": [
{
"name": "home",
"displayName": "Home",
"shortDisplayName": "Home",
"abbreviation": "home",
"stats": [
{
"name": "games",
"displayName": "Home Games",
/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
Results
{
"count": 1,
"pageIndex": 1,
"pageSize": 25,
"pageCount": 1,
"items": [{}]
}
/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
Results
{
"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",
/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
Results
{
"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"
},
/v2/sports/football/leagues/nfl/teams/team_id
/injuries
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/teams/12/injuries
Results
{
"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"
},
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/leaders
Results
{
"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,
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/odds-records
Results
{
"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",
/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
Results
{
"$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
}
/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
Results
{
"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,
/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
Results
{
"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
}
/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
Results
{
"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",
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/teams/team_id
/statistics
Results
{
"$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
Results
{
"$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",
/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
Results
{
"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
Results
{
"$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"
}
}
/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
Results
{
"$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"
}
},
/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
Results
{
"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
Results
{
"$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"
/v2/sports/football/leagues/nfl/venues/venue_id
Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/venues/3493
Results
{
"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",
/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
Results
{
"$meta": {
"parameters": {
"week": [
"6"
],
"season": [
"2021"
],
"seasontypes": [
"2"
]
}
},
"count": 14,
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/weeks/weeknum
/qbr/10000
Results
{
"$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": {
/v2/sports/football/leagues/nfl/seasons/year
/types/seasontype
/weeks/weeknum
/talentpicks
Results
{
"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",
You're probably right!!!
Here is another random question for anyone to figure out:
Check out this link: https://static.www.nfl.com/gamecenter/ae9d66f7-1312-11ef-afd1-646009f18b2e.pdf
This the game book you can download from any NFL.com link on the box score page.
Particularly look at K.Mitchell KOR statistics. He has 3 for 79 yards.
When I look through the play by play descriptions I see:
Can anyone make it make sense how the NFL determines that K. Mitchell has 3 returns for 79 yards?
To me the ones without the penalties are easy:
26 yards
29 yards
55 yards on those two.
So to end with 3 for 79 the third one calculated must be 24 yards, right?
Does that mean they credit the Return yards all the way up to WHERE the penalty occurred? The ball ends on the 14 yard line after the 10 yard penalty. To me it feels like K. Mitchell should get a 14 yard return on the one with the penalty, but it's pretty clear they give him the 24 yards from the 0 yard line to the 24 where the Holding occurred. Versus where the BALL ends up after the holding is enforced.
Is that the same way they would do a running play? If a RB has a 35 yard run, but after a holding downfield on a WR is enforced the gain on the play is 10 total yards from the LOS. Would that mean the RB gets a 20 yard run on his stats? That seems wierd to me.