espn-fantasy-baseball

A node wrapper that encompasses the ESPN Fantasy Baseball API. This is an ongoing project and documentation is subject to change rapidly.

Current Discovered Endpoints:

• Retreive API Key (v6 is used in prod. However, login api requires reCapthca it looks like)
  https://registerdisney.go.com/jgc/v5/client/ESPN-FANTASYLM-PROD/api-key?langPref=en-US

• Authenticate w/ API Key (Requires header APIKEY {API_KEY} and Content-Type: application/json) (v6 is used in prod. However, login api requires reCapthca it looks like)
  https://registerdisney.go.com/jgc/v5/client/ESPN-FANTASYLM-PROD/guest/login?langPref=en-US

• General http://fantasy.espn.com/apis/v3/games/flb/seasons/2021/

• Gets league by the league's id
  http://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/{league_id}/

• [scoreboard (probably dont need), mMatchup, mRoster, mSettings, mDraftDetail, mTeam] (Different league pages)
  http://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/59645?view=mMatchup

• Gets a specific team object
  http://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/{league_id}/teams/{team_id}/
  https://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/59645/teams/15?view=scoreboard
  https://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/59645/teams/15?view=mRoster
  https://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/59645/teams/15?view=mTeam

• Gets a list of the current league memebers
  http://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/59645/members

• Gets MLB Team schedules
  http://fantasy.espn.com/apis/v3/games/flb/seasons/2021?view=proTeamSchedules_wl

• Gets MLB players. Headers required
  
  http://fantasy.espn.com/apis/v3/games/flb/seasons/2021?view=players_wl

• POST Pick up player from waiver wire: https://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/59645/transactions/
  Example Body:

{
    "executionType": "EXECUTE",
    "isLeagueManager": false,
    "items": [
        {
            "playerId": 32758,
            "type": "ADD",
            "toTeamId": 15
        }
    ],
    "scoringPeriodId": 16,
    "teamId": 15,
    "type": "FREEAGENT"
}  

• POST add/remove players from watch list
  https://fantasy.espn.com/apis/v3/games/flb/seasons/2021/segments/0/leagues/59645/teams/15

{
    "watchList": [31094, 30862, 39807, 32758]
}

Example Param and Header Options:

view (Type: QueryParam):

mTeam
mBoxscore
mRoster
mSettings
kona_player_info
player_wl
mSchedule
mMatchup
mScoreboard
scoreboard

x-fantasy-filter (Type: Header):

{
  "players": {
    "filterStatus": { "value": ["FREEAGENT", "WAIVERS"] },
    "filterSlotIds": { "value": [2] },
    "filterRanksForScoringPeriodIds": { "value": [19] },
    "limit": 2000,
    "offset": 0,
    "sortPercOwned": { "sortAsc": false, "sortPriority": 1 },
    "sortDraftRanks": {
      "sortPriority": 100,
      "sortAsc": true,
      "value": "STANDARD"
    },
    "filterRanksForRankTypes": { "value": ["STANDARD"] },
    "filterStatsForTopScoringPeriodIds": {
      "value": 5,
      "additionalValue": [
        "002022",
        "102022",
        "002021",
        "012022",
        "022022",
        "032022",
        "042022",
        "062022",
        "010002022"
      ]
    }
  }
}

Resources:

Authenticating for private leagues:
https://github.com/cwendt94/espn-api/discussions/150
Inspired by:
https://github.com/cwendt94/espn-api