Fantasy Football Rankings
The Industry's ONLY Weighted Consensus

Fantasy Football API

Depending upon your needs, FFN members can retrieve certain parts of our data in both XML and JSON formats for use within their own applications. We also provide more enhanced data for those users who either require the additional information or plan to use the data within a commercial application. To get started, create a free API key and review the API Documentation.

If you are using the fantasy football WordPress plugin, this is the place where you'll need to generate an API key. Click the Create button below.

Welcome back

Your API Key
Inactive
API Key Status
Level 1
API Access Level

Get a head start!

Greg Baugues has generously donated code to get you started with an open source Ruby Gem. His code is exceptionally clean, well-documented, and helpful! Thank you Greg!

API Levels

Level 1: Free API Access
Cost: Free
Feel free to use some of the FFN data for your personal use. This is a great option for those just starting out or who only need small amounts of data. Level 1 will provide the same data that any visitor to FFN can see. Users are required to cache API results.
Level 2: Premium API Access
Cost: Free with FFN Premium Membership
Premium members of FFN can retrieve the same data as Level 1 users for their personal use; however Level 2 will provide most of the same data sets that any premium member of FFN can see. Instead of the Top 10 or Top 15 for example, all results are returned. Users are required to cache API results.
Level 3: Commercial API Access
Cost: $299 for complete season
If you plan on using FFN data for more than just your personal use or in situations where you plan on making thousands of requests, plan on using FFN data on your website, or plan to use FFN data within an application that will be made available to others, please use Level 3. Certain data sets may only be available to commercial users. Caching guidelines are not as strictly enforced for commercial users.

API Services

Service Description Level 1 Level 2 Level 3
NFL Teams Get a list of the NFL teams and their codes Check Check Check
NFL Schedule Retrieve the 2016 NFL Schedule Check Check Check
NFL Players Get a list of all fantasy players from FFN Check Check Check
Bye Weeks Get a list of the teams and their bye weeks Check Check Check
Weather Forecasts Get the game day weather forecast for the current week's games Check Check Check
Auction Values Get a list of fantasy auction values Top 15 Check Check
Draft Rankings Get a list of draft rankings (Both PPR and Standard) Top 15 Check Check
Draft Projections Get draft projections for the 2016 NFL season Top 15 Check Check
Fantasy Football Tiers Tiers are peer-grouped listings of players. Useful for conducting value-based drafting. -- Check Check
IDP Draft Rankings Get IDP draft rankings for the 2016 NFL season Top 15 Check Check
Dynasty Rankings Retrieve 2016 dynasty rankings Top 15 Check Check
Weekly Rankings Get the weekly rankings (Both PPR and Standard) Top 15 Check Check
Weekly Projections Get the weekly projections for each player Top 15 Check Check
Weekly IDP Rankings Get the Individual Defensive Player (IDP) rankings for the current week Top 15 Check Check
Injuries Retrieve the injury reports for each team -- Check Check
Depth Charts Get the depth charts for each team -- Check Check
NFL Picks Get the NFL game picks for each game broken down by expert. -- -- Check
Defensive Rankings Get the defensive rankings for each team -- -- Check
Game Day Inactives Get the list of game day inactives for key players -- -- Check
Player Stats & Info Get the historical stats and info for each player. Player stats are updated weekly each Tuesday at 1:00 pm ET. -- -- Check
Daily Fantasy Football Get the salaries, FFN projected points, and Bang for Your Buck scores for FanDuel, DraftKings, and Yahoo for the current week -- -- Check
NFL Playoff Projections New Retrieve NFL playoff projections for each team that plays from wildcard to Super Bowl. -- -- Check

API Documentation

All services can be retrieved using simple REST calls. The URL construction is highlighted beneath each service. All service URLs will follow this pattern:

http://www.fantasyfootballnerd.com/service/ {SERVICE-NAME} / {FORMAT} / {API-KEY}

The example below will explain how to set the URL structure to retrieve all NFL teams.

The {SERVICE-NAME} is the specific service you want to retrieve.

For example, to retrieve all NFL teams, you would replace {SERVICE-NAME} with nfl-teams.

The {FORMAT} can have one of two options: xml or json

For example, to retrieve all NFL teams in JSON format, you would replace {FORMAT} with json.

The {API-KEY} is the API Key assigned to you. For testing purposes, you can also use the API Key of: test. Test calls will provide dummy data for you to develop against.

