Skip to content

Instantly share code, notes, and snippets.

@nntrn

nntrn/espn-api-list.md

Last active December 27, 2024 22:52
Show Gist options
  • Save nntrn/ee26cb2a0716de0947a0a4e9a157bc1c to your computer and use it in GitHub Desktop.
Save nntrn/ee26cb2a0716de0947a0a4e9a157bc1c to your computer and use it in GitHub Desktop.
Download ZIP
List of nfl api endpoints from espn
Raw
espn-api-list.md

List of NFL API Endpoints

This page has been updated a lot in the past 3 years. Older revisions you might like more than this one:

  • June 2021 - list of endpoints for other sports/leagues (i.e. basketball, baseball, lacrosse, rugby)
  • August 2021 - get historical fantasy league data
  • September 2021 - list of endpoints in plain text
  • May 2023 - collapsed endpoint response examples


Additional Resources


Notes

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

    List of ESPN leagues: API | Document


Paramaters

  • {YEAR}: Football season (YYYY)
  • {SEASONTYPE}: 1=pre, 2=regular, 3=post, 4=off
  • {EVENT_ID}: game id
  • {TEAM_ID}: 1-32 (view all)
  • {ATHLETE_ID}: view all
  • {FANTASY_LEAGUE_ID}: Fantasy league id
  • {BET_PROVIDER_ID}: view all

Table of Contents

Game Night

Reference List

Get list of ids

News

Detailed

Get live updates (xhr=1)

Odds

Teams


[TOC]

Games

Athletes


[TOC]

Calendar

Scoreboard

Leagues

Search


[TOC]

Pick em challenges

Parameters

  • {USER_GAME_ID}
  • {GROUP_ID}
  • CHALLENGE {ID} and {NAME}
    • [231] nfl-win-totals-2023
    • [232] nfl-eliminator-challenge-2023
    • [230] nfl-pigskin-pickem-2023
  • {VIEW_NAME}
    • ⭐ allon
    • ⭐ chui_default
    • chui_default_group
    • chui_default_groupParticipationHistory
    • chui_default_metadata
    • chui_pagetype_group_picks
    • pagetype_leaderboard

Fantasy

v3 header:
X-Fantasy-Filter: {"players":{"limit":2000},"filterActive":{"value":true}}

v2

Fantasy Filters

Fantasy Stats

  • Position

    { "1": "QB",
  "2": "RB",
  "3": "WR",
  "4": "TE",
  "5": "K",
 "16": "DST" }

  • Player stats

    {  "3": "passingYards",
   "4": "passingTouchdowns",
  "19": "passing2PtConversions",
  "20": "passingInterceptions",
  "24": "rushingYards",
  "25": "rushingTouchdowns",
  "26": "rushing2PtConversions",
  "42": "receivingYards",
  "43": "receivingTouchdowns",
  "44": "receiving2PtConversions",
  "53": "receivingReceptions",
  "72": "lostFumbles",
  "74": "madeFieldGoalsFrom50Plus",
  "77": "madeFieldGoalsFrom40To49",
  "80": "madeFieldGoalsFromUnder40",
  "85": "missedFieldGoals",
  "86": "madeExtraPoints",
  "88": "missedExtraPoints",
  "89": "defensive0PointsAllowed",
  "90": "defensive1To6PointsAllowed",
  "91": "defensive7To13PointsAllowed",
  "92": "defensive14To17PointsAllowed",
  "93": "defensiveBlockedKickForTouchdowns",
  "95": "defensiveInterceptions",
  "96": "defensiveFumbles",
  "97": "defensiveBlockedKicks",
  "98": "defensiveSafeties",
  "99": "defensiveSacks",
 "101": "kickoffReturnTouchdown",
 "102": "puntReturnTouchdown",
 "103": "fumbleReturnTouchdown",
 "104": "interceptionReturnTouchdown",
 "123": "defensive28To34PointsAllowed",
 "124": "defensive35To45PointsAllowed",
 "129": "defensive100To199YardsAllowed",
 "130": "defensive200To299YardsAllowed",
 "132": "defensive350To399YardsAllowed",
 "133": "defensive400To449YardsAllowed",
 "134": "defensive450To499YardsAllowed",
 "135": "defensive500To549YardsAllowed",
 "136": "defensiveOver550YardsAllowed" }


[TOC]

REST API Response Examples

TABLE OF CONTENTS


Expand for view

ATHLETE PROFILE API

URL: 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",

URL: 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"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3049325"
    },
    {
      "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes/3915373"
    },

URL: 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,

[TOP]

ATHLETE BIO API

URL: 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",

[TOP]

ATHLETE EVENTLOG API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/14876/eventlog",
  "teams": {
    "10": {
      "team": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/teams/10"
      },
      "id": "10"
    }
  },
  "events": {
    "count": 17,
    "pageIndex": 1,
    "pageSize": 25,
    "pageCount": 1,
    "items": [
      {
        "event": {
          "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640"
        },
        "competition": {
          "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640"
        },
        "statistics": {
          "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437640/competitions/401437640/competitors/10/roster/14876/statistics/0"
        },
        "teamId": "10",
        "played": true
      },

[TOP]

ATHLETE GAMELOG API

URL: 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": [
    {

[TOP]

ATHLETE NOTES API

URL: 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"
    }
  ]
}

[TOP]

ATHLETE PROJECTIONS API

URL: 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": [
      {

[TOP]

ATHLETE SPLITS API

URL: 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"
        }

[TOP]

ATHLETE STATISTICS API

