Fantasy Football API Documentation

Data Dictionary

Available Services

Auction Values

Retrieve fantasy football auction values for the current season

Endpoint:
https://api.fantasynerds.com/v1/nfl/auction?apikey=TEST&teams=&budget=&format=
Variable Value Description
apikey Your API Key
teams The number of teams for the league.

Valid integer values: 8,10,12,14,16

Default value if not passed: 12

Please note that some league sizes will not have auction values.
budget The league budget.

Default integer value if not passed: 200
format The scoring format: std = standard scoring, ppr = point per reception

Valid options: std, ppr

Default value if not passed: std

Average Draft Position (ADP)

Retrieve the current average draft position for the upcoming season by scoring format and league size

Endpoint:
https://api.fantasynerds.com/v1/nfl/adp?apikey=TEST&teams=&format=
Variable Value Description
apikey Your API Key
teams The number of teams for the league.

Valid integer values: 8,10,12,14,16

Default value if not passed: 12

Please note that some league sizes will not have ADP values.
format The scoring format: std = standard scoring, ppr = point per reception, half = half-point-ppr, superflex = Superflex 2 QB

Valid options: std, ppr, half, superflex

Default value if not passed: std

Best Ball Rankings

Retrieve Best Ball rankings for the upcoming NFL season.

Endpoint:
https://api.fantasynerds.com/v1/nfl/bestball?apikey=TEST
Variable Value Description
apikey Your API Key

Bye Weeks

Retrieve the bye weeks for the current season

Endpoint:
https://api.fantasynerds.com/v1/nfl/byes?apikey=TEST
Variable Value Description
apikey Your API Key

Daily Fantasy Football

Get the salaries, Fantasy Nerds projected points, and Bang for Your Buck scores for FanDuel, DraftKings, and Yahoo for the current week.

Endpoint:
https://api.fantasynerds.com/v1/nfl/dfs?apikey=TEST&slateId=
Variable Value Description
apikey Your API Key
slateId The slateId is required and can be obtained by calling the Daily Fantasy Football - Get Slates service (dfs-slates).

Players will be returned and their associated salaries along with projected points and our patented Bang for Your Buck scores to help identify value plays.

Daily Fantasy Football - Get Slates

Get a listing of the current slates for upcoming DFS Classic contests (Weeks 1-18). The slateId's from this response will be needed to retrieve player data for a specific slate.

Endpoint:
https://api.fantasynerds.com/v1/nfl/dfs-slates?apikey=TEST
Variable Value Description
apikey Your API Key

Defensive Ranks

Retrieve the defensive rankings for all NFL teams including their ordinal ranking against each skill position.

Endpoint:
https://api.fantasynerds.com/v1/nfl/defense-rankings?apikey=TEST
Variable Value Description
apikey Your API Key

Depth Charts

Retrieve current depth charts for all NFL teams

Endpoint:
https://api.fantasynerds.com/v1/nfl/depth?apikey=TEST
Variable Value Description
apikey Your API Key

Draft Projections

Retrieve draft projections for the upcoming season

Endpoint:
https://api.fantasynerds.com/v1/nfl/draft-projections?apikey=TEST
Variable Value Description
apikey Your API Key

Draft Rankings

Retrieve draft rankings and injury risk for the current season

Endpoint:
https://api.fantasynerds.com/v1/nfl/draft-rankings?apikey=TEST&format=
Variable Value Description
apikey Your API Key
format The scoring format: std = standard scoring, ppr = point per reception, half = half-point-ppr, superflex = Superflex 2 QB

Valid options: std, ppr, half, superflex

Default value if not passed: std

Dynasty Rankings

Retrieve consensus dynasty rankings. Dynasty leagues are where you keep most or all of your players each year. Rankings are therefore based upon multi-year outlooks.

Endpoint:
https://api.fantasynerds.com/v1/nfl/dynasty?apikey=TEST
Variable Value Description
apikey Your API Key

Fantasy Leaders

Retrieve weekly and season leaders by total fantasy points accumulated. Specify the scoring format and the week (0 for the entire season) and retrieve players by total fantasy points scored.

Endpoint:
https://api.fantasynerds.com/v1/nfl/leaders?apikey=TEST&format=&position=&week=
Variable Value Description
apikey Your API Key
format The scoring format: std = standard scoring, ppr = point per reception, half = half-point-ppr

Valid options: std, ppr, half

Default value if not passed: std
position Retrieve scoring leaders for a specific position.

Valid options: ALL, QB, RB, WR, TE, FLEX, K, IDP

