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 Dec 20, 2022

add active=true to cut down the amount of atheltes

https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000&active=true&page=1

@DarPerry @SlaterJoseph

@Tryden12
Copy link

Anyone know how to get a team's schedule by teamId for regular season? The example below doesn't contain any events (games) because we are now in the offseason for some teams.

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

@nntrn
Copy link
Author

nntrn commented Jan 19, 2023

@Tryden12:

Anyone know how to get a team's schedule by teamId for regular season? The example below doesn't contain any events (games) because we are now in the offseason for some teams.

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

Change 2020 to the year you want
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/teams/2/events?lang=en&region=us

@Tryden12
Copy link

Tryden12 commented Jan 19, 2023 •
edited
Loading

@nntrn

Thanks for the reply! I'm trying to make a screen displaying the entire season of schedule data for one team at a time. The Json returned from url you suggested would be tricky in doing so.

Change 2020 to the year you want https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2020/teams/2/events?lang=en&region=us

I've decided to just loop through the returned data for a given range of dates from this url:
https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?dates=20220908-20230108

@cfinnegan12
Copy link

I'm trying to get a list of call the colleges, but the endpoint http://sports.core.api.espn.com/v2/colleges?lang=en&region=us seems to be returning a 500 error:
{ "error": { "message": "application error", "code": 500 } }
Has this always been broken or is this temporary? And if it is broken is there any other way to get a full list of colleges?

@Tryden12
Copy link

I'm trying to get a list of call the colleges, but the endpoint http://sports.core.api.espn.com/v2/colleges?lang=en&region=us seems to be returning a 500 error: { "error": { "message": "application error", "code": 500 } } Has this always been broken or is this temporary? And if it is broken is there any other way to get a full list of colleges?

Seems as though v2 is deprecated. v3 works:

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

@nntrn
Copy link
Author

nntrn commented Jan 26, 2023

@Tryden12 ty!!

@Tryden12
Copy link

Tryden12 commented Jan 27, 2023 •
edited
Loading

I can't find anything on how to sort news by a team or athlete. Anyone know how, or if possible?

SOLUTION:
Use team parameter with team_id. Example below sorts by the Titans (team_id = 10)

https://site.api.espn.com/apis/site/v2/sports/football/nfl/news?team=10

@dylant135
Copy link

how to get the top few leaders of each catagory by season?

@nntrn
Copy link
Author

nntrn commented Feb 28, 2023

@dylant135
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2016/types/2/leaders

Replace 2016 with the year you want

@michel-wue
Copy link

is it possible to get the FPI before a game, like defence and a offence rating for each team?

@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

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