URL: 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",

URL: 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": [
      {

URL: 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": [
      {

[TOP]

ATHLETE STATISTICSLOG API

URL: 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"
          }
        },
        {

[TOP]

ATHLETE STATS API

URL: 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"
        }

[TOP]

CALENDAR API

URL: 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"
    }
  ]
}

[TOP]

CALENDAR BLACKLIST API

URL: 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",

[TOP]

CALENDAR WHITELIST API

URL: 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",

[TOP]

GAME PREDICTION API

Example: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30

{
  "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437954/competitions/401437954/powerindex/30?lang=en&region=us",
  "team": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/teams/30?lang=en&region=us"
  },
  "season": 2022,
  "stats": [
    {
      "name": "teampredptdiff",
      "displayName": "PRED PT DIFF",
      "description": "Expected margin of victory for the FPI favorite.",
      "abbreviation": "PRED PT DIFF",
      "value": 12.175,
      "displayValue": "12.2"
    },
    {
      "name": "gameprojection",
      "displayName": "WIN PROB",
      "description": "Team's predicted win percentage in this game at time of given BPI run",
      "abbreviation": "GAME PROJ",
      "value": 84.81,
      "displayValue": "84.8%"
    },
    {
      "name": "matchupquality",
      "displayName": "MATCHUP QUALITY",
      "description": "A measure of projected competitiveness and excitement in the game, using a 0 to 100 scale, with 100 as the most exciting",
      "abbreviation": "MATCHUP QUALITY",
      "value": 35.261,
      "displayValue": "35.3"
    },
    {
      "name": "teamadjgamescore",
      "displayName": "GAME SCORE",
      "description": "A measure of how well a team performed compared to their expected performance and the expected performance of a typical top 25 team.",
      "abbreviation": "TEAM ADJ GAMESCORE",
      "displayValue": ""
    }
  ]
}

[TOP]

COMPETITION DRIVES API

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

[TOP]

BETTING ODDS API

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

},{
  "provider": {
    "id": "1001",
    "name": "accuscore",
    "priority": 0
  },
  "details": "BAL -7.5",
  "overUnder": 49,
  "spread": 7.5,
  "overOdds": -111,
  "underOdds": -111,
  "awayTeamOdds": {
    "favorite": true,
    "underdog": false,
    "moneyLine": -370,
    "spreadOdds": -111,
    "team": {}
  },
  "homeTeamOdds": {
    "favorite": false,
    "underdog": true,
    "moneyLine": 280,
    "spreadOdds": -111,
    "team": {}
  },
  "moneylineWinner": false,
  "spreadWinner": false
},

URL: 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,

[TOP]

COMPETITION PLAYS API

URL: 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": {

[TOP]

GETS ALL PLAYS FOR A GAME: API

URL: 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"
      },

[TOP]

COMPETITION PROBABILITIES API

URL: 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,

URL: 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
    },

[TOP]

COMPETITOR ROSTER API

URL: 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": {

[TOP]

DRAFT ATHLETES API

URL: 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"

[TOP]

DRAFT ROUNDS API

URL: 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",

[TOP]

DRAFT STATUS API

URL: 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"
  }
}

[TOP]

EVENTS API

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

{
  "$meta": {
    "parameters": {
      "week": [
        "15"
      ],
      "season": [
        "2021"
      ],
      "seasontypes": [
        "2"
      ]
    }
  },
  "count": 16,

URL: 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"

[TOP]

EVENT COMPETITIONS API

URL: 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,

[TOP]

FRANCHISES API

URL: 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"
    },

URL: 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": [
    {

[TOP]

GROUP STANDINGS API

URL: 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": [

[TOP]

GROUP TEAMS API

URL: 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"
    }
  ]
}

[TOP]

LEADERS API

URL: 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",

URL: 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,

URL: 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,

[TOP]

NEWS API

URL: 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
  },

[TOP]

ODD PREDICTORS API

URL: 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"
      }
    },

[TOP]

POSITIONS API

URL: 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"
  }
}

URL: 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"
    },

[TOP]

PROVIDERS API

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

{
  "id": "1003",
  "name": "numberfire",
  "priority": 0
}

[TOP]

SCOREBOARD API

URL: 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,

[TOP]

SEASONS API

URL: 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"
    },

URL: 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",

[TOP]

SEASON ATHLETES API

URL: 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"
    },

URL: 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,

[TOP]

SEASON COACHES API

URL: 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"
    },

URL: 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"
    }
  ]
}

[TOP]

SEASON DRAFT API

URL: 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"

[TOP]

SEASON FUTURES API

URL: 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",

URL: 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": {

[TOP]

SEASON TEAMS API

URL: 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"
    },

URL: 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",

[TOP]

SEASON TYPES API

URL: 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"
    }
  ]
}

URL: 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"
  },

[TOP]

TALENTPICKS API

URL: 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",

[TOP]

TEAM API

URL: 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",

URL: 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": [

[TOP]

TEAM ATHLETES API

URL: 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"
    },

[TOP]

TEAM ATS API

URL: 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"
      }

[TOP]

TEAM ATTENDANCE API

URL: 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",

[TOP]

TEAM COACHES API

URL: 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": [{}]
}

[TOP]

TEAM DEPTHCHARTS API

URL: 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",

[TOP]

TEAM EVENTS API

URL: 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"
    },

[TOP]

TEAM INJURIES API

URL: 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"
    },

[TOP]

TEAM LEADERS API

URL: 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,

[TOP]

TEAM ODDS-RECORDS API

