Skip to content

Instantly share code, notes, and snippets.

@nntrn
Last active June 23, 2024 14:43
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.
List of nfl api endpoints from espn

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

Reference List

Get list of ids

Detailed

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",
@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

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.

@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
Copy link

Chiradanalyst commented Aug 15, 2023

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

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

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

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

@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

@alecmatt5
Copy link

Anyone know why this endpoint: [https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates={year}] doesn't return any of the Thursday NFL games? As far as I can tell it returns all the scoreboards from the year including Sunday, Monday, and Saturday games but skips all of the Thursday games.

Follow up question, anyone know another way I can get all of the game_ids from the NFL games (where the Thursday games aren't being ignored)?

@ryanbuckner
Copy link

ryanbuckner commented Sep 15, 2023 via email

@alecmatt5
Copy link

Anyone know why this endpoint: [https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?limit=1000&dates={year}] doesn't return any of the Thursday NFL games? As far as I can tell it returns all the scoreboards from the year including Sunday, Monday, and Saturday games but skips all of the Thursday games.

Follow up question, anyone know another way I can get all of the game_ids from the NFL games (where the Thursday games aren't being ignored)?

Thanks for the reply Ryan, I actually figured out the issue. It's not that the Thursday games are being skipped but rather the dates listed are in UTC time and therefore the date corresponding to the 'Thursday' games is actually Friday.

@sandyjtech
Copy link

I want to access player's ppr and standard points per game. Does anyone have any suggestions?

@TheSeahawksAri
Copy link

Can someone please tell me how to get player stats of all time? Also, do I need an API token or something to use this. I'm really confused, and would really appreciate some help

@mrmikeytj
Copy link

Is there an endpoint to get related players for each play?

In the play by play link (https://cdn.espn.com/core/nfl/playbyplay?xhr=1&gameId=401437654), you can find all the plays for each drive.
Although, in each play, it doesn't really say which players were involved. A few years ago there was another section for each player involved.
This was in the nfl gameday json site that disappeared.

One of the first plays of the linked game above, has this:
{ "sequenceNumber": "5600", "period": { "number": 1 }, "homeScore": 0, "start": { "shortDownDistanceText": "1st & 10", "possessionText": "BUF 25", "downDistanceText": "1st & 10 at BUF 25", "distance": 10, "yardLine": 75, "team": { "id": "2" }, "down": 1, "yardsToEndzone": 75 }, "scoringPlay": false, "clock": { "displayValue": "15:00" }, "type": { "id": "24", "text": "Pass Reception", "abbreviation": "REC" }, "priority": false, "statYardage": 6, "awayScore": 0, "wallclock": "2022-09-09T00:24:04Z", "modified": "2022-09-14T21:05Z", "end": { "shortDownDistanceText": "2nd & 10", "possessionText": "BUF 31", "downDistanceText": "2nd & 10 at BUF 31", "distance": 10, "yardLine": 69, "team": { "id": "2" }, "down": 2, "yardsToEndzone": 69 }, "id": "40143765456", "text": "(15:00) (Shotgun) J.Allen pass short right to S.Diggs to BUF 31 for 6 yards (J.Ramsey)." },

Although, besides the last property (text), it doesn't say who threw the pass, who caught it, where it was caught, how many yards after catch, who tackled, who assisted the tackle, etc. I was hoping it had the player id, stat type id, yardage/stat, etc.

I have noticed the play id (40143765456)
Does this link into another end point somewhere?

@mrmikeytj
Copy link

Cloests thing I've been able to find is this: http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/plays/40143765456?lang=en&region=us

It includes the stat type, and stat yardage:
"id": "40143765456", "sequenceNumber": "5600", "type": { "id": "24", "text": "Pass Reception", "abbreviation": "REC" },
... then a little farther down ...
"statYardage": 6

It also has a participants property.
It doesn't have a referenced player id as I had hoped, though it does have a player reference link:
It is confusing how it includes the athelete's game stat totals within the participants, instead of the totals for this specific play.
{ "athlete": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/2976212?lang=en&region=us" }, "position": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/1?lang=en&region=us" }, "statistics": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/competitors/2/roster/2976212/statistics/0?lang=en&region=us" }, "stats": [ { "name": "receptions", "displayName": "Receptions", "shortDisplayName": "Receptions", "description": "The total number of receptions.", "abbreviation": "REC", "value": 8, "displayValue": "8" }, { "name": "receivingYards", "displayName": "Receiving Yards", "shortDisplayName": "Rec. Yards", "description": "The total receiving yards.", "abbreviation": "YDS", "value": 122, "displayValue": "122" }, { "name": "receivingTouchdowns", "displayName": "Receiving Touchdowns", "shortDisplayName": "Receiving Touchdowns", "description": "The total number of receiving touchdowns.", "abbreviation": "TD", "value": 1, "displayValue": "1" } ], "order": 2, "type": "receiver" },

The player reference link has the player details:
"id": "2976212", "uid": "s:20~l:28~a:2976212", "guid": "d6ba7023-458c-f59a-4af2-638770067518", "type": "football", "alternateIds": { "sdr": "2976212" }, "firstName": "Stefon", "lastName": "Diggs",

@mrmikeytj
Copy link

So I'm left with these questions:

Why is the result of this play (6 yard pass reception) say this:
"downDistanceText": "2nd & 10 at BUF 31"

Anywhere I can find stat types like air yards? To know how far the ball traveled on an incomplete or completed pass?
Anywhere I can find stat types for offensive and defensive linemen? missed tackles? yards after catch?

@nntrn
Copy link
Author

nntrn commented Sep 28, 2023

@mrmikeytj
Copy link

@nntrn yeah that seems to have a similar layout as this link
http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/plays/40143765456?lang=en&region=us

{ "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/plays/40143765456?lang=en&region=us", "id": "40143765456", "sequenceNumber": "5600", "type": { "id": "24", "text": "Pass Reception", "abbreviation": "REC" }, "text": "(15:00) (Shotgun) J.Allen pass short right to S.Diggs to BUF 31 for 6 yards (J.Ramsey).", "shortText": "Josh Allen Pass Complete for 6 Yds to Stefon Diggs", "alternativeText": "(15:00) (Shotgun) J.Allen pass short right to S.Diggs to BUF 31 for 6 yards (J.Ramsey).", "shortAlternativeText": "Josh Allen Pass Complete for 6 Yds to Stefon Diggs", "awayScore": 0, "homeScore": 0, "period": { "number": 1 }, "clock": { "value": 900, "displayValue": "15:00" }, "scoringPlay": false, "priority": false, "scoreValue": 0, "modified": "2022-09-14T21:05Z", "team": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/teams/2?lang=en&region=us" }, "participants": [ { "athlete": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/3918298?lang=en&region=us" }, "position": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/8?lang=en&region=us" }, "statistics": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/competitors/2/roster/3918298/statistics/0?lang=en&region=us" }, "stats": [ { "name": "completions/attempts", "displayName": "Completions / Attempts", "shortDisplayName": "COMP/ATT", "description": "The number of passing completions and attempts.", "abbreviation": "COMP/ATT", "value": 0.8387096774, "displayValue": "26/31" }, { "name": "passingYards", "displayName": "Passing Yards", "shortDisplayName": "Pass Yards", "description": "The total passing yards.", "abbreviation": "YDS", "value": 297, "displayValue": "297" }, { "name": "passingTouchdowns", "displayName": "Passing Touchdowns", "shortDisplayName": "Touchdowns", "description": "The total number of passing touchdowns.", "abbreviation": "TD", "value": 3, "displayValue": "3" }, { "name": "interceptions", "displayName": "Interceptions", "shortDisplayName": "INT", "description": "The number of passes thrown that were intercepted by the opposing team.", "abbreviation": "INT", "value": 2, "displayValue": "2" } ], "order": 1, "type": "passer" }, { "athlete": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/2976212?lang=en&region=us" }, "position": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/1?lang=en&region=us" }, "statistics": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/competitors/2/roster/2976212/statistics/0?lang=en&region=us" }, "stats": [ { "name": "receptions", "displayName": "Receptions", "shortDisplayName": "Receptions", "description": "The total number of receptions.", "abbreviation": "REC", "value": 8, "displayValue": "8" }, { "name": "receivingYards", "displayName": "Receiving Yards", "shortDisplayName": "Rec. Yards", "description": "The total receiving yards.", "abbreviation": "YDS", "value": 122, "displayValue": "122" }, { "name": "receivingTouchdowns", "displayName": "Receiving Touchdowns", "shortDisplayName": "Receiving Touchdowns", "description": "The total number of receiving touchdowns.", "abbreviation": "TD", "value": 1, "displayValue": "1" } ], "order": 2, "type": "receiver" }, { "athlete": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/athletes/3045373?lang=en&region=us" }, "position": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/29?lang=en&region=us" }, "statistics": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/competitors/15/roster/3045373/statistics/0?lang=en&region=us" }, "stats": [ { "name": "totalTackles", "displayName": "Total Tackles", "shortDisplayName": "Tackles", "description": "The total number of tackles.", "abbreviation": "TOT", "value": 6, "displayValue": "6" }, { "name": "sacks", "displayName": "Sacks", "shortDisplayName": "Sacks", "description": "The total number of sacks.", "abbreviation": "SACK", "value": 0, "displayValue": "0" }, { "name": "interceptions", "displayName": "Interceptions", "shortDisplayName": "INT", "description": "The number of passes thrown that were intercepted by the opposing team.", "abbreviation": "INT", "value": 0, "displayValue": "0" } ], "order": 3, "type": "tackler" } ], "probability": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/probabilities/40143765456?lang=en&region=us" }, "wallclock": "2022-09-09T00:24:04Z", "drive": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401437654/competitions/401437654/drives/4014376541?lang=en&region=us" }, "start": { "down": 1, "distance": 10, "yardLine": 75, "yardsToEndzone": 75, "downDistanceText": "1st & 10 at BUF 25", "shortDownDistanceText": "1st & 10", "possessionText": "BUF 25", "team": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/teams/2?lang=en&region=us" } }, "end": { "down": 2, "distance": 10, "yardLine": 69, "yardsToEndzone": 69, "downDistanceText": "2nd & 10 at BUF 31", "shortDownDistanceText": "2nd & 10", "possessionText": "BUF 31", "team": { "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2022/teams/2?lang=en&region=us" } }, "statYardage": 6 },

@mrmikeytj
Copy link

And thanks for putting this together, its super helpful!

@psuTickleMonster
Copy link

psuTickleMonster commented Oct 15, 2023

@krax13
Copy link

krax13 commented Oct 19, 2023

Hi all,
I want to make a Grafana dashboard to present our ESPN Pigskin Pick'em scoreboard.
Is there available API path to show the picks of the group?
Thank you in advance!

@nntrn
Copy link
Author

nntrn commented Oct 20, 2023

Hi all, I want to make a Grafana dashboard to present our ESPN Pigskin Pick'em scoreboard. Is there available API path to show the picks of the group? Thank you in advance!

@krax13 - heres the pickem api

# challenge_name
# --------------
# CHALLENGE_NAME=nfl-win-totals-2023
# CHALLENGE_NAME=nfl-eliminator-challenge-2023
CHALLENGE_NAME=nfl-pigskin-pickem-2023

# view_name:
# ---------------------------
# VIEW_NAME=allon
# VIEW_NAME=chui_default
# VIEW_NAME=chui_default_group
# VIEW_NAME=chui_default_groupParticipationHistory
# VIEW_NAME=chui_default_metadata
# VIEW_NAME=chui_pagetype_group_picks
VIEW_NAME=pagetype_leaderboard

# group_ids
# -------------------------
# EXAMPLE_GROUP_ID_WINTOTAL=3ea0845b-59d5-499b-97a0-2eb9d02e1cc9
# EXAMPLE_GROUP_ID_ELIMINATOR=ac72d269-e700-4efb-bcb1-269413d1a815
EXAMPLE_GROUP_ID_PIGSKIN=19961d87-2563-4972-bdd3-de7e55ee26be

################################################################################

GROUP_ID=$EXAMPLE_GROUP_ID_PIGSKIN

API_PATH="apis/v1/challenges/${CHALLENGE_NAME}/groups/${GROUP_ID}?view=${VIEW_NAME}&platform=chui"

API_HEADER='gambit-filter: {"filterSortId":{"value":null},"limit":100,"offset":0,"sortRank":{"sortAsc":true,"sortPriority":1}}'

curl "https://gambit-api.fantasy.espn.com/${API_PATH}" -H "$API_HEADER"

Examples:

@krax13
Copy link

krax13 commented Oct 20, 2023

Hi all, I want to make a Grafana dashboard to present our ESPN Pigskin Pick'em scoreboard. Is there available API path to show the picks of the group? Thank you in advance!

@krax13 - heres the pickem api

# challenge_name
# --------------
# CHALLENGE_NAME=nfl-win-totals-2023
# CHALLENGE_NAME=nfl-eliminator-challenge-2023
CHALLENGE_NAME=nfl-pigskin-pickem-2023

# view_name:
# ---------------------------
# VIEW_NAME=allon
# VIEW_NAME=chui_default
# VIEW_NAME=chui_default_group
# VIEW_NAME=chui_default_groupParticipationHistory
# VIEW_NAME=chui_default_metadata
# VIEW_NAME=chui_pagetype_group_picks
VIEW_NAME=pagetype_leaderboard

# group_ids
# -------------------------
# EXAMPLE_GROUP_ID_WINTOTAL=3ea0845b-59d5-499b-97a0-2eb9d02e1cc9
# EXAMPLE_GROUP_ID_ELIMINATOR=ac72d269-e700-4efb-bcb1-269413d1a815
EXAMPLE_GROUP_ID_PIGSKIN=19961d87-2563-4972-bdd3-de7e55ee26be

################################################################################

GROUP_ID=$EXAMPLE_GROUP_ID_PIGSKIN

API_PATH="apis/v1/challenges/${CHALLENGE_NAME}/groups/${GROUP_ID}?view=${VIEW_NAME}&platform=chui"

API_HEADER='gambit-filter: {"filterSortId":{"value":null},"limit":100,"offset":0,"sortRank":{"sortAsc":true,"sortPriority":1}}'

curl "https://gambit-api.fantasy.espn.com/${API_PATH}" -H "$API_HEADER"

Examples:

* [/apis/v1/challenges/**nfl-win-totals-2023**/groups/3ea0845b-59d5-499b-97a0-2eb9d02e1cc9?view=**allon**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-win-totals-2023/groups/3ea0845b-59d5-499b-97a0-2eb9d02e1cc9?view=allon&platform=chui)

* [/apis/v1/challenges/**nfl-eliminator-challenge-2023**/groups/ac72d269-e700-4efb-bcb1-269413d1a815?view=**chui_default_group**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-eliminator-challenge-2023/groups/ac72d269-e700-4efb-bcb1-269413d1a815?view=chui_default_group&platform=chui)

* [/apis/v1/challenges/**nfl-pigskin-pickem-2023**/groups/19961d87-2563-4972-bdd3-de7e55ee26be?view=**pagetype_leaderboard**](https://gambit-api.fantasy.espn.com/apis/v1/challenges/nfl-pigskin-pickem-2023/groups/19961d87-2563-4972-bdd3-de7e55ee26be?view=pagetype_leaderboard)

Many thanks @nntrn That is what I am looking for. :)

@ZacharySal
Copy link

Is there any way to get the season leaders for a team without fetching one of their games? I know there is a link listed, but it takes an extra api call for each player to get the data. Is there a more concise call? Thank you for all of this information by the way!

@nntrn
Copy link
Author

nntrn commented Oct 31, 2023

Is there any way to get the season leaders for a team without fetching one of their games? I know there is a link listed, but it takes an extra api call for each player to get the data. Is there a more concise call? Thank you for all of this information by the way!

@ZacharySal - maybe these?

@psuTickleMonster
Copy link

@nntrn - Anybody get results for the Rankings Endpoint? https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/types/2/weeks/6/rankings

Anyone? Has anyone found a way to get rankings besides the efficiency ranks? Eff Rank and standard off/def rank seem to be different.

@jalikens
Copy link

jalikens commented Nov 28, 2023

@nntrn Does anyone know how to get the season leaders for TEAM stats? for example stats from here https://www.espn.com/nfl/stats/_/view/team

Is there something similar to this endpoint: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2023/types/2/leaders

@nntrn
Copy link
Author

nntrn commented Dec 1, 2023

@lewishardie
Copy link

This might be a noob question, I'm fairly new to programming, but I'm trying to setup a search function to pull player profile information (i.e name, headshot, age, number, team), the only issue being that for the search to work as I've set it up I can't just search "Ryan Tannehill" and get that information, I need to search using their player id, which isn't intuitive for users.

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

Is it a situation where I'm better of having a local file that has all the key: value pairings e.g. { "Ryan Tannehill" : 14876 } or is there a better way to do this?

@ryanbuckner
Copy link

ryanbuckner commented Dec 15, 2023 via email

@terrencewhaley
Copy link

@lewishardie Hey Lewis, were you able to solve? I'm wondering the same.

@nntrn
Copy link
Author

nntrn commented Dec 26, 2023

Is it a situation where I'm better of having a local file that has all the key: value pairings e.g. { "Ryan Tannehill" : 14876 } or is there a better way to do this?

you can run this script to build a local roster
https://github.com/nntrn/espn-wiki/blob/main/scripts/roster.sh

$ curl -O https://github.com/nntrn/espn-wiki/blob/main/scripts/roster.sh
$ chmod a+x roster.sh
$ ./roster.sh /tmp/nfl-roster

Results:

[
  {
    "id": "4259305",
    "team": "GB",
    "position": "WR",
    "fullName": "Bo Melton"
  },
  {
    "id": "4685016",
    "team": "GB",
    "position": "RB",
    "fullName": "Ellis Merriweather"
  }
  ...
]

@lewishardie @eye4eneye

@terrencewhaley
Copy link

@nntrn Thank you so much for this script!

@mattabets
Copy link

This might be a noob question, I'm fairly new to programming, but I'm trying to setup a search function to pull player profile information (i.e name, headshot, age, number, team), the only issue being that for the search to work as I've set it up I can't just search "Ryan Tannehill" and get that information, I need to search using their player id, which isn't intuitive for users.

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

Is it a situation where I'm better of having a local file that has all the key: value pairings e.g. { "Ryan Tannehill" : 14876 } or is there a better way to do this?

alternatively, I just used @nntrn 's script to build a python function to reverse lookup the player id by their name. You can find the documentation here: https://github.com/mattabets/espn_api_player_id_reverse_lookup/blob/main/README.md

@newadventure079
Copy link

There's another endpoint for the pickem challenges that I've used
https://fantasy.espn.com/apis/v1/challenges/'+game_type+'-'+year+'/members/
In 2023, it didn't require auth.

In 2024, it has changed to the below and now requires auth
https://gambit-api.fantasy.espn.com/apis/v1/challenges/'+game_type+'-'+year+'/members/

@newadventure079
Copy link

Does anyone know of a way to tell if a user has submitted their picks for the week in the pickem challenges?

You used to be able to click on their name and it'd tell you if they have submitted their picks or not but I believe during the site redesign a few years ago, espn removed that feature.

@JamesSingleton
Copy link

Has anyone figured out how to get College Football weeks? https://site.api.espn.com/apis/common/v3/sports/football/college-football/seasons gives all seasons from 1872 to 2024 which I only need a single season. I tried adding ?season=2024, ?year=2024 with no luck. You can do https://site.api.espn.com/apis/common/v3/sports/football/college-football/seasons/2024 to get the 2024 season, but it doesn't give the weeks, even doing ?seasonType=2 doesn't.

@newadventure079
Copy link

Using the first url, after you get the data, you should be able to reference what you want to get by doing something like
const season2024 = data.seasons.find(season => season.year === 2024);

@JamesSingleton
Copy link

@newadventure079 yea that is true I could do that... But I was trying to avoid having to get a massive payload (I guess not that massive as it's 8.3 kB). I do find it interesting that /seasons will give the breakdown of the weeks, but /seasons/2024 won't

@newadventure079
Copy link

The API is a big black box lol

@JamesSingleton
Copy link

@newadventure079 yea... I am building a College Football Top 25 voting system for my website and I don't want to have to hardcode the weeks into my API routes, so that is why I was looking at using the API endpoint. I also noticed for ESPN, they classify Week 1 as 8/24-9/3 but that includes Week 0 and Week 1, I found that interesting.

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