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.
| API | Web apps & FFA Insider | ffanalytics R package | |
|---|---|---|---|
| Who is it for | Developers building products | Playing your own leagues | Your own analysis in R |
| How you get data | HTTP GET, JSON | In the browser | R function calls |
| Our stored projections | Seasonal from 2008, weekly from 2015, ADP from 2015 | Current season in the apps; Insider adds historical projection downloads and historical accuracy tools | None — the package scrapes sources live and aggregates them on your machine |
| Commercial use | Yes | No | Package is GPL; the data belongs to the sites it scrapes |
| Price | $1,000–$1,500 per season | Free, or $5.99/month for FFA Insider | Free |
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,000 | Premier — $1,500 | |
|---|---|---|
| Seasonal projections, all seasons including current | Included | Included |
| Weekly projections, all prior seasons | Included | Included |
| Weekly projections, current season | Not included | Included |
| ADP, all seasons including current | Included | Included |
| All positions including IDP | Included | Included |
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:
| Endpoint | Returns |
|---|---|
proj | Averaged projections for a position, season, and week |
adp | Average 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
| Parameter | Values | Default | Notes |
|---|---|---|---|
pos | qb, rb, wr, te, k, dst, dl, lb, db | qb | Returned fields vary by position. See the field reference below. |
season | 2008 through the current season | Current season | Weekly projections are only available from 2015 forward. |
week | 0 through 21 | 0 | 0 returns seasonal projections. Any other value returns that week. |
type | average, robust, weight | average | See 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
| Parameter | Values | Default |
|---|---|---|
season | 2015 through the current season | Current season |
type | std, ppr | std |
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.
| Field | Positions | Description |
|---|---|---|
bye_week | All | The player’s bye week. Usually missing only for players without a team. |
aav_avg | All | Average auction value across sources, in auction dollars. Present for most fantasy-relevant players and a minority of IDP players. |
adp_avg | All except DB | Average 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.








