Fantasy Football Nerd API

This is a Ruby Gem for the Fantasy Football Nerd API.

Fantasy Football Nerd "takes the 'wisdom of the crowd' to a new level by aggregating the fantasy football rankings of the best fantasy football sites... and weighting the rankings based upon past accuracy."

Fantasy Football Nerd provides an API with access to this fantasy football data:

Players List
Player Details (including recent articles)
Weekly Projections
Injury Reports
Preseason Draft Rankings (not currently supported)
Season Schedule (not currently supported)

Full API access costs $9 for a season subsciption, though if you are a developer with a modicum of interest in Fantasy Football, this is the best $9 you will spend all season.

Cache your data!

Take heed to the warning on the Fantasy Football Nerd API page:

The data does not generally change more than once or twice per day, so it becomes unnecessary to continually make the same calls. Please store the results locally and reference the cached responses... Your account may be suspended or API access revoked if you are found to be making excessive data calls.

Seriously, FFN is not a big operation. Don't abuse their servers.

Setup

In Ruby, install the gem:

    gem install fantasy_football_nerd

And require it:

require 'rubygems'
require 'fantasy_football_nerd'

In Rails, add the gem to your gemfile and run bundle install

gem 'fantasy_football_nerd'

Set your api_key before before making any call. You can find it on the FFN api page.

FFNerd.api_key = 123456789

API Resources

Currently, this gem provides access to four feeds:

Player List
Player Detail
Weekly Projections
Injuries

Player List

Returns an array of players:

players = FFNerd.player_list
player = players.first
player.player_id
player.name
player.position
player.team

Player Detail

Returns a single player with a nested array of articles:

player = FFNerd.player_detail(player_id)
player.id
player.first_name
player.last_name
player.team
player.position
article = player.articles.first
article.title
article.source
article.published

Projections

Returns an array of players, each with a nested projection:

projections = FFNerd.projections(week)
player = projections.first
player.id
player.name
player.team
player.position
player.rank
player.projected_points #equivalent to player.projection.standard
player.projection.week
player.projection.standard
player.projection.standard_low
player.projection.standard_high
player.projection.ppr
player.projection.ppr_low
player.projection.ppr_high

Injuries

Returns an array of players, each with a nested injury:

injuries = FFNerd.injuries(week)
player = injuries.first
player.id
player.name
player.team
player.position
player.injury.week
player.injury.injury_desc
player.injury.practice_status_desc
player.injury.game_status_desc
player.injury.last_update

Projections to CSV

Returns a string of player projections that can be written to a CSV. Does not do the writing of the CSV itself - you need to handle that. But the string is all ready for you.

If you do not pass a week parameter, it will assume the current week.

week = 2
output = FFNerd.projections_to_csv(week)

Current Week

Returns the current NFL week. Currently only set to work for the first 16 weeks of the 2012 season.

FFNerd.current_week

Still To Come

Better error reporting
Schedule

Tests

The gem includes extensive RSpec tests.

Contributors

Greg Baugues (greg@baugues.com) www.baugues.com

kelmerp/fantasy_football_nerd