Skip to content
nntrn edited this page Jun 13, 2024 · 1 revision

Get Entire NFL Roster

Views that I know of:

  • players_wl - great if you just want player name, id, and team
  • kona_player_info - great if you also want simple scoring stats and injury status
  • chui_default - great if you also want detailed stats and historical injuries

players_wl

URL: /apis/v3/games/ffl/seasons/{year}/players?scoringPeriodId=0&view=players_wl
Size: 1.9MB

$ curl -o save-this-because-its-huge.json -H 'X-Fantasy-Filter: {"players":{"limit":11000}}' "https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?scoringPeriodId=0&view=players_wl"

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 1938k    0 1938k    0     0  3014k      0 --:--:-- --:--:-- --:--:-- 3015k
Response Object
{
  "defaultPositionId": "number",
  "droppable": "boolean",
  "eligibleSlots": [
    "number"
  ],
  "firstName": "string",
  "fullName": "string",
  "id": "number",
  "lastName": "string",
  "proTeamId": "number",
  "universeId": "number"
}

kona_player_info

URL: /apis/v3/games/ffl/seasons/{year}/players?scoringPeriodId=0&view=kona_player_info
Size: ~27MB

$ curl -o save-this-because-its-huge.json -H 'X-Fantasy-Filter: {"players":{"limit":11000}}' "https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?scoringPeriodId=0&view=kona_player_info"

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 27.3M    0 27.3M    0     0  15.0M      0 --:--:--  0:00:01 --:--:-- 15.0M
Response Object
{
  "active": "boolean",
  "defaultPositionId": "number",
  "droppable": "boolean",
  "eligibleSlots": ["number"],
  "firstName": "string",
  "fullName": "string",
  "id": "number",
  "injured": "boolean",
  "jersey": "string",
  "lastName": "string",
  "proTeamId": "number",
  "stats": [
    {
      "externalId": "string",
      "id": "string",
      "proTeamId": "number",
      "scoringPeriodId": "number",
      "seasonId": "number",
      "statSourceId": "number",
      "statSplitTypeId": "number",
      "stats": {}
    }
  ]
}

chui_default

URL: /apis/v3/games/ffl/seasons/{year}/players?scoringPeriodId=0&view=chui_default
Size: ~75MB

$ curl -o save-this-because-its-huge.json -H 'X-Fantasy-Filter: {"players":{"limit":11000}}' "https://lm-api-reads.fantasy.espn.com/apis/v3/games/ffl/seasons/2024/players?scoringPeriodId=0&view=chui_default"

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 74.7M    0 74.7M    0     0  19.0M      0 --:--:--  0:00:03 --:--:-- 19.0M

Response Object:

Expand to view
{
  "activationInfo": {
    "clientAddress": "null",
    "platform": "null"
  },
  "active": "boolean",
  "creationInfo": {
    "clientAddress": "null",
    "platform": "string"
  },
  "dateUniverseChanged": "number",
  "defaultPositionId": "number",
  "draftedSeasonId": "number",
  "droppable": "boolean",
  "dualPositionEligible": "boolean",
  "eligibleSlots": ["number"],
  "firstName": "string",
  "fullName": "string",
  "id": "number",
  "injured": "boolean",
  "injuryStatusOverridden": "boolean",
  "invalid": "boolean",
  "jersey": "string",
  "lastName": "string",
  "lastUpdateInfo": {
    "clientAddress": "null",
    "platform": "string"
  },
  "laterality": "string",
  "proTeamId": "number",
  "replacementId": "number",
  "stance": "string",
  "stats": [
    {
      "externalId": "string",
      "id": "string",
      "proTeamId": "number",
      "scoringPeriodId": "number",
      "seasonId": "number",
      "statSourceId": "number",
      "statSplitTypeId": "number",
      "stats": {},
      "variance": {}
    }
  ],
  "universeId": "number"
}
Clone this wiki locally