Skip to content

Instantly share code, notes, and snippets.

@nntrn

nntrn/espn-api-list.md

Last active April 3, 2025 21:41
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. nba, nhl, mlb)
  • August 2021 - get historical fantasy league data
  • September 2021 - list of endpoints in plain text
  • May 2023 - collapsed endpoint response examples
  • Mar 2025 - endpoints from partners.api.espn.com *NEW*

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

[TOC]

News

Detailed

Get live updates (xhr=1)

Odds

[TOC]

Teams

[TOC]

Games

[TOC]

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

[TOC]

Curl Fantasy Filters

Fantasy Stats

  • Position

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

  • Player stats
    View

[TOC]

REST API Response Examples

Athlete endpoints
 eventlog, gamelog, projections.. etc

ATHLETE PROFILE API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/athletes?limit=1000

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

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": {
    "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"},
    {"name": "rushing","displayName": "Rushing"}
  ],

[TOP]

ATHLETE NOTES API

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

{
  "items": [
    {"id": "498444",
      "type": "news",
      "date": "2021-12-17T20:14Z",
      "headline": "Stafford and the Rams aren't in line to play the Seahawks on Sunday, with the NFL expected to reschedule the game for Tuesday at 7 p.m. ET, pending official confirmation, Adam Schefter of ESPN reports.",
      "text": "Due to ongoing COVID-19-related issues within the Rams organization, the NFL is hopeful that by delaying the game two days, Los Angeles will be able to restore enough players from the reserve/COVID-19 list to alleviate depth concerns on the roster. After Tuesday's game, the Rams will face a quick turnaround for Week 16 with a Sunday game in Minnesota on Dec. 26.",
      "source": "RotoWire"}
  ]
}

ATHLETE PROJECTIONS 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": [

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

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

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"}
Calendar endpoints
 Blacklist dates, whitelist dates, events

CALENDAR API

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

{
  "items": [
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/ondays"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/offdays"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/whitelist"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/calendar/blacklist"}
  ]
}

CALENDAR BLACKLIST 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",

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]

EVENTS API

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

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

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"

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,
Season endpoints
 Game weeks, Season types, weekly events, weekly picks

SEASONS API

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

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

SEASON ATHLETES API

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

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

SEASON COACHES API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches?limit=50

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

[TOP]

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

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"

SEASON FUTURES API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/futures

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

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

SEASON TYPES API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types

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

SEASONTYPE GROUPS API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups

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

[TOP]

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

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

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

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"
      ]}
  },