URL: 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",

[TOP]

TEAM PROJECTION API

URL: 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
}

[TOP]

TEAM RECORD API

URL: 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,

[TOP]

TEAM ROSTER API

URL: 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
    }

[TOP]

TEAM SCHEDULE API

URL: 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",

[TOP]

TEAM STATISTICS API

URL: 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",

URL: 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",

[TOP]

SEASONTYPE GROUPS API

URL: 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"
    }
  ]
}

URL: 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"
  }
}

[TOP]

SEASONTYPE LEADERS API

URL: 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"
          }
        },

[TOP]

SEASONTYPE WEEKS API

URL: 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"
    },

URL: 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"

[TOP]

VENUES API

URL: 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",

[TOP]

WEEKLY EVENTS API

URL: 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,

[TOP]

WEEKLY QBR API

URL: 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": {

[TOP]

WEEKLY TALENTPICKS API

URL: 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",
@nntrn
Copy link
Author

nntrn commented May 10, 2023

@michel-wue

API to get rating used in espn.com/nfl/fpi

Projected results are based on 10,000 simulations of the rest of the season using FPI, results to date, and the remaining schedule. Ratings and projections update daily.

curl -s 'https://site.web.api.espn.com/apis/fitt/v3/sports/football/nfl/powerindex' |
  jq -r '.teams
  | map({team:.team.name} + (.categories 
  | map({name,value:(if (.name == "projections") then .values[0:2] else .values[0] end)}) 
  | from_entries))'
[
  { "team": "KC", "fpi": 13.587, "projections": [14, 3], "efficiencies": 68.068 },
  { "team": "PHI", "fpi": 12.731, "projections": [14, 3], "efficiencies": 70.515 },
  { "team": "CIN", "fpi": 11.106, "projections": [12, 4], "efficiencies": 67.391 },
  { "team": "BUF", "fpi": 9.139, "projections": [13, 3], "efficiencies": 73.166 },
  { "team": "DAL", "fpi": 8.367, "projections": [12, 5], "efficiencies": 63.21 },
  { "team": "SF", "fpi": 6.539, "projections": [13, 4], "efficiencies": 71.704 },
  { "team": "GB", "fpi": 6.304, "projections": [8, 9], "efficiencies": 46.629 },
  { "team": "JAX", "fpi": 6.083, "projections": [9, 8], "efficiencies": 52.63 },
  { "team": "MIA", "fpi": 5.246, "projections": [9, 8], "efficiencies": 50.027 },
  { "team": "LAC", "fpi": 3.24, "projections": [10, 7], "efficiencies": 51.099 },
  { "team": "BAL", "fpi": 2.927, "projections": [10, 7], "efficiencies": 56.388 },
  { "team": "PIT", "fpi": 2.234, "projections": [9, 8], "efficiencies": 46.937 },
  { "team": "NYG", "fpi": 2.052, "projections": [9, 7], "efficiencies": 49.769 },
  { "team": "DET", "fpi": 2.043, "projections": [9, 8], "efficiencies": 51.872 },
  { "team": "NE", "fpi": 1.964, "projections": [8, 9], "efficiencies": 50.247 },
  { "team": "MIN", "fpi": 1.65, "projections": [13, 4], "efficiencies": 50.247 },
  { "team": "NO", "fpi": 1.57, "projections": [7, 10], "efficiencies": 45.563 },
  { "team": "CAR", "fpi": 0.564, "projections": [7, 10], "efficiencies": 48.055 },
  { "team": "TEN", "fpi": -0.978, "projections": [7, 10], "efficiencies": 46.538 },
  { "team": "SEA", "fpi": -1.128, "projections": [9, 8], "efficiencies": 50.068 },
  { "team": "ATL", "fpi": -2.285, "projections": [7, 10], "efficiencies": 44.537 },
  { "team": "CLE", "fpi": -2.481, "projections": [7, 10], "efficiencies": 48.043 },
  { "team": "NYJ", "fpi": -3.169, "projections": [7, 10], "efficiencies": 43.457 },
  { "team": "WSH", "fpi": -4.748, "projections": [8, 8], "efficiencies": 45.71 },
  { "team": "DEN", "fpi": -5.155, "projections": [5, 12], "efficiencies": 42.459 },
  { "team": "HOU", "fpi": -5.5, "projections": [3, 13], "efficiencies": 32.317 },
  { "team": "LAR", "fpi": -6.479, "projections": [5, 12], "efficiencies": 37.693 },
  { "team": "TB", "fpi": -8.726, "projections": [8, 9], "efficiencies": 45.692 },
  { "team": "LV", "fpi": -9.59, "projections": [6, 11], "efficiencies": 46.569 },
  { "team": "ARI", "fpi": -15.1, "projections": [4, 13], "efficiencies": 37.772 },
  { "team": "IND", "fpi": -15.128, "projections": [4, 12], "efficiencies": 36.272 },
  { "team": "CHI", "fpi": -16.881, "projections": [3, 14], "efficiencies": 32.191 }
]

@famictech2000
Copy link

Does anyone know how to get historical scoreboards for the NFL?!

@nntrn
Copy link
Author

nntrn commented May 16, 2023 •
edited
Loading

@famictech2000

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=300&dates=<YEAR1>0901-<YEAR2>0101

Try refreshing or changing the limit if you get a gateway error

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=300&dates=20150901-20160301

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=300&dates=20200901-20210301

@famictech2000
Copy link

@nntrn u r a life saver!!!

Thx man!!!

