Fantasy Football Nerd

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 the same complete 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: $249 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 2015 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
Injuries Retrieve the injury reports for each team 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 2015 NFL season 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
Depth Charts Get the depth charts for each team -- Check 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 -- -- 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.

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

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.)

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 2015 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)

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.)

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

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

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

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)