[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",
  "items": [
    {"athlete": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/2330"},
      "team": {
        "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/27"},
      "event": {

WEEKLY TALENTPICKS API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/weeks/6/talentpicks

{
  "items": [
    {"pick": {
        "person": {
          "id": "1768",
          "firstName": "Damien",
          "lastName": "Woody",
          "displayName": "Damien Woody",
          "headshot": {
            "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png",
Betting endpoints
 Betting, odds, draft

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

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

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

[TOP]

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

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",
  "items": [
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/plays/4012201811",
      "id": "4012201811",
      "sequenceNumber": "100",
      "type": {
        "id": "70",
        "text": "Coin Toss"},

COMPETITION PROBABILITIES 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,

[TOP]

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events/401220181/competitions/401220181/probabilities?limit=200

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

ODD PREDICTORS API

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

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

DRAFT ATHLETES API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/draft/athletes?limit=500

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

{
  "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"
  }
}
Metainfo endpoints
 Franchise, news, venues

FRANCHISES API

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

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

GROUP STANDINGS API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/standings

{
  "items": [
    {"id": "0",
      "name": "overall",
      "displayName": "Overall Standings",
      "links": [
        {"language": "en-US",
          "rel": [

GROUP TEAMS API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/types/2/groups/1/teams

{
  "items": [
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/6"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/19"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/21"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/28"}
  ]
}

LEADERS 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,

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

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

{
  "items": [
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/0"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/1"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/positions/2"},

PROVIDERS API

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

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

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]

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

TALENTPICKS API

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

{
  "items": [
    {"pick": {
        "person": {
          "id": "1768",
          "firstName": "Damien",
          "lastName": "Woody",
          "displayName": "Damien Woody",
          "headshot": {
            "href": "https://a.espncdn.com/i/columnists/full/woody_damien.png",
Team endpoints
 Depthcharts, injuries, coaches, roster, odds records

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

TEAM ATHLETES API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/athletes

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

{
  "items": [
    {"wins": 6,
      "losses": 8,
      "pushes": 0,
      "type": {
        "id": "0",
        "name": "atsOverall",
        "description": "Overall team season record against the spread"}

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

TEAM COACHES API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/coaches/17553

  "firstName": "Andy",
  "lastName": "Reid",
  "dateOfBirth": "1958-03-19T08:00Z",
  "birthPlace": {
    "city": "Los Angeles",
    "state": "California",
    "country": "USA"
  },
  "college": {
    "$ref": "http://sports.core.api.espn.com/v2/colleges/39?lang=en&region=us"
  },
  "headshot": {
    "href": "https://a.espncdn.com/i/headshots/nfl/coaches/65/17553.jpg",
    "alt": "Andy Reid"
  },
  "person": {
    "$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/coaches/17553?lang=en&region=us"

TEAM DEPTHCHARTS API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/depthcharts

{
  "items": [
    {"id": "15",
      "name": "Base 3-4 D",
      "positions": {
        "lde": {
          "position": {
            "id": "11",
            "name": "Left Defensive End",

TEAM EVENTS API

URL: https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/teams/12/events

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

{
  "items": [
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/4408854/injuries/-1252999"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3048898/injuries/499227"},
    {"$ref": "http://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2021/athletes/3055899/injuries/499204"},

TEAM LEADERS 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

{
  "items": [
    {"abbreviation": "ML",
      "displayName": "Money Line Overall Record",
      "shortDisplayName": "Money Line",
      "type": "moneyLineOverall",
      "stats": [
        {"displayName": "Wins",
          "abbreviation": "W",

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

{
  "items": [
    {"id": "0",
      "name": "All Splits",
      "abbreviation": "Any",
      "type": "total",
      "summary": "10-4",
      "displayValue": "10-4",
      "value": 0.7142857142857143,

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}

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

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]

Raw
new.md

Athletes:

https://partners.api.espn.com/v2/sports/football/nfl/athletes?limit=7000

https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?page=1&limit=20000

Events

https://partners.api.espn.com/v2/sports/football/nfl/events?limit=1000
&dates=20230101-20240101 or &dates=20230101 or &dates=2023

Fantasy

https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/{{YEAR}}/players?view={{VIEW_NAME}}

# To get more than 50 items, run in terminal:
curl -H 'X-Fantasy-Filter: {"games":{"limit":2000}}' <URL>

Views (that I know of):

Stat column names

id   displayid  abbrev    description
---  ---------  --------  --------------------------------
0    7          PA        Each Pass Attempted
1    8          PC        Each Pass Completed
2    11         INC       Each Incomplete Pass
3    0          PY        Passing Yards
4    14         PTD       TD Pass
5    1          PY5       Every 5 passing yards
6    2          PY10      Every 10 passing yards
View more 
id   displayid  abbrev    description
---  ---------  --------  --------------------------------
0    7          PA        Each Pass Attempted
1    8          PC        Each Pass Completed
2    11         INC       Each Incomplete Pass
3    0          PY        Passing Yards
4    14         PTD       TD Pass
5    1          PY5       Every 5 passing yards
6    2          PY10      Every 10 passing yards
7    3          PY20      Every 20 passing yards 
8    4          PY25      Every 25 passing yards 
9    5          PY50      Every 50 passing yards
10   6          PY100     Every 100 passing yards
11   9          PC5       Every 5 pass completions
12   10         PC10      Every 10 pass completions
13   12         IP5       Every 5 pass incompletions
14   13         IP10      Every 10 pass incompletions
15   15         PTD40     40+ yard TD pass bonus
16   16         PTD50     50+ yard TD pass bonus
17   20         P300      300-399 yard passing game
18   21         P400      400+ yard passing game
19   19         2PC       2pt Passing Conversion
20   18         INTT      Interceptions Thrown
21   155        CPCT      Passing Completion Pct
22   156        PYPG      Passing Yards Per Game
23   30         RA        Rushing Attempts
24   23         RY        Rushing Yards
25   33         RTD       TD Rush
26   37         2PR       2pt Rushing Conversion
27   24         RY5       Every 5 rushing yards
28   25         RY10      Every 10 rushing yards
29   26         RY20      Every 20 rushing yards
30   27         RY25      Every 25 rushing yards 
31   28         RY50      Every 50 rushing yards
32   29         R100      Every 100 rushing yards
33   31         RA5       Every 5 rush attempts
34   32         RA10      Every 10 rush attempts
35   34         RTD40     40+ yard TD rush bonus
36   35         RTD50     50+ yard TD rush bonus
37   38         RY100     100-199 yard rushing game
38   39         RY200     200+ yard rushing game
39   157        RYPA      Rushing Yards Per Attempt
40   158        RYPG      Rushing Yards Per Game
41   159        RECS      Receptions
42   40         REY       Receiving Yards
43   50         RETD      TD Reception
44   54         2PRE      2pt Receiving Conversion
45   51         RETD40    40+ yard TD rec bonus
46   52         RETD50    50+ yard TD rec bonus
47   41         REY5      Every 5 receiving yards
48   42         REY10     Every 10 receiving yards
49   43         REY20     Every 20 receiving yards
50   44         REY25     Every 25 receiving yards
51   45         REY50     Every 50 receiving yards
52   46         RE100     Every 100 receiving yards
53   47         REC       Each reception
54   48         REC5      Every 5 receptions
55   49         REC10     Every 10 receptions
56   55         REY100    100-199 yard receiving game
57   56         REY200    200+ yard receiving game
58   57         RET       Receiving Target
59   160        YAC       Receiving Yards After Catch
60   161        YPC       Receiving Yards Per Catch
61   162        REYPG     Receiving Yards Per Game
62   163        PTL       Total 2pt Conversions
63   66         FTD       Fumble Recovered for TD
64   22         SKD       Sacked
65   164        PFUM      Passing Fumbles
66   165        RFUM      Rushing Fumbles
67   166        REFUM     Receiving Fumbles
68   67         FUM       Total Fumbles
69   167        PFUML     Passing Fumbles Lost
70   168        RFUML     Rushing Fumbles Lost
71   169        REFUML    Receiving Fumbles Lost
72   68         FUML      Total Fumbles Lost
73   170        TT        Total Turnovers
74   84         FG50P     FG Made (50+ yards)
75   171        FGA50P    FG Attempted (50+ yards)
76   172        FGM50P    FG Missed (50+ yards)
77   83         FG40      FG Made (40-49 yards)
78   86         FGA40     FG Attempted (40-49 yards)
79   89         FGM40     FG Missed (40-49 yards)
80   82         FG0       FG Made (0-39 yards)
81   85         FGA0      FG Attempted (0-39 yards)
82   88         FGM0      FG Missed (0-39 yards)
83   79         FG        Total FG Made
84   80         FGA       Total FG Attempted
85   81         FGM       Total FG Missed
86   76         PAT       Each PAT Made
87   77         PATA      Each PAT Attempted
88   78         PATM      Each PAT Missed
89   136        PA0       0 points allowed
90   137        PA1       1-6 points allowed
91   138        PA7       7-13 points allowed
92   139        PA14      14-17 points allowed
93   73         BLKKRTD   Blocked Punt or FG return for TD
94   173        DEFRETTD  Fumble or INT Return for TD
95   113        INT       Each Interception
96   114        FR        Each Fumble Recovered
97   112        BLKK      Blocked Punt, PAT or FG
98   116        SF        Each Safety
99   107        SK        Each Sack
100  108        HALFSK    1/2 Sack
101  64         KRTD      Kickoff Return TD
102  65         PRTD      Punt Return TD
103  71         INTTD     Interception Return TD
104  72         FRTD      Fumble Return TD
105  174        TRTD      Total Return TD
106  115        FF        Each Fumble Forced
107  117        TKA       Assisted Tackles
108  118        TKS       Solo Tackles
109  109        TK        Total Tackles
110  110        TK3       Every 3 Total Tackles
111  111        TK5       Every 5 Total Tackles
112  119        STF       Stuffs
113  120        PD        Passes Defensed
114  58         KR        Kickoff Return Yards
115  61         PR        Punt Return Yards
116  59         KR10      Every 10 kickoff return yards
117  60         KR25      Every 25 kickoff return yards
118  62         PR10      Every 10 punt return yards
119  63         PR25      Every 25 punt return yards
120  135        PTSA      Points Allowed
121  140        PA18      18-21 points allowed
122  141        PA22      22-27 points allowed
123  142        PA28      28-34 points allowed
124  143        PA35      35-45 points allowed
125  144        PA46      46+ points allowed
126  175        PAPG      Points Allowed Per Game
127  145        YA        Yards Allowed
128  146        YA100     Less than 100 total yards allowed
129  147        YA199     100-199 total yards allowed
130  148        YA299     200-299 total yards allowed
131  149        YA349     300-349 total yards allowed
132  150        YA399     350-399 total yards allowed
133  151        YA449     400-449 total yards allowed
134  152        YA499     450-499 total yards allowed
135  153        YA549     500-549 total yards allowed
136  154        YA550     550+ total yards allowed
137  176        YAPG      Yards Allowed Per Game
138  91         PT        Net Punts
139  92         PTY       Punt Yards
140  93         PT10      Punts Inside the 10
141  94         PT20      Punts Inside the 20
142  95         PTB       Blocked Punts
143  96         PTR       Punts Returned
144  97         PTRY      Punt Return Yards
145  98         PTTB      Touchbacks
146  99         PTFC      Fair Catches
147  177        PTAVG     Punt Average
148  100        PTA44     Punt Average 44.0+
149  101        PTA42     Punt Average 42.0-43.9
150  102        PTA40     Punt Average 40.0-41.9
151  103        PTA38     Punt Average 38.0-39.9
152  104        PTA36     Punt Average 36.0-37.9
153  105        PTA34     Punt Average 34.0-35.9
154  106        PTA33     Punt Average 33.9 or less
155  69         TW        Team Win
156  70         TL        Team Loss
157  121        TIE       Team Tie
158  122        PTS       Points Scored
159  178        PPG       Points Scored Per Game
160  179        MGN       Margin of Victory
161  123        WM25      25+ point Win Margin
162  124        WM20      20-24 point Win Margin
163  125        WM15      15-19 point Win Margin
164  126        WM10      10-14 point Win Margin
165  127        WM5       5-9 point Win Margin
166  128        WM1       1-4 point Win Margin
167  129        LM1       1-4 point Loss Margin
168  130        LM5       5-9 point Loss Margin
169  131        LM10      10-14 point Loss Margin
170  132        LM15      15-19 point Loss Margin
171  133        LM20      20-24 point Loss Margin
172  134        LM25      25+ point Loss Margin
173  180        MGNPG     Margin of Victory Per Game
174  181        WINPCT    Winning Pct
175  182        PTD0      0-9 yd TD pass bonus
176  183        PTD10     10-19 yd TD pass bonus
177  184        PTD20     20-29 yd TD pass bonus
178  185        PTD30     30-39 yd TD pass bonus
179  186        RTD0      0-9 yd TD rush bonus
180  187        RTD10     10-19 yd TD rush bonus
181  188        RTD20     20-29 yd TD rush bonus
182  189        RTD30     30-39 yd TD rush bonus
183  190        RETD0     0-9 yd TD rec bonus
184  191        RETD10    10-19 yd TD rec bonus
185  192        RETD20    20-29 yd TD rec bonus
186  193        RETD30    30-39 yd TD rec bonus
187  194        DPTSA     D/ST Points Allowed
188  195        DPA0      D/ST 0 points allowed
189  196        DPA1      D/ST 1-6 points allowed
190  197        DPA7      D/ST 7-13 points allowed
191  198        DPA14     D/ST 14-17 points allowed
192  199        DPA18     D/ST 18-21 points allowed
193  200        DPA22     D/ST 22-27 points allowed
194  201        DPA28     D/ST 28-34 points allowed
195  202        DPA35     D/ST 35-45 points allowed
196  203        DPA46     D/ST 46+ points allowed
197  204        DPAPG     D/ST Points Allowed Per Game
198  205        FG50      FG Made (50-59 yards)
199  87         FGA50     FG Attempted (50-59 yards)
200  90         FGM50     FG Missed (50-59 yards)
201  206        FG60      FG Made (60+ yards)
202  207        FGA60     FG Attempted (60+ yards)
203  208        FGM60     FG Missed (60+ yards)
204  209        O2PRET    Offensive 2pt Return
205  210        D2PRET    Defensive 2pt Return
206  74         2PRET     2pt Return
207  211        O1PSF     Offensive 1pt Safety
208  212        D1PSF     Defensive 1pt Safety
209  75         1PSF      1pt Safety
210  213        GP        Games Played
211  17         PFD       Passing First Down
212  36         RFD       Rushing First Down
213  53         REFD      Receiving First Down
214  214        FGY       FG Made Yards
215  215        FGMY      FG Missed Yards
216  216        FGAY      FG Attempt Yards
217  217        FGY5      Every 5 FG Made yards
218  218        FGY10     Every 10 FG Made yards
219  219        FGY20     Every 20 FG Made yards
220  220        FGY25     Every 25 FG Made yards
221  221        FGY50     Every 50 FG Made yards
222  222        FGY100    Every 100 FG Made yards
223  223        FGMY5     Every 5 FG Missed yards
224  224        FGMY10    Every 10 FG Missed yards
225  225        FGMY20    Every 20 FG Missed yards
226  226        FGMY25    Every 25 FG Missed yards
227  227        FGMY50    Every 50 FG Missed yards
228  228        FGMY100   Every 100 FG Missed yards
229  229        FGAY5     Every 5 FG Attempt yards
230  230        FGAY10    Every 10 FG Attempt yards
231  231        FGAY20    Every 20 FG Attempt yards
232  232        FGAY25    Every 25 FG Attempt yards
233  233        FGAY50    Every 50 FG Attempt yards
234  234        FGAY100   Every 100 FG Attempt yards
@nntrn
Copy link
Author

nntrn commented Sep 22, 2024

@JimNayzium - I found it!!!!! Search player news using playerId and map it back to plays

https://site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=2977187

$ curl -s -o data.json 'https://site.api.espn.com/apis/fantasy/v2/games/ffl/news/players?limit=50&playerId=2977187'
$ jq -r '.feed[]|select(.type == "Rotowire")|[.published,.headline]|join(": ")' data.json

2024-09-20: Kupp (ankle) has been ruled out for Sunday's game against San Francisco, Gary Klein of the Los Angeles Times reports.
2024-09-18: Head coach Sean McVay said Wednesday that the Rams aren't sure whether Kupp (ankle) will be placed on injured reserve, Jourdan Rodrigue of The Athletic reports.
2024-09-16: Rams head coach Sean McVay said Monday that Kupp (ankle) is expected to be out for "an extended period of time" and could land on injured reserve, Adam Schefter of ESPN reports.
2024-09-15: Kupp was spotted leaving the Rams' locker room with his left ankle in a walking boot after Sunday's 41-10 loss to the Cardinals, Jourdan Rodrigue of The Athletic reports.
2024-09-15: Kupp suffered an ankle injury during Sunday's game at Arizona.
2024-09-11: Kupp is expected to take on greater volume in the Los Angeles passing attack for at least the next four games after the Rams placed Puka Nacua (knee) on injured reserve Wednesday, Stu Jackson of the team's official site reports.
2024-09-09: Kupp hauled in 14 of his game-high 21 targets for 110 yards and a touchdown in Sunday's 26-20 overtime loss to the Lions. He added two carries for 10 yards.
2024-08-24: Kupp (coach's decision) was held out of all the Rams' preseason contests this season.
2024-08-16: The Rams plan to rest Kupp and other key players for Saturday's preseason game against the Chargers, Cameron DaSilva of USA Today reports.
2024-06-06: Coach Sean McVay suggested Tuesday that Kupp was never truly healthy last season but is now back at full strength, Cameron DaSilva of Rams Wire reports.
2024-01-15: Kupp caught five of nine targets for 27 yards in Sunday's 24-23 wild-card round loss to the Lions.
2024-01-07: Kupp (coach's decision) is inactive for Sunday's game against the 49ers, Jourdan Rodrigue of The Athletic reports.
2024-01-03: Head coach Sean McVay said Kupp won't play Sunday at San Francisco, Greg Beacham of the Associated Press reports.
2023-12-31: Kupp caught four of six targets for 27 yards and a touchdown in Sunday's 26-25 win over the Giants.
2023-12-22: Kupp brought in six of 12 targets for 52 yards and rushed once for minus-3 yards in the Rams' 30-22 win over the Saints on Thursday night.
2023-12-18: Kupp recorded eight receptions on eight targets for 111 yards and a touchdown in Sunday's 28-20 win over the Commanders.
2023-12-10: Kupp recorded eight receptions on 10 targets for 115 yards and a touchdown in Sunday's 37-31 loss to the Ravens.
2023-12-04: Kupp caught six of eight targets for 39 yards and a touchdown in Sunday's 36-19 win over the Browns.

@JimNayzium
Copy link

@nntrn - Thanks so much! This is pretty slick! However, what I need is the Date/Time of the accouncements, not just the Date. Like if the Date was 2024-09-15 17:53:21 UTC type thing.

There is now way to reverse engineer from this data the game-clock time and period number of the announcment. But I appreciate your attempts and love what you did!

@psuTickleMonster
Copy link

Good morning. Any idea why this link wouldn't display the post season? It is an eventlog for each player, only makes sense it would display post as well. https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons/2024/athletes/4066533/eventlog?limit=100

@AdrianMachado
Copy link

For fans of OpenAPI/Swagger, I started working on a document here. I would appreciate any contributions - the current format is a bit hard for me to work with.

@RyanGiles
Copy link

RyanGiles commented Oct 11, 2024 •
edited
Loading

Does anyone know why the request for all active player ids [https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?limit=20000&active=true] is returning players with the value active = false as well? I could sort manually on my end, but if the api request worked correctly it would cut down on load time drastically (returning 18738 player -> returning about 1700 players).

@JimNayzium
Copy link

I am not sure about your referenced end-point, but what I do is a two part call. One to the current rosters, then parse that by player_id/id and then only ask for the rostered players. Not sure it's what you want, but it is a lot better than getting all the athlete ids!

@JimNayzium
Copy link

@RyanGiles : To actually show what I do a little more usefully, I call this end-point:

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{{teamId}}?enable=roster

Inside a loop that pools the fetches and lets them run asynchroniously so I can loop through the teamIds, and then I just pull the players from the actual rosters after I have that, if that makes sense.

@RyanGiles
Copy link

@RyanGiles : To actually show what I do a little more usefully, I call this end-point:

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{{teamId}}?enable=roster

Inside a loop that pools the fetches and lets them run asynchroniously so I can loop through the teamIds, and then I just pull the players from the actual rosters after I have that, if that makes sense.

I see how that workaround can work for getting all rostered players. I'll try that out and see how the runtime compares. It would still be great to just have it return active players like how it's supposed to.

@RyanGiles
Copy link

@RyanGiles : To actually show what I do a little more usefully, I call this end-point:

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{{teamId}}?enable=roster

Inside a loop that pools the fetches and lets them run asynchroniously so I can loop through the teamIds, and then I just pull the players from the actual rosters after I have that, if that makes sense.

After doing some testing, it's significantly faster (3 sec vs 12 sec) to do the single api call for all players and then filter through them manually than it is to make 32 different api calls for each team's roster

@JimNayzium
Copy link

JimNayzium commented Oct 13, 2024 •
edited
Loading

I know the ESPN and Sleeper API calls for all the players waists a huge amount of loading time. Sleeper's has over 10,000 players when we only need 10-15 percent that. And ESPN's has maybe more than that I can't remember.

I know in my application, calling the all athletes and parsing it after the fact was way way slower. I use PHP to load my API so maybe if you are using python or R or something it may be faster than PHP, I don't really know. I just now when I did the way I describe above I removed all my timeout errors that I was having on my app.

I will add though that I use laravel's Http::pool() methods which allow us to make 32 team calls all at once and call them asynchroniously, which really solved my issues too!

@augarrett
Copy link

is there any endpoint that will let me pull or compile defense tendencies data? for instance man% zone% etc

@JimNayzium
Copy link

Not from ESPN that I know of. You may want to check the roto sites, and maybe PFF. I think you are most likely looking at a scraping solution over an API solution based on the stuff I've found in general. And of course you can always roll with sportsdata.io, but it's exepensive.

@RhettTitus
Copy link

Is there a way to reach power rankings or football power indexes (fpi) through an api on ESPN?

@sraben
Copy link

sraben commented Dec 25, 2024

Would love to know if you found a way to pull the FPI. I would also be interested in this ability.

@PeterGion
Copy link

@RyanGiles : To actually show what I do a little more usefully, I call this end-point:

site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{{teamId}}?enable=roster

Inside a loop that pools the fetches and lets them run asynchroniously so I can loop through the teamIds, and then I just pull the players from the actual rosters after I have that, if that makes sense.

This works however is there a way to filter out the athletes on the practice squad? I tried to do site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{{teamId}}?enable=roster&status=active, and this doesn't seem to do anything. Am I doing something wrong here or is the only way to do this to filter this out in the loop?

@ryanbuckner
Copy link

This works however is there a way to filter out the athletes on the practice squad? I tried to do site.api.espn.com/apis/site/v2/sports/football/nfl/teams/{{teamId}}?enable=roster&status=active, and this doesn't seem to do anything. Am I doing something wrong here or is the only way to do this to filter this out in the loop?

I think you're doing it right. Filter these out when looping:

team > athletes > [index] > status > type = practice-squad

@dylanoandersen
Copy link

I am very new to API's and this page can be a little overwhelming. I am creating a fantasy football app and can't seem to find the correct API URL to get just player stats. Is there an API that only has all active players stats (all positions applicable to fantasy football).

@JuKahl
Copy link

JuKahl commented Jan 16, 2025

does anyone know when the nfl games endpoint is usually updated? it still lists the games from the first week of the postseason.

i am aware that i can also access the games via other endpoints, but i am currently using this one.

@ryanbuckner
Copy link

ryanbuckner commented Jan 16, 2025 •
edited
Loading

does anyone know when the nfl games endpoint is usually updated? it still lists the games from the first week of the postseason.

i am aware that i can also access the games via other endpoints, but i am currently using this one.

https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/events?seasontype=3&dates=2024&week=2

or

https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard?seasontype=3&dates=2024&week=2

@akreu
Copy link

akreu commented Jan 21, 2025

Great info here! If I wanted to get player stats by quarter, ie: pass yards by quarter for a specific event.. is the only way by parsing the play by play data? Curious if anyone has done this and if they had any tips or guidance.

Thanks!

@nntrn
Copy link
Author

nntrn commented Jan 29, 2025

@akreu

If I wanted to get player stats by quarter, ie: pass yards by quarter for a specific event.. is the only way by parsing the play by play data?

1- Player stats for every game but it isn't broken down by quarter.

2- You have more filtering options if you parse plays from drives instead of directly from plays

3- lm-api-reads.fantasy.espn.com might have what you're looking for if you can figure out the param stuff
(i.e. &view=mMatchup&view=mMatchupScore&scoringPeriodId=${scoringPeriodId})
See examples by nathanbraun, sjweil9

@akreu
Copy link

akreu commented Feb 7, 2025 •
edited
Loading

@RyanGiles

Does anyone know why the request for all active player ids [https://sports.core.api.espn.com/v3/sports/football/nfl/athletes?limit=20000&active=true] is returning players with the value active = false as well? I could sort manually on my end, but if the api request worked correctly it would cut down on load time drastically (returning 18738 player -> returning about 1700 players).

Stumbled upon this question when looking for a similar solution and discovered you can put the season in the url and it will narrow down the list significantly:

https://sports.core.api.espn.com/v3/sports/football/nfl/seasons/2025/athletes

Returning ~4500 vs ~19,000 results on your original endpoint

EDIT:
Also thank you @nntrn for the above information!

@karan-tkn
Copy link

karan-tkn commented Feb 12, 2025 •
edited by nntrn
Loading

Here is the list I have compiled of the play_type_id's (which are my index numbers in the array, with the text and abbreviation for espn's play by play feeds.

If the value is null, it means I have not found and confirmed a play with that number play_type_id yet.

I have imported and digested all the 2023 season and searched through it fully. I am working on other past seasons to try and fill in the gaps.

` $play_types = [

1 => null,
2 => ["text" => 'End Period', "abv" => 'EP'],
3 => ["text" => 'Pass Incompletion', "abv" => null],
4 => null,
5 => ["text" => 'Rush', "abv" => 'RUSH'],
6 => null,
7 => ["text" => 'Sack', "abv" => null],
8 => ["text" => 'Penalty', "abv" => 'PEN'],
9 => ["text" => 'Fumble Recovery (Own)', "abv" => null],
10 => null,
11 => null,
12 => ["text" => 'Kickoff Return (Offense)', "abv" => null],
13 => null,
14 => null,
15 => null,
16 => null,
17 => ['text' => 'Blocked Punt', 'abv' => 'BP'],
18 => ['text' => 'Blocked Field Goal', 'abv' => 'BFG'],
19 => null,
20 => ['text' => 'Safety', 'abv' => 'SF'],
21 => ["text" => 'Timeout', "abv" => 'TO'],
22 => null,
23 => null,
24 => ["text" => 'Pass Reception', "abv" => 'REC'],
25 => null,
26 => ["text" => 'Pass Interception Return', "abv" => 'INTR'],
27 => null,
28 => null,
29 => ['text' => 'Fumble Recovery (Opponent)', 'abv' => null],
30 => null,
31 => null,
32 => ['text' => 'Kickoff Return Touchdown', 'abv' => 'TD'],
33 => null,
34 => ['text' => 'Punt Return Touchdown', 'abv' => 'TD'],
35 => null,
36 => ["text" => 'Interception Return Touchdown', "abv" => 'TD'],
37 => ['text' => 'Blocked Punt Touchdown', 'abv' => 'TD'],
38 => ['text' => 'Blocked Field Goal Touchdown', 'abv' => 'TD'],
39 => ['text' => 'Fumble Return Touchdown', 'abv' => 'TD'],
40 => ['text' => 'Missed Field Goal Return', 'abv' => 'AFG'],
41 => null,
42 => null,
43 => null,
44 => null,
45 => null,
46 => null,
47 => null,
48 => null,
49 => null,
50 => null,
51 => ["text" => 'Pass', "abv" => 'PASS'],
52 => ["text" => 'Punt', "abv" => 'PUNT'],
53 => ["text" => 'Kickoff', "abv" => 'K'],
54 => null,
55 => null,
56 => null,
57 => ['text' => 'Defensive 2pt Conversion', 'abv' => 'D2P'],
58 => null,
59 => ["text" => 'Field Goal Good', "abv" => 'FG'],
60 => ["text" => 'Field Goal Missed', "abv" => 'FGM'],
61 => null,
62 => null,
63 => null,
64 => null,
65 => ["text" => 'End of Half', "abv" => 'EH'],
66 => ["text" => 'End of Game', "abv" => 'EG'],
67 => ["text" => 'Passing Touchdown', "abv" => 'TD'],
68 => ["text" => 'Rushing Touchdown', "abv" => 'TD'],
69 => null,
70 => null,
71 => null,
72 => null,
73 => null,
74 => ["text" => 'Official Timeout', "abv" => 'Off TO'],
75 => ["text" => 'Two-minute warning', "abv" => '2Min Warn'],
76 => null,
77 => null,
78 => null,
79 => ["text" => 'End of Regulation', "abv" => 'ER']

]; `

Hi, have you found any api for this ??
i was looking to know about plays id for basketball-nba game but found nothing,
Please help @JimNayzium @everyone

@dylanoandersen
Copy link

right now
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/types/2/athletes/3915416/statistics
and
https://sports.core.api.espn.com/v2/sports/football/leagues/nfl/seasons/2024/types/2/athletes/3915416/projections

show the same stats. Is this suppose to happen since it is the off-season meaning it will update when the 2025 season comes around?

@JimNayzium
Copy link

What happens if we exceed 2500 calls per day? Do we get our IP banned for good? Or do responses just not work after that for the day?

You'll receive an error on the next calls until your quota resets. I don't think it's as cut and dry as 2500 per day. I think there are restrictions on frequency too. I've had errors come back saying I've hit a limit and then waited an hour or two to rerun successfully.

The APIs are not supported so I think the 2500 number is a guess.

So two days ago I had some development going on, and accidentally allowed my system to repeatedly call the API in a loop that I stupidly ran live! hahaha. I think my IP got rail-roaded, as all requests, even in the browser now die for me. But if I change my network to my cell 5G hot spot, they go through again immediately. Surely that means I got banned or choked or something, right?

And there is no known way to reach out to anyone to explain this or get re-upped, right? Just have to wait it out and pray?

@akreu
Copy link

akreu commented Feb 20, 2025

So two days ago I had some development going on, and accidentally allowed my system to repeatedly call the API in a loop that I stupidly ran live! hahaha. I think my IP got rail-roaded, as all requests, even in the browser now die for me. But if I change my network to my cell 5G hot spot, they go through again immediately. Surely that means I got banned or choked or something, right?

And there is no known way to reach out to anyone to explain this or get re-upped, right? Just have to wait it out and pray?

There's no official support for their API so you'll need to wait it out or maybe look into sending your requests through some rotating proxies.

@JimNayzium
Copy link

rotating proxies sounds like it's above my current pay-grade. 😄 But I could probably figure it out. Is that basically like sending my requests from a different IP address each time somehow automatically? A quick google returned services like smartproxy and simiilar.

Is that basically the gist of it? My outgoing request goes out as if it's not from me, but from some other "proxied" IP address?

@akreu
Copy link

akreu commented Feb 20, 2025

rotating proxies sounds like it's above my current pay-grade. 😄 But I could probably figure it out. Is that basically like sending my requests from a different IP address each time somehow automatically? A quick google returned services like smartproxy and simiilar.

Is that basically the gist of it? My outgoing request goes out as if it's not from me, but from some other "proxied" IP address?

Yep, you got it!

@JimNayzium
Copy link

Here is the list I have compiled of the play_type_id's (which are my index numbers in the array, with the text and abbreviation for espn's play by play feeds.
If the value is null, it means I have not found and confirmed a play with that number play_type_id yet.
I have imported and digested all the 2023 season and searched through it fully. I am working on other past seasons to try and fill in the gaps.
` $play_types = [

1 => null,
2 => ["text" => 'End Period', "abv" => 'EP'],
3 => ["text" => 'Pass Incompletion', "abv" => null],
4 => null,
5 => ["text" => 'Rush', "abv" => 'RUSH'],
6 => null,
7 => ["text" => 'Sack', "abv" => null],
8 => ["text" => 'Penalty', "abv" => 'PEN'],
9 => ["text" => 'Fumble Recovery (Own)', "abv" => null],
10 => null,
11 => null,
12 => ["text" => 'Kickoff Return (Offense)', "abv" => null],
13 => null,
14 => null,
15 => null,
16 => null,
17 => ['text' => 'Blocked Punt', 'abv' => 'BP'],
18 => ['text' => 'Blocked Field Goal', 'abv' => 'BFG'],
19 => null,
20 => ['text' => 'Safety', 'abv' => 'SF'],
21 => ["text" => 'Timeout', "abv" => 'TO'],
22 => null,
23 => null,
24 => ["text" => 'Pass Reception', "abv" => 'REC'],
25 => null,
26 => ["text" => 'Pass Interception Return', "abv" => 'INTR'],
27 => null,
28 => null,
29 => ['text' => 'Fumble Recovery (Opponent)', 'abv' => null],
30 => null,
31 => null,
32 => ['text' => 'Kickoff Return Touchdown', 'abv' => 'TD'],
33 => null,
34 => ['text' => 'Punt Return Touchdown', 'abv' => 'TD'],
35 => null,
36 => ["text" => 'Interception Return Touchdown', "abv" => 'TD'],
37 => ['text' => 'Blocked Punt Touchdown', 'abv' => 'TD'],
38 => ['text' => 'Blocked Field Goal Touchdown', 'abv' => 'TD'],
39 => ['text' => 'Fumble Return Touchdown', 'abv' => 'TD'],
40 => ['text' => 'Missed Field Goal Return', 'abv' => 'AFG'],
41 => null,
42 => null,
43 => null,
44 => null,
45 => null,
46 => null,
47 => null,
48 => null,
49 => null,
50 => null,
51 => ["text" => 'Pass', "abv" => 'PASS'],
52 => ["text" => 'Punt', "abv" => 'PUNT'],
53 => ["text" => 'Kickoff', "abv" => 'K'],
54 => null,
55 => null,
56 => null,
57 => ['text' => 'Defensive 2pt Conversion', 'abv' => 'D2P'],
58 => null,
59 => ["text" => 'Field Goal Good', "abv" => 'FG'],
60 => ["text" => 'Field Goal Missed', "abv" => 'FGM'],
61 => null,
62 => null,
63 => null,
64 => null,
65 => ["text" => 'End of Half', "abv" => 'EH'],
66 => ["text" => 'End of Game', "abv" => 'EG'],
67 => ["text" => 'Passing Touchdown', "abv" => 'TD'],
68 => ["text" => 'Rushing Touchdown', "abv" => 'TD'],
69 => null,
70 => null,
71 => null,
72 => null,
73 => null,
74 => ["text" => 'Official Timeout', "abv" => 'Off TO'],
75 => ["text" => 'Two-minute warning', "abv" => '2Min Warn'],
76 => null,
77 => null,
78 => null,
79 => ["text" => 'End of Regulation', "abv" => 'ER']

]; `

Hi, have you found any api for this ?? i was looking to know about plays id for basketball-nba game but found nothing, Please help @JimNayzium @everyone

I've not found any api's for this at all. I just keep a running track of the new ones when I find them, etc... and I only do this for NFL not any other sport. Sorry!

@JimNayzium
Copy link

rotating proxies sounds like it's above my current pay-grade. 😄 But I could probably figure it out. Is that basically like sending my requests from a different IP address each time somehow automatically? A quick google returned services like smartproxy and simiilar.
Is that basically the gist of it? My outgoing request goes out as if it's not from me, but from some other "proxied" IP address?

Yep, you got it!

You are a GOD-SEND to me!! I figured it out! Thanks for the tip.

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