For example, you would replace {API-KEY} with test for testing purposes or with your actual API key for live data.

Example: http://www.fantasyfootballnerd.com/service/nfl-teams/json/test

All service calls are documented below.

API Services

NFL Teams

Get a list of the NFL teams and their codes

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/nfl-teams/xml/test/

Live URL: Sign in to create an API key

Variables for NFL Teams

Service-Name: nfl-teams

Format: xml or json

NFL Schedule

Retrieve the 2016 NFL Schedule

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/schedule/xml/test/

Live URL: Sign in to create an API key

Variables for NFL Schedule

Service-Name: schedule

Format: xml or json

NFL Players

Get a list of all fantasy players from FFN

You can optionally request a specific position: QB, RB, WR, TE, K, DEF to return only ACTIVE players among that position. Leave the position parameter empty to retrieve all players including inactive players.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{position}/

Test URL: http://www.fantasyfootballnerd.com/service/players/xml/test/QB/

Live URL: Sign in to create an API key

Live URL (All Players): http://www.fantasyfootballnerd.com/service/players/xml/test/

Variables for NFL Players

Service-Name: players

Format: xml or json

{position}: Example: QB (position to retrieve)

Bye Weeks

Get a list of the teams and their bye weeks

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/byes/xml/test/

Live URL: Sign in to create an API key

Variables for Bye Weeks

Service-Name: byes

Format: xml or json

Weather Forecasts

Get the game day weather forecast for the current week's games

This will provide weather forecasts for each NFL game generally within 5 days of kickoff.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/weather/xml/test/

Live URL: Sign in to create an API key

Variables for Weather Forecasts

Service-Name: weather

Format: xml or json

Auction Values

Get a list of fantasy auction values

Pass along a PPR indicator ("ppr" or "1") to receive PPR auction rankings

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{ppr}/

Test URL: http://www.fantasyfootballnerd.com/service/auction/xml/test/ppr/

Live URL: Sign in to create an API key

Variables for Auction Values

Service-Name: auction

Format: xml or json

{ppr}: Example: ppr (PPR Indicator. 1 for yes, 0 or empty for no)

Draft Rankings

Get a list of draft rankings (Both PPR and Standard)

You will need to pass along a "1" for PPR or leave empty (or zero) for standard rankings

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{ppr}/

Test URL: http://www.fantasyfootballnerd.com/service/draft-rankings/xml/test/1/

Live URL: Sign in to create an API key

Variables for Draft Rankings

Service-Name: draft-rankings

Format: xml or json

{ppr}: Example: 1 (PPR Indicator. 1 for yes, 0 or empty for no)

Draft Projections

Get draft projections for the 2016 NFL season

You will need to request a specific position: QB, RB, WR, TE, DEF, K

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{position}/

Test URL: http://www.fantasyfootballnerd.com/service/draft-projections/xml/test/QB/

Live URL: Sign in to create an API key

Variables for Draft Projections

Service-Name: draft-projections

Format: xml or json

{position}: Example: QB (position to retrieve)

Fantasy Football Tiers

Tiers are peer-grouped listings of players. Useful for conducting value-based drafting.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/tiers/xml/test/

Live URL: Sign in to create an API key

Variables for Fantasy Football Tiers

Service-Name: tiers

Format: xml or json

IDP Draft Rankings

Get IDP draft rankings for the 2016 NFL season

This will provide draft rankings for IDP players

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/draft-idp/xml/test/

Live URL: Sign in to create an API key

Variables for IDP Draft Rankings

Service-Name: draft-idp

Format: xml or json

Dynasty Rankings

Retrieve 2016 dynasty rankings

This will provide dynasty rankings for dynasty drafts

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/dynasty/xml/test/

Live URL: Sign in to create an API key

Variables for Dynasty Rankings

Service-Name: dynasty

Format: xml or json

Weekly Rankings

Get the weekly rankings (Both PPR and Standard)

You will need to request a specific position: QB, RB, WR, TE, K, DEF. You will also need to send along the specific week number (1-17) you'd like as well. You can optionally send along a "1" if you'd like PPR results returned.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{position}/{week}/{ppr}/

Test URL: http://www.fantasyfootballnerd.com/service/weekly-rankings/xml/test/QB/2/1/

Live URL: Sign in to create an API key

Variables for Weekly Rankings

Service-Name: weekly-rankings

Format: xml or json

{position}: Example: QB (position to retrieve)