Default value if not passed: ALL
week The specific week of the NFL season to return scoring leaders for.

Valid options: 0-18 (Use 0 to retrieve season leaders and 1-18 for the specific week only)

Default value if not passed: 0

IDP - Draft

Retrieve IDP (Individual Defensive Players) rankings for the upcoming NFL season.

Endpoint:
https://api.fantasynerds.com/v1/nfl/idp-draft?apikey=TEST
Variable Value Description
apikey Your API Key

IDP Weekly Projections

Retrieve weekly projections for IDP players

Endpoint:
https://api.fantasynerds.com/v1/nfl/idp-weekly?apikey=TEST
Variable Value Description
apikey Your API Key

Injury Reports

Retrieve injury reports for all NFL teams during the regular season.

Endpoint:
https://api.fantasynerds.com/v1/nfl/injuries?apikey=TEST
Variable Value Description
apikey Your API Key

News

Retrieve current player and team news along with fantasy analysis from around the industry.

Endpoint:
https://api.fantasynerds.com/v1/nfl/news?apikey=TEST
Variable Value Description
apikey Your API Key

NFL Picks

Get the current week's NFL game picks for each game broken down by expert.

Endpoint:
https://api.fantasynerds.com/v1/nfl/nfl-picks?apikey=TEST
Variable Value Description
apikey Your API Key

NFL Schedule

Retrieve the current regular season schedule

Endpoint:
https://api.fantasynerds.com/v1/nfl/schedule?apikey=TEST
Variable Value Description
apikey Your API Key

NFL Standings

Retrieve the current regular-season standings for all NFL teams including their rankings within their division and conference

Endpoint:
https://api.fantasynerds.com/v1/nfl/standings?apikey=TEST
Variable Value Description
apikey Your API Key

NFL Teams

Get a list of NFL teams and their team codes

Endpoint:
https://api.fantasynerds.com/v1/nfl/teams?apikey=TEST
Variable Value Description
apikey Your API Key

Player Adds and Drops

Retrieve the players most added and dropped over the previous 48 hours across all Yahoo, ESPN, CBS Sports, and Sleeper leagues.

Endpoint:
https://api.fantasynerds.com/v1/nfl/add-drops?apikey=TEST
Variable Value Description
apikey Your API Key

Player Tiers

Tiers are peer-grouped listings of players, and are particularly useful for conducting value-based drafting.

Endpoint:
https://api.fantasynerds.com/v1/nfl/tiers?apikey=TEST&format=
Variable Value Description
apikey Your API Key
format The scoring format. std = Standard Scoring, ppr = Point Per Reception

Valid options: std, ppr

Default value if not passed is std.

Players

Get a list of current NFL players

Endpoint:
https://api.fantasynerds.com/v1/nfl/players?apikey=TEST&include_inactive=
Variable Value Description
apikey Your API Key
include_inactive OPTIONAL: Set to 1 to include inactive players

Playoff Projections

Retrieve statistical projections for the NFL playoffs

Endpoint:
https://api.fantasynerds.com/v1/nfl/playoffs?apikey=TEST&week=
Variable Value Description
apikey Your API Key
week Pass along the playoff week number that you would like to retrieve projections for.

1 is for the Wild Card round
2 is for the Divisional Round
3 is for the Conference Championships
4 is for the Super Bowl

Rest of Season Projections

Retrieve rest of season (ROS) projections for all skill and IDP players. Statistical categories returned will depend upon the position. For example, an IDP player will not have passing yards nor will a Team Defense/Special Teams have rushing yards.

Endpoint:
https://api.fantasynerds.com/v1/nfl/ros?apikey=TEST
Variable Value Description
apikey Your API Key

Weather Forecasts

Retrieve the weather forecasts for all NFL teams

Endpoint:
https://api.fantasynerds.com/v1/nfl/weather?apikey=TEST
Variable Value Description
apikey Your API Key

Weekly Projections

Retrieve weekly projections with statistical category projections for Weeks 1 - 18

Endpoint:
https://api.fantasynerds.com/v1/nfl/weekly-projections?apikey=TEST
Variable Value Description
apikey Your API Key

Weekly Rankings

Retrieve current weekly rankings (Weeks 1 - 18) including projected points for each player

Endpoint:
https://api.fantasynerds.com/v1/nfl/weekly-rankings?apikey=TEST&format=
Variable Value Description
apikey Your API Key
format The scoring format: std = standard scoring, ppr = point per reception, half = half point per reception

Valid options: std, ppr, half

Default value if not passed: std