@coolfreak55
Copy link

Might be too early to get this, but was looking for a way to just get all the 2023 NFL games, preseason and regular season and the scores of the games.

I tried https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20230801-20240301 but seems to only be getting weeks 1 and 2 of preseason I think. Obviously scores will be blank until the games are played.

Is there an easier way? Or should just wait till closer to the season?

thanks.

@nntrn
Copy link
Author

nntrn commented May 23, 2023

@coolfreak55
Probably not what you're looking for but closer: http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist

@TDH55
Copy link

TDH55 commented Jun 8, 2023

Does anyone know if any of the score related endpoints return live scores/data?

@nntrn
Copy link
Author

nntrn commented Jun 13, 2023

@TDH55

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2023

curl -o scoreboard.json 'https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2023'

jq -r '.events                                   
  | map(. as $item
  | .competitions[0].competitors
  | map([
      $item.id,$item.status.type.name,$item.date, $item.shortName,
      .team.abbreviation,.homeAway,.score,.winner,
      (((.linescores[]?).value) // ["--","--","--","--","--"] )
    ] | flatten | join(","))
  )
| flatten
| join("\n")' scoreboard.json
Output 
401437933,STATUS_FINAL,2023-01-01T18:00Z,ARI @ ATL,ATL,home,20,true,0,14,0,6
401437933,STATUS_FINAL,2023-01-01T18:00Z,ARI @ ATL,ARI,away,19,false,3,10,3,3
401437935,STATUS_FINAL,2023-01-01T18:00Z,CHI @ DET,DET,home,41,true,7,17,14,3
401437935,STATUS_FINAL,2023-01-01T18:00Z,CHI @ DET,CHI,away,10,false,10,0,0,0
401437937,STATUS_FINAL,2023-01-01T18:00Z,DEN @ KC,KC,home,27,true,6,7,0,14
401437937,STATUS_FINAL,2023-01-01T18:00Z,DEN @ KC,DEN,away,24,false,0,10,7,7
401437938,STATUS_FINAL,2023-01-01T18:00Z,MIA @ NE,NE,home,23,true,7,0,9,7
401437938,STATUS_FINAL,2023-01-01T18:00Z,MIA @ NE,MIA,away,21,false,0,7,7,7
401437939,STATUS_FINAL,2023-01-01T18:00Z,IND @ NYG,NYG,home,38,true,0,24,7,7
401437939,STATUS_FINAL,2023-01-01T18:00Z,IND @ NYG,IND,away,10,false,3,0,7,0
401437940,STATUS_FINAL,2023-01-01T18:00Z,NO @ PHI,PHI,home,10,false,0,0,10,0
401437940,STATUS_FINAL,2023-01-01T18:00Z,NO @ PHI,NO,away,20,true,7,6,0,7
401437941,STATUS_FINAL,2023-01-01T18:00Z,CAR @ TB,TB,home,30,true,0,10,0,20
401437941,STATUS_FINAL,2023-01-01T18:00Z,CAR @ TB,CAR,away,24,false,7,7,0,10
401437942,STATUS_FINAL,2023-01-01T18:00Z,CLE @ WSH,WSH,home,10,false,0,7,0,3
401437942,STATUS_FINAL,2023-01-01T18:00Z,CLE @ WSH,CLE,away,24,true,3,0,14,7
401437936,STATUS_FINAL,2023-01-01T18:00Z,JAX @ HOU,HOU,home,3,false,0,0,3,0
401437936,STATUS_FINAL,2023-01-01T18:00Z,JAX @ HOU,JAX,away,31,true,7,14,7,3
401437943,STATUS_FINAL,2023-01-01T21:05Z,SF @ LV,LV,home,34,false,10,7,7,10,0
401437943,STATUS_FINAL,2023-01-01T21:05Z,SF @ LV,SF,away,37,true,7,7,7,13,3
401437944,STATUS_FINAL,2023-01-01T21:05Z,NYJ @ SEA,SEA,home,23,true,10,7,3,3
401437944,STATUS_FINAL,2023-01-01T21:05Z,NYJ @ SEA,NYJ,away,6,false,3,3,0,0
401437945,STATUS_FINAL,2023-01-01T21:25Z,MIN @ GB,GB,home,41,true,14,13,0,14
401437945,STATUS_FINAL,2023-01-01T21:25Z,MIN @ GB,MIN,away,17,false,3,0,0,14
401437946,STATUS_FINAL,2023-01-01T21:25Z,LAR @ LAC,LAC,home,31,true,0,17,7,7
401437946,STATUS_FINAL,2023-01-01T21:25Z,LAR @ LAC,LAR,away,10,false,3,7,0,0
401437934,STATUS_FINAL,2023-01-02T01:20Z,PIT @ BAL,BAL,home,13,false,0,10,3,0
401437934,STATUS_FINAL,2023-01-02T01:20Z,PIT @ BAL,PIT,away,16,true,3,0,3,10
401437947,STATUS_CANCELED,2023-01-03T01:30Z,BUF @ CIN,CIN,home,0,,--,--,--,--,--
401437947,STATUS_CANCELED,2023-01-03T01:30Z,BUF @ CIN,BUF,away,0,,--,--,--,--,--
401437961,STATUS_FINAL,2023-01-07T21:30Z,KC @ LV,LV,home,13,false,3,0,3,7
401437961,STATUS_FINAL,2023-01-07T21:30Z,KC @ LV,KC,away,31,true,7,17,0,7
401437954,STATUS_FINAL,2023-01-08T01:15Z,TEN @ JAX,JAX,home,20,true,0,7,3,10
401437954,STATUS_FINAL,2023-01-08T01:15Z,TEN @ JAX,TEN,away,16,false,3,10,3,0
401437948,STATUS_FINAL,2023-01-08T18:00Z,TB @ ATL,ATL,home,30,true,10,0,10,10
401437948,STATUS_FINAL,2023-01-08T18:00Z,TB @ ATL,TB,away,17,false,7,10,0,0
401437949,STATUS_FINAL,2023-01-08T18:00Z,NE @ BUF,BUF,home,35,true,7,7,14,7
401437949,STATUS_FINAL,2023-01-08T18:00Z,NE @ BUF,NE,away,23,false,7,7,3,6
401437950,STATUS_FINAL,2023-01-08T18:00Z,MIN @ CHI,CHI,home,13,false,0,6,7,0
401437950,STATUS_FINAL,2023-01-08T18:00Z,MIN @ CHI,MIN,away,29,true,6,10,7,6
401437951,STATUS_FINAL,2023-01-08T18:00Z,BAL @ CIN,CIN,home,27,true,10,14,3,0
401437951,STATUS_FINAL,2023-01-08T18:00Z,BAL @ CIN,BAL,away,16,false,0,7,6,3
401437953,STATUS_FINAL,2023-01-08T18:00Z,HOU @ IND,IND,home,31,false,7,0,14,10
401437953,STATUS_FINAL,2023-01-08T18:00Z,HOU @ IND,HOU,away,32,true,10,7,7,8
401437955,STATUS_FINAL,2023-01-08T18:00Z,NYJ @ MIA,MIA,home,11,true,0,3,3,5
401437955,STATUS_FINAL,2023-01-08T18:00Z,NYJ @ MIA,NYJ,away,6,false,0,3,0,3
401437956,STATUS_FINAL,2023-01-08T18:00Z,CAR @ NO,NO,home,7,false,7,0,0,0
401437956,STATUS_FINAL,2023-01-08T18:00Z,CAR @ NO,CAR,away,10,true,0,0,7,3
401437958,STATUS_FINAL,2023-01-08T18:00Z,CLE @ PIT,PIT,home,28,true,0,10,10,8
401437958,STATUS_FINAL,2023-01-08T18:00Z,CLE @ PIT,CLE,away,14,false,0,7,0,7
401437960,STATUS_FINAL,2023-01-08T21:25Z,LAC @ DEN,DEN,home,31,true,7,10,7,7
401437960,STATUS_FINAL,2023-01-08T21:25Z,LAC @ DEN,LAC,away,28,false,7,10,3,8
401437957,STATUS_FINAL,2023-01-08T21:25Z,NYG @ PHI,PHI,home,22,true,10,6,3,3
401437957,STATUS_FINAL,2023-01-08T21:25Z,NYG @ PHI,NYG,away,16,false,0,0,3,13
401437962,STATUS_FINAL,2023-01-08T21:25Z,ARI @ SF,SF,home,38,true,7,14,17,0
401437962,STATUS_FINAL,2023-01-08T21:25Z,ARI @ SF,ARI,away,13,false,6,7,0,0
401437963,STATUS_FINAL,2023-01-08T21:25Z,LAR @ SEA,SEA,home,19,true,6,0,7,3,3
401437963,STATUS_FINAL,2023-01-08T21:25Z,LAR @ SEA,LAR,away,16,false,3,10,3,0,0
401437959,STATUS_FINAL,2023-01-08T21:25Z,DAL @ WSH,WSH,home,26,true,7,6,7,6
401437959,STATUS_FINAL,2023-01-08T21:25Z,DAL @ WSH,DAL,away,6,false,0,6,0,0
401437952,STATUS_FINAL,2023-01-09T01:20Z,DET @ GB,GB,home,16,false,6,3,7,0
401437952,STATUS_FINAL,2023-01-09T01:20Z,DET @ GB,DET,away,20,true,3,3,7,7
401438000,STATUS_FINAL,2023-01-14T21:30Z,SEA @ SF,SF,home,41,true,10,6,7,18
401438000,STATUS_FINAL,2023-01-14T21:30Z,SEA @ SF,SEA,away,23,false,0,17,0,6
401437998,STATUS_FINAL,2023-01-15T01:15Z,LAC @ JAX,JAX,home,31,true,0,7,13,11
401437998,STATUS_FINAL,2023-01-15T01:15Z,LAC @ JAX,LAC,away,30,false,17,10,3,0
401438002,STATUS_FINAL,2023-01-15T18:00Z,MIA @ BUF,BUF,home,34,true,14,6,14,0
401438002,STATUS_FINAL,2023-01-15T18:00Z,MIA @ BUF,MIA,away,31,false,0,17,7,7
401438001,STATUS_FINAL,2023-01-15T21:50Z,NYG @ MIN,MIN,home,24,false,7,7,7,3
401438001,STATUS_FINAL,2023-01-15T21:50Z,NYG @ MIN,NYG,away,31,true,14,3,7,7
401437999,STATUS_FINAL,2023-01-16T01:15Z,BAL @ CIN,CIN,home,24,true,3,6,8,7
401437999,STATUS_FINAL,2023-01-16T01:15Z,BAL @ CIN,BAL,away,17,false,0,10,7,0
401438003,STATUS_FINAL,2023-01-17T01:15Z,DAL @ TB,TB,home,14,false,0,0,6,8
401438003,STATUS_FINAL,2023-01-17T01:15Z,DAL @ TB,DAL,away,31,true,6,12,6,7
401438005,STATUS_FINAL,2023-01-21T21:30Z,JAX @ KC,KC,home,27,true,7,10,3,7
401438005,STATUS_FINAL,2023-01-21T21:30Z,JAX @ KC,JAX,away,20,false,7,3,0,10
401438004,STATUS_FINAL,2023-01-22T01:15Z,NYG @ PHI,PHI,home,38,true,14,14,0,10
401438004,STATUS_FINAL,2023-01-22T01:15Z,NYG @ PHI,NYG,away,7,false,0,0,7,0
401438007,STATUS_FINAL,2023-01-22T20:00Z,CIN @ BUF,BUF,home,10,false,0,7,3,0
401438007,STATUS_FINAL,2023-01-22T20:00Z,CIN @ BUF,CIN,away,27,true,14,3,7,3
401438006,STATUS_FINAL,2023-01-22T23:30Z,DAL @ SF,SF,home,19,true,3,6,0,10
401438006,STATUS_FINAL,2023-01-22T23:30Z,DAL @ SF,DAL,away,12,false,0,6,3,3
401438009,STATUS_FINAL,2023-01-29T20:00Z,SF @ PHI,PHI,home,31,true,7,14,7,3
401438009,STATUS_FINAL,2023-01-29T20:00Z,SF @ PHI,SF,away,7,false,0,7,0,0
401438008,STATUS_FINAL,2023-01-29T23:30Z,CIN @ KC,KC,home,23,true,3,10,7,3
401438008,STATUS_FINAL,2023-01-29T23:30Z,CIN @ KC,CIN,away,20,false,0,6,7,7
401492629,STATUS_FINAL,2023-02-05T20:00Z,AFC VS NFC,NFC,home,35,true,--,--,--,--,--
401492629,STATUS_FINAL,2023-02-05T20:00Z,AFC VS NFC,AFC,away,33,false,--,--,--,--,--
401438030,STATUS_FINAL,2023-02-12T23:30Z,KC VS PHI,PHI,home,35,false,7,17,3,8
401438030,STATUS_FINAL,2023-02-12T23:30Z,KC VS PHI,KC,away,38,true,7,7,7,17
401547654,STATUS_SCHEDULED,2023-08-04T00:00Z,NYJ VS CLE,CLE,home,0,,--,--,--,--,--
401547654,STATUS_SCHEDULED,2023-08-04T00:00Z,NYJ VS CLE,NYJ,away,0,,--,--,--,--,--
401548631,STATUS_SCHEDULED,2023-08-10T23:00Z,HOU @ NE,NE,home,0,,--,--,--,--,--
401548631,STATUS_SCHEDULED,2023-08-10T23:00Z,HOU @ NE,HOU,away,0,,--,--,--,--,--
401550740,STATUS_SCHEDULED,2023-08-11T02:00Z,MIN @ SEA,SEA,home,0,,--,--,--,--,--
401550740,STATUS_SCHEDULED,2023-08-11T02:00Z,MIN @ SEA,MIN,away,0,,--,--,--,--,--
401548624,STATUS_SCHEDULED,2023-08-11T23:00Z,GB @ CIN,CIN,home,0,,--,--,--,--,--
401548624,STATUS_SCHEDULED,2023-08-11T23:00Z,GB @ CIN,GB,away,0,,--,--,--,--,--
401550739,STATUS_SCHEDULED,2023-08-11T23:00Z,NYG @ DET,DET,home,0,,--,--,--,--,--
401550739,STATUS_SCHEDULED,2023-08-11T23:00Z,NYG @ DET,NYG,away,0,,--,--,--,--,--
401548626,STATUS_SCHEDULED,2023-08-11T23:00Z,ATL @ MIA,MIA,home,0,,--,--,--,--,--
401548626,STATUS_SCHEDULED,2023-08-11T23:00Z,ATL @ MIA,ATL,away,0,,--,--,--,--,--
401550178,STATUS_SCHEDULED,2023-08-11T23:00Z,PIT @ TB,TB,home,0,,--,--,--,--,--
401550178,STATUS_SCHEDULED,2023-08-11T23:00Z,PIT @ TB,PIT,away,0,,--,--,--,--,--

...

@wazhar01
Copy link

wazhar01 commented Aug 1, 2023

how do we get teams' scores from the ESPN API

@ryanbuckner
Copy link

@ARAnalytics-CFB

If anyone knows how to potentially automate the headshots and the years on the players into a google sheet that can link the players ESPN ID to their name, headshot, and year, let me know! Would be very cool for a project I am doing

Here's how I did it for golf. (Sheet is here -> https://docs.google.com/spreadsheets/d/1c6KxAFWjR7Ajg4WCn7uEa8eu55BMjprzbpom8n29IqM/edit?usp=sharing )

1 - 1 time population of the players with id, name, headshoturl into a new tab
2 - VLOOKUP using the =IMAGE() function pulling the headshoturl
3 - using the IFERROR function to point to the ESPN headshot silhouette if there's no headshot https://a.espncdn.com/i/headshots/golf/players/full/0.png

// Returns data from the ESPN API for headshots and IDs
function getAllPlayers(){
  // API error trapping
  options = {muteHttpExceptions: true}; 

  results = [];
  results.push(["ID","Name","Headshot", "Score", "Thru"]);

  var tournament = getTournamentId();
  var url = "https://site.web.api.espn.com/apis/site/v2/sports/golf/leaderboard?league=pga&event=" + tournament + "";
  
  // Hit the API, get the data 
  var json = UrlFetchApp.fetch(url, options).getContentText();
  var data = JSON.parse(json);

  var players = data['events'][0]['competitions'][0]['competitors'];

  // cycle through all the players in the field 
    for (var i = 0; i < players.length; i++) {
      var id = players[i]['id'];
      var name = players[i]['athlete']['displayName']
      var headshot = "https://a.espncdn.com/i/headshots/golf/players/full/" + id + ".png"
      var score = players[i]['score']['displayValue']
      var thru = players[i]['status']['thru']

    // push the game data to the result object 
      results.push([
          id,
          name,
          headshot,
          score,
          thru,
      ]);  
    }
  return results;  
}

@nntrn
Copy link
Author

nntrn commented Aug 2, 2023

@wazhar01

how do we get teams' scores from the ESPN API

You can extract it from https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2023

In terminal:

$ curl -s 'https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates=2023' |
  jq -r ' .events | map(. as $item | .competitions[0].competitors
  | map([$item.id,$item.shortName,$item.date,.team.abbreviation,.homeAway,.score,.winner,
    (((.linescores[]?).value) // ["--","--","--","--","--"] )] | flatten | join(","))) | flatten | join("\n")
  | "id,game_name,date,team,homeAway,total,winner,Q1,Q2,Q3,Q4,OT\n\(.)"' |
  column -s, -t

id         game_name   date               team  homeAway  total  winner  Q1  Q2  Q3  Q4  OT
401437933  ARI @ ATL   2023-01-01T18:00Z  ATL   home      20     true    0   14  0   6
401437933  ARI @ ATL   2023-01-01T18:00Z  ARI   away      19     false   3   10  3   3
401437935  CHI @ DET   2023-01-01T18:00Z  DET   home      41     true    7   17  14  3
401437935  CHI @ DET   2023-01-01T18:00Z  CHI   away      10     false   10  0   0   0
401437937  DEN @ KC    2023-01-01T18:00Z  KC    home      27     true    6   7   0   14
401437937  DEN @ KC    2023-01-01T18:00Z  DEN   away      24     false   0   10  7   7
401437938  MIA @ NE    2023-01-01T18:00Z  NE    home      23     true    7   0   9   7
401437938  MIA @ NE    2023-01-01T18:00Z  MIA   away      21     false   0   7   7   7
...
401547636  PIT @ SEA   2023-12-31T21:05Z  PIT   away      0              --  --  --  --  --
401547630  LAC @ DEN   2023-12-31T21:25Z  DEN   home      0              --  --  --  --  --
401547630  LAC @ DEN   2023-12-31T21:25Z  LAC   away      0              --  --  --  --  --
401547235  CIN @ KC    2023-12-31T21:25Z  KC    home      0              --  --  --  --  --
401547235  CIN @ KC    2023-12-31T21:25Z  CIN   away      0              --  --  --  --  --
401547637  GB @ MIN    2024-01-01T01:20Z  MIN   home      0              --  --  --  --  --
401547637  GB @ MIN    2024-01-01T01:20Z  GB    away      0              --  --  --  --  --

In your browser's devtools (javascript)

JSON.parse(document.querySelector("body").textContent).events.map(
  ({ id, status, shortName, date, competitions, score, winner }) =>
    competitions[0].competitors.map(({ score, winner, linescores, team, homeAway }) => ({
      id,
      status: status.type.name,
      shortName,
      date,
      score,
      winner,
      homeAway,
      team: team.abbreviation,
      linescores: linescores && linescores.map((l) => l.value)
    }))
)
[
  {
    "id": "401437933",
    "status": "STATUS_FINAL",
    "shortName": "ARI @ ATL",
    "date": "2023-01-01T18:00Z",
    "score": "20",
    "winner": true,
    "homeAway": "home",
    "team": "ATL",
    "linescores": [0, 14, 0, 6]
  },
  {
    "id": "401437935",
    "status": "STATUS_FINAL",
    "shortName": "CHI @ DET",
    "date": "2023-01-01T18:00Z",
    "score": "41",
    "winner": true,
    "homeAway": "home",
    "team": "DET",
    "linescores": [7, 17, 14, 3]
  },
  ...
]

@wazhar01
Copy link

wazhar01 commented Aug 4, 2023 •
edited by nntrn
Loading

thanks got it

@joellongaresjr
Copy link

Greetings! I'm a current student enrolled in Berkley's coding extension program. Our current project involves developing an application with similarities to Fantasy Football. Within this application, my team and I are actively exploring methods to obtain an individual player's statistics for a specific week of the 2023 season. What would be the best method to obtain an individual player's stats on a per week basis.

@AliMukhtar081
Copy link

Hi guys can anyone tell if there is a similar source for collage football data as well.

@ryanbuckner
Copy link

ryanbuckner commented Aug 12, 2023 via email

@Chiradanalyst
Copy link

Can we get player-level data and then aggregate that to a team view by each week? EX: I want to know how well the Titans do game by game and to get this, I want to accumulate individual player stats.

@nntrn
Copy link
Author

nntrn commented Aug 14, 2023

@Chiradanalyst -

Get event ids for titans:
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/teams/10/events

Get player id from game roster:
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401548411/competitions/401548411/competitors/3/roster

Get player statistics for game:
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220124/competitions/401220124/competitors/20/roster/8479/statistics/0

--- or

Get eventlog for player: (only available for completed seasons)
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/4259147/eventlog

Get player statistics for season
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/1/athletes/3116746/statistics

@Chiradanalyst
Copy link

Thank you. I think I Got it so | Event = game | then Get the Player ID of all available players on the roster for the Game/Event | Then get Statistics for those players to get Game total Stats.

I want to do this for every game played this season for a project of mine. Please let me know if this is possible or if anyone has created a similar project that I can reference.

@nntrn
Copy link
Author

nntrn commented Aug 14, 2023

@Chiradanalyst - an easier way (maybe) would be doing the math yourself from the play by plays

https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401548411/competitions/401548411/plays?limit=1000

@Chiradanalyst
Copy link

Chiradanalyst commented Aug 15, 2023 •
edited
Loading

Got it @nntrn, I feel like there might be room for error doing that. If I want to take a step back and get team Statistics for each game played this year, is that possible using this API? My end goal would be to have offensive, defensive, and special team statistics for each team this year on a game by game level.

@kjustin765
Copy link

@nntrn If I wanted to create a SQL database with all NFL data. Do you think these API should allow me to pull down all the necessary data I need or would you go another route? Just didn't want to waste my time learning about the API if it wasn't going to be useful.

@Achtbaan
Copy link

Achtbaan commented Aug 29, 2023 •
edited
Loading

Does anyone know a way to get a teams passing/rushing yards allowed per game? Cant seem to find it

@nntrn
Copy link
Author

nntrn commented Aug 29, 2023

@Achtbaan
Does anyone know a way to get a teams passing/rushing yards allowed per game? Cant seem to find it

https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/<GAME_ID>/competitions/<GAME_ID>/competitors/<TEAM_ID>/statistics

@Achtbaan
Copy link

@Achtbaan
Does anyone know a way to get a teams passing/rushing yards allowed per game? Cant seem to find it

https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/<GAME_ID>/competitions/<GAME_ID>/competitors/<TEAM_ID>/statistics

I mean a teams average passing/rushing yards allowed per game over a season.
Sorry for the confusion.

@harrywebb21
Copy link

harrywebb21 commented Sep 7, 2023 •
edited
Loading

for the news api i've noticed that it gives you links and theres an api link for example: http://now.core.api.espn.com/v1/sports/news/35186336

this api link has everything for the article like the main body of text, videos and more

does anyone know if you can fetch from this as I have tried but it just fails

just wanted to know if its possible as I would like to get the articles story data rather than just headlines and descriptions

@nntrn
Copy link
Author

nntrn commented Sep 7, 2023

@harrywebb21 - if you have jq and pandoc, you can run the following in your terminal:

curl -s http://now.core.api.espn.com/v1/sports/news/35186336 | jq -r '.headlines[0].story' | pandoc -f html -t plain
Output 
Nick Bosa is now the highest-paid non-quarterback in NFL history,
putting him among elite company in football ... and beyond.

The San Francisco 49ers and the reigning Defensive Player of the Year
agreed to a five-year, $170 million extension less than a week before
their season opener against the Pittsburgh Steelers.

Last season, Bosa earned his first All-Pro selection and third Pro Bowl
berth by posting a league-leading 18.5 sacks, 51 tackles, two forced
fumbles and 58 quarterback pressures (third in the NFL).

Bosa's deal, while big, is still more than $200 million short of the
active "Big Four" American sports record -- an honor held by the Los
Angeles Angels' Mike Trout. Here's how the contract stacks up with
others throughout sports.

MLB

Mike Trout, Los Angeles Angels: 12 years, $426.5 million

Year signed: 2019

Trout has been either the best player in baseball or close to it for the
better part of a decade, and the Angels rewarded him accordingly. At the
time he signed this deal, it was the richest contract in professional
American sports. Though he's been hampered by injuries, he's played 423
games and won the 2019 MVP since the signing.
...

@nntrn
Copy link
Author

nntrn commented Sep 7, 2023 •
edited
Loading

I mean a teams average passing/rushing yards allowed per game over a season. Sorry for the confusion.
@Achtbaan

I found averagePointsAgainst, a close cousin to averageYardsAllowed -

{
    "name": "avgPointsAgainst",
    "displayName": "Opponent Points Per Game",
    "shortDisplayName": "OPTS/G",
    "description": "Opponent Points Per Game",
    "abbreviation": "OPTS/G",
    "type": "avgpointsagainst",
    "value": 20.117647,
    "displayValue": "20.1"
},
{
    "name": "pointsAgainst",
    "displayName": "Points Against",
    "shortDisplayName": "PA",
    "description": "Total Points Against",
    "abbreviation": "PA",
    "type": "pointsagainst",
    "value": 342,
    "displayValue": "342"
},

https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/types/2/teams/6/record

@lexcraw4d
Copy link

This is great! Does anyone have a similar one with ncaa cfb? Looking for player stats specifically... GREAT job!

@nntrn
Copy link
Author

nntrn commented Sep 15, 2023 •
edited
Loading

@lexcraw4d
Does anyone have a similar one with ncaa cfb? Looking for player stats specifically... GREAT job!

Most of the urls can be refashioned for other leagues:
Example: /sports/football/leagues/nfl/ => /sports/baseball/leagues/mlb/

For athlete stats:
https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/2988219
https://site.web.api.espn.com/apis/common/v3/sports/football/college-football/athletes/4432710/stats

--
for college football, you just need to replace nfl with college-football

@nntrn
Copy link
Author

nntrn commented Sep 15, 2023 •
edited
Loading

@lexcraw4d

Player: season stats

Player: game stats

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