• How To
    • Win Your DFS League
    • Win Your Auction Draft
    • Win Your Snake Draft
    • Download Projections
    • Scrape Projections
    • Calculate Projections for Your League
    • Examine Accuracy of Projections
    • Identify Sleepers
    • Save Custom Settings
    • Use the API
  • Strategy
    • Fantasy Football is Like Stock Picking
    • Use Projections, Not Rankings
  • Projections
    • Our Projections
    • Who has the Best Seasonal Projections?
    • Who has the Best DFS Projections?
    • Draft the Best Starting Lineup
    • Projections are More Accurate than Rankings
    • Points by Position Rank
    • Players’ Risk Levels
    • Value Over Replacement
    • Bid-Up-To Value
    • Player Value Gap
    • Gold Mining
    • Weekly Variability
    • Are Subscription Sources More Accurate?
  • Statistics
    • How To Learn R
    • R is Better than Excel
    • Do Stats Help in Fantasy Football?
    • Download/Run Our Scripts
    • ffanalytics R Package
  • Apps
    • Auction Draft Optimizer
    • Snake Draft Optimizer
    • Weekly Lineup Optimizer
    • Rankings/Projections for Your League
    • API
    • Other Tools
      • Stock Analysis
    • Error Logging
  • Testimonials
  • About the Site
    • About
    • Authors
      • Isaac Petersen
    • FAQ
    • FFA Insider
    • Privacy Policy
    • Terms of Service
  • Donate

Fantasy Football Analytics

Fantasy Football Analytics API

The FFA API gives developers programmatic access to the same projection data behind our draft and daily fantasy tools, returned as JSON. Seasonal projections go back to 2008, weekly projections to 2015, and ADP to 2015. If you are building a product that needs consensus projections across every fantasy-relevant position, including IDP, this is the fastest way to get them.

The API is intended for commercial use. If you want our data for your own league, you probably want FFA Insider or the ffanalytics R package instead.

What Products Are Available?

We publish our projections through three products. If you are building software that other people will use, you want the API. If you want projections for your own leagues, use the web apps. If you want to run your own analysis in R, use the ffanalytics package. Only the API is licensed for commercial use.

 APIWeb apps & FFA Insiderffanalytics R package
Who is it forDevelopers building productsPlaying your own leaguesYour own analysis in R
How you get dataHTTP GET, JSONIn the browserR function calls
Our stored projectionsSeasonal from 2008, weekly from 2015, ADP from 2015Current season in the apps; Insider adds historical projection downloads and historical accuracy toolsNone — the package scrapes sources live and aggregates them on your machine
Commercial useYesNoPackage is GPL; the data belongs to the sites it scrapes
Price$1,000–$1,500 per seasonFree, or $5.99/month for FFA InsiderFree

Pricing and Plans

We offer two plans. Basic covers season-long projections for the current season, the full historical archive of both season-long and weekly projections, and ADP. Premier adds weekly projections for the season currently in progress.

 Basic — $1,000Premier — $1,500
Seasonal projections, all seasons including currentIncludedIncluded
Weekly projections, all prior seasonsIncludedIncluded
Weekly projections, current seasonNot includedIncluded
ADP, all seasons including currentIncludedIncluded
All positions including IDPIncludedIncluded

Getting an API Key

Email sales@fantasyfootballanalytics.net to subscribe. We issue keys manually and send them by email.

Making Requests

Every request is a plain HTTP GET against the base URL, with your key in the Authorization header and options passed as query parameters.

https://api.fantasyfootballanalytics.net/FFA_API/{endpoint}

There are two endpoints:

EndpointReturns
projAveraged projections for a position, season, and week
adpAverage draft position for a season and league type

Authentication

Pass your key in the Authorization header:

Authorization: Basic YOUR_API_KEY

Note that despite the Basic prefix, this is not standard HTTP Basic authentication. Send your key exactly as we issued it, with no base64 encoding and no username-colon-password pair.

The proj Endpoint

ParameterValuesDefaultNotes
posqb, rb, wr, te, k, dst, dl, lb, dbqbReturned fields vary by position. See the field reference below.
season2008 through the current seasonCurrent seasonWeekly projections are only available from 2015 forward.
week0 through 2100 returns seasonal projections. Any other value returns that week.
typeaverage, robust, weightaverageSee averaging methods below.

Averaging methods

We aggregate projections from multiple sources rather than publishing a single forecast of our own. The type parameter controls how that aggregation is done. average is a simple mean across sources. robust is resistant to outliers, which matters when one source carries an unusual number on a player. weight weights each source by its historical accuracy.

One quirk worth knowing: you request type=weight, but the avg_type field in the response comes back as weighted. The request value and the response value are not identical strings.

The adp Endpoint

ParameterValuesDefault
season2015 through the current seasonCurrent season
typestd, pprstd