{week}: Example: 2 (The week *1-17* to retrieve. Leave empty for the current week.)

{ppr}: Example: 1 (PPR Indicator. 1 for yes, 0 or empty for no)

Weekly Projections

Get the weekly projections for each player

You will need to request a specific position: QB, RB, WR, TE, K, DEF. Additionally, you can optionally request a specific week number (1-17). If you don't request a specific week, the current week will be returned.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{position}/{week}/

Test URL: http://www.fantasyfootballnerd.com/service/weekly-projections/xml/test/QB/1/

Live URL: Sign in to create an API key

Variables for Weekly Projections

Service-Name: weekly-projections

Format: xml or json

{position}: Example: QB (position to retrieve)

{week}: Example: 1 (The week *1-17* to retrieve. Leave empty for the current week.)

Weekly IDP Rankings

Get the Individual Defensive Player (IDP) rankings for the current week

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/weekly-idp/xml/test/

Live URL: Sign in to create an API key

Variables for Weekly IDP Rankings

Service-Name: weekly-idp

Format: xml or json

Injuries

Retrieve the injury reports for each team

You can pass along a week number (1-17) to retrieve injuries for a specific week. Leave blank to retrieve injuries for the current week.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{week}/

Test URL: http://www.fantasyfootballnerd.com/service/injuries/xml/test/1/

Live URL: Sign in to create an API key

Variables for Injuries

Service-Name: injuries

Format: xml or json

{week}: Example: 1 (The week *1-17* to retrieve. Leave empty for the current week.)

Depth Charts

Get the depth charts for each team

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/depth-charts/xml/test/

Live URL: Sign in to create an API key

Variables for Depth Charts

Service-Name: depth-charts

Format: xml or json

NFL Picks

Get the NFL game picks for each game broken down by expert.

Perfect for Pickem leagues

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/nfl-picks/xml/test/

Live URL: Sign in to create an API key

Variables for NFL Picks

Service-Name: nfl-picks

Format: xml or json

Defensive Rankings

Get the defensive rankings for each team

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/

Test URL: http://www.fantasyfootballnerd.com/service/defense-rankings/xml/test/

Live URL: Sign in to create an API key

Variables for Defensive Rankings

Service-Name: defense-rankings

Format: xml or json

Game Day Inactives

Get the list of game day inactives for key players

You can pass along a week number (1-17) to retrieve a specific week. Leave blank to retrieve game day inactives for the current week.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{week}/

Test URL: http://www.fantasyfootballnerd.com/service/inactives/xml/test/1/

Live URL: Sign in to create an API key

Variables for Game Day Inactives

Service-Name: inactives

Format: xml or json

{week}: Example: 1 (The week *1-17* to retrieve. Leave empty for the current week.)

Player Stats & Info

Get the historical stats and info for each player. Player stats are updated weekly each Tuesday at 1:00 pm ET.

You will need to pass along the playerId of the player you want to retrieve.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{playerId}/

Test URL: http://www.fantasyfootballnerd.com/service/player/xml/test/13/

Live URL: Sign in to create an API key

Variables for Player Stats & Info

Service-Name: player

Format: xml or json

{playerId}: Example: 13 (playerId of the player to retrieve)

Daily Fantasy Football

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

Specify the platform to retrieve data for. Options: fanduel, draftkings, or yahoo.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{platform}/

Test URL: http://www.fantasyfootballnerd.com/service/daily/xml/test/fanduel/

Live URL: Sign in to create an API key

Variables for Daily Fantasy Football

Service-Name: daily

Format: xml or json

{platform}: Example: fanduel (The platform you want to retrieve: fanduel, draftkings, or yahoo)

NFL Playoff Projections New

Retrieve NFL playoff projections for each team that plays from wildcard to Super Bowl.

Specify the round of the playoffs and the position. Example: Round 1 is the Wild Card, Round 2 is the Divisional Round, Round 3 is the Conference Championships, and Round 4 is the Super Bowl. Available positions are: QB, RB, WR, TE, K.

URL Structure: /service/{SERVICE-NAME}/{FORMAT}/{API-KEY}/{round}/{position}/

Test URL: http://www.fantasyfootballnerd.com/service/playoffs/xml/test/1/QB/

Live URL: Sign in to create an API key

Variables for NFL Playoff Projections

Service-Name: playoffs

Format: xml or json

{round}: Example: 1 ()

{position}: Example: QB (position to retrieve)