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.

PLEASE NOTE: This is the new version of the FFN API and requires a new API key. The old version is deprecated and will no longer be supported.

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 2014 NFL Schedule Check Check Check
NFL Players Get a list of all active 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
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 2014 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
Defensive Rankings Get the defensive rankings for each team -- -- Check
Depth Charts Get the depth charts 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 {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

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.

All service calls are documented below.

NFL Teams
Levels: 1, 2, 3

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

Service Name: nfl-teams

Format: xml or json

NFL Schedule
Levels: 1, 2, 3

Retrieve the 2014 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

Service Name: schedule

Format: xml or json

NFL Players
Levels: 1, 2, 3

Get a list of all active fantasy players from FFN

You can optionally request a specific position: QB, RB, WR, TE, K, DEF. Leave the position parameter empty to retrieve all 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

Service Name: players

Format: xml or json

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

Bye Weeks
Levels: 1, 2, 3

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

Service Name: byes

Format: xml or json

Injuries
Levels: 1, 2, 3

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

Service Name: injuries

Format: xml or json

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

Auction Values
Levels: 2, 3

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

Service Name: auction

Format: xml or json

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

Draft Rankings
Levels: 2, 3

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

Service Name: draft-rankings

Format: xml or json

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

Draft Projections
Levels: 2, 3

Get draft projections for the 2014 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

Service Name: draft-projections

Format: xml or json

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

Weekly Rankings
Levels: 2, 3

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

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
Levels: 2, 3

Get the weekly projections for each player

You will need to request a specific position: QB, RB, WR, TE, K. 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

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

Defensive Rankings
Levels: 3

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

Service Name: defense-rankings

Format: xml or json

Depth Charts
Levels: 3

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

Service Name: depth-charts

Format: xml or json

Game Day Inactives
Levels: 3

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

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
Levels: 3

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

Service Name: player

Format: xml or json

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

Visit us on FacebookVisit us on TwitterFantasy Football RSS

About Fantasy Football Nerd
About the Nerd NerdRank Terms and Conditions Privacy Policy Contact Us Media Inquiries FFN is Green! Experts League for Charity

Fantasy Football Nerd Features
My Account Draft Buddy Lineup Analyzer NFL News NFL Injury Report Fantasy Football Affiliate Program

Fantasy Football Extras
Fantasy Football API Daily Fantasy Football Games FFN Labs Fantasy Football Resources Spoofmercials

Other TayTech Properties
HollyStock.com Weatherific.com MyTravelToolbox.com IveWatchedIt.com Stranger Dare