ADP is included in both subscription tiers for all seasons, including the season in progress.

{
  "source": "AVG",
  "adp": 17.2,
  "league_type": "std",
  "player": "Josh Allen",
  "position": "QB",
  "team": "BUF"
}

Response Format

Responses are JSON. Empty and null values are omitted entirely rather than returned as null, following Google’s JSON style guide, so write your parser to tolerate missing keys on any given record.

Every proj record carries player, position, team, and avg_type. The statistical fields returned depend on the position you requested, so a parser written against quarterbacks will not read kickers without changes. The field reference below shows a real record for each position.

Projections are returned as unrounded decimals. A running back projected for 11.7953 rushing touchdowns is an aggregate across sources, not a prediction of a fractional score, and you should round or format for display as your own product requires.

Draft and schedule fields

Alongside the projected stats, records can include a player’s bye week, average auction value, and average draft position. These fields are only present when we have a value, which for some positions is the exception rather than the rule.

FieldPositionsDescription
bye_weekAllThe player’s bye week. Usually missing only for players without a team.
aav_avgAllAverage auction value across sources, in auction dollars. Present for most fantasy-relevant players and a minority of IDP players.
adp_avgAll except DBAverage draft position across sources. Present for most offensive players, kickers, and defenses, but only for a handful of DL and LB, and never for DB. For per-source ADP or a specific league type, use the adp endpoint.

Field Reference by Position

Each example below is an actual record returned by the proj endpoint for 2025 seasonal projections using the weighted average.

Quarterbacks

{
  "player": "Joe Burrow",
  "position": "QB",
  "team": "CIN",
  "pass_att": 611.1674,
  "pass_comp": 423.3832,
  "pass_inc": 190.2021,
  "pass_yds": 4631.1032,
  "pass_tds": 37.4674,
  "pass_int": 10.5256,
  "rush_att": 48.2778,
  "rush_yds": 187.8464,
  "rush_tds": 2.0336,
  "fumbles": 3.773,
  "sacks": 51.2,
  "bye_week": 10,
  "aav_avg": 24.478,
  "adp_avg": 29.3343,
  "avg_type": "weighted"
}

Running backs

{
  "player": "Saquon Barkley",
  "position": "RB",
  "team": "PHI",
  "rush_att": 329.4944,
  "rush_yds": 1668.3105,
  "rush_tds": 11.7953,
  "rec": 41.2874,
  "rec_yds": 313.4941,
  "rec_tds": 2.0499,
  "fumbles": 1.3153,
  "bye_week": 9,
  "aav_avg": 59.495,
  "adp_avg": 3.4614,
  "avg_type": "weighted"
}

Wide receivers

{
  "player": "Justin Jefferson",
  "position": "WR",
  "team": "MIN",
  "rec": 105.9342,
  "rec_yds": 1492.7929,
  "rec_tds": 9.8419,
  "rush_att": 0.4955,
  "rush_yds": 1.2895,
  "rush_tds": 0.0,
  "fumbles": 0.3761,
  "bye_week": 6,
  "aav_avg": 54.3335,
  "adp_avg": 7.0157,
  "avg_type": "weighted"
}

Tight ends

{
  "player": "Brock Bowers",
  "position": "TE",
  "team": "LVR",
  "rec": 106.6831,
  "rec_yds": 1141.2629,
  "rec_tds": 6.111,
  "rush_att": 3.7586,
  "rush_yds": 12.6988,
  "rush_tds": 0.0,
  "fumbles": 0.3595,
  "bye_week": 8,
  "aav_avg": 32.91,
  "adp_avg": 27.8557,
  "avg_type": "weighted"
}

Kickers

Field goals are broken out by distance, which lets you apply distance-tiered scoring without approximating.

{
  "player": "Jake Bates",
  "position": "K",
  "team": "DET",
  "fg_att": 30.302,
  "fg_miss": 3.4915,
  "fg": 26.8105,
  "fg_0019": 0.1079,
  "fg_2029": 4.9619,
  "fg_3039": 9.2345,
  "fg_4049": 6.9984,
  "fg_50": 5.048,
  "xp": 52.0102,
  "bye_week": 8,
  "aav_avg": 2.248,
  "adp_avg": 130.39,
  "avg_type": "weighted"
}

Team defense

{
  "player": "Cowboys",
  "position": "DST",
  "team": "DAL",
  "dst_int": 11.1403,
  "dst_sack": 46.6124,
  "dst_safety": 0.0,
  "dst_td": 2.8896,
  "dst_pts_allow": 455.7108,
  "bye_week": 10,
  "aav_avg": 0.65,
  "adp_avg": 155.822,
  "avg_type": "weighted"
}

Note that dst_pts_allow is a season total, not a per-game average, and that the player field carries the team nickname only, with no city.

Defensive linemen

{
  "player": "Maxx Crosby",
  "position": "DL",
  "team": "LVR",
  "idp_solo": 56.144,
  "idp_sack": 11,
  "idp_int": 0.0,
  "idp_pd": 4.6648,
  "idp_td": 0.0,
  "bye_week": 8,
  "aav_avg": 17.184,
  "avg_type": "weighted",
  "adp_avg": 96.23
}

Linebackers

This record has no adp_avg because few linebackers are drafted often enough to have one.

{
  "player": "Zaire Franklin",
  "position": "LB",
  "team": "IND",
  "idp_solo": 110.2214,
  "idp_sack": 1,
  "idp_int": 1.0948,
  "idp_pd": 5.905,
  "idp_td": 0.0,
  "bye_week": 11,
  "aav_avg": 17.064,
  "avg_type": "weighted"
}

Defensive backs

Defensive backs never carry adp_avg.

{
  "player": "Budda Baker",
  "position": "DB",
  "team": "ARI",
  "idp_solo": 105.2819,
  "idp_sack": 1,
  "idp_int": 1.0651,
  "idp_pd": 3.5224,
  "idp_td": 0.0,
  "bye_week": 8,
  "aav_avg": 9.648,
  "avg_type": "weighted"
}

Code examples

All three examples request weighted seasonal projections for running backs.

curl

curl -H "Authorization: Basic YOUR_API_KEY" \
  "https://api.fantasyfootballanalytics.net/FFA_API/proj?pos=rb&season=2025&week=0&type=weight"

Python

import requests

BASE = "https://api.fantasyfootballanalytics.net/FFA_API"
KEY  = "YOUR_API_KEY"

resp = requests.get(
    f"{BASE}/proj",
    headers={"Authorization": f"Basic {KEY}"},
    params={"pos": "rb", "season": 2025, "week": 0, "type": "weight"},
    timeout=30,
)
resp.raise_for_status()
players = resp.json()

for p in players[:5]:
    print(p["player"], p.get("rush_yds"), p.get("rec_yds"))

R

library(httr)
library(jsonlite)

base_url <- "https://api.fantasyfootballanalytics.net/FFA_API"
api_key  <- Sys.getenv("FFA_API_KEY")

res <- GET(
  paste0(base_url, "/proj"),
  add_headers(Authorization = paste("Basic", api_key)),
  query = list(pos = "rb", season = 2025, week = 0, type = "weight")
)

stop_for_status(res)
df <- fromJSON(content(res, as = "text", encoding = "UTF-8"))
head(df)

Reading the key from an environment variable rather than hardcoding it keeps it out of your repository.

Terms of use

What you may do: display projections in your product, cache them temporarily for performance, and use them in calculations and models you ship commercially, for as long as your subscription is active.

What you must do: display “Powered by Fantasy Football Analytics,” linked to our site, wherever the data appears.

What you may not do: redistribute raw data as a data feed, sublicense it, or continue using it after your subscription ends.

Use of the API is governed by our Terms of Service.

Questions

Email sales@fantasyfootballanalytics.net for pricing and subscriptions, or with technical questions about the API.

Share this:

  • Share on X (Opens in new window) X
  • Share on Facebook (Opens in new window) Facebook
  • Share on Reddit (Opens in new window) Reddit
  • Email a link to a friend (Opens in new window) Email

Like this:

Like Loading…
  • Tabs

    • Most Popular
    • Recent Posts
    • The ffanalytics R Package for Fantasy Football Data AnalysisJune 18, 2016
    • 2015 Fantasy Football Projections using OpenCPUMay 28, 2015
    • Win Your Fantasy Football Auction Draft: Determine the Optimal Players to Draft with this AppJune 14, 2013
    • Win Your Fantasy Football Snake Draft with this AppSeptember 1, 2013
    • Fantasy Football Weekly Cheat Sheet: Week 10 (2026)November 14, 2026
    • Mid-Season Storyline Report 2026November 12, 2026
    • Fantasy Football Weekly Cheat Sheet: Week 8 (2026)October 29, 2026
    • Through Week 5: How DFS Projections Are Holding Up in 2026October 25, 2026
  • FFA Insider

    Logo
  • Categories

    • About the Authors
    • Articles
    • Articles
    • Auction Drafts
    • Draft Optimizer
    • FFA Insider
    • Gold Mining
    • How To
    • In the Media
    • Luck
    • Package
    • Projections
    • R
    • Risk
    • Theory
    • Tools
    • Trade Strategy
    • Uncategorized
    • Weekly
  • Facebook

  • Twitter

  • Our Partners

    R-bloggers

  • Support us building things... Even a cup of coffee ($1.99) helps us stay awake!

  • Subscribe to the Fantasy Football Analytics mailing list (no spam).
    Loading

        © Fantasy Football Analytics

        %d