const response = await fetch(
'https://www.autodrafters.com/api/v2/rankings/redraft?scoring=ppr&qb=superflex&limit=10'
);
if (!response.ok) throw new Error('API returned ' + response.status);
const { data, meta, pagination, links } = await response.json();
console.log(meta.modelVersion, data[0].name, data[0].adValue);
Cross-origin requests are supported. Version 2 serves redraft only: /rankings/dynasty returns 404 mode_unavailable, because AD Value is a redraft rest-of-season value.
Try it live.
GET /api/v2/rankings/redraft?scoring=ppr&qb=1qb&limit=3
Run a live request to see the response.
Choose your board.
Parameter
Values
Default
scoring
ppr, half, standard
ppr
qb
1qb, superflex
1qb
position
QB, RB, WR, TE
All positions
q
Player name search, up to 80 characters
All players
limit
1–300
100
offset
0–300
0
revision
Revision from a previous response
Latest values
Each format is a 12-team league with QB, 2 RB, 3 WR, TE and FLEX starters (plus a Superflex slot for qb=superflex) and 5 bench spots; meta.format spells it out. Every player with a positive AD Value is listed in rank order. Filtering preserves original ranks. Follow links.next to paginate within the same revision. If the values change, a 409 response tells you to restart pagination. Unknown and repeated query parameters return 400, including horizon: version 2 values are always rest-of-season.
Know what the numbers mean.
AD Value is calculated by AutoDrafters from licensed rest-of-season projections and our roster model.
AD Value measures how many lineup points a league loses without a player once every roster re-optimizes, week by week, for the rest of the fantasy season.
Starters count fully and bench depth counts 25%. Bye weeks are included. Injured players with a reported return estimate are valued from their expected return; values are withheld when injury return timing is unknown.
A scoring-rate guard limits extreme increases caused by dividing a forecast over very few games after an estimated return.
The most valuable player in the format is 100. 0 means at or below replacement level.
Each AD Value measures one player at a time. In a trade package the best player carries extra weight, as trade markets do, so a package is worth less than the sum of its players’ values.
It is our model’s estimate, not a market price. Compare it with other rankings and use your judgment.
adValue is rounded to two decimals, and a positive value never rounds below 0.01. Players at or below replacement level and players without a value are not listed; meta.coverage counts them. Values are comparable only within one format and revision.
meta.window gives the NFL weeks credited and meta.notes explains the format, injuries and any data limits. meta.capturedAt is when these inputs were first captured and meta.inputsAsOf when they were last confirmed. When an update is delayed, meta.stale is true and the most recent values are served. Values last confirmed more than 36 hours ago are not served: the API returns 503 with Retry-After until an update arrives. Data is revalidated every five minutes.
Player IDs are stable published identifiers, usually NFL GSIS IDs, with sleeperId alongside. Treat them as opaque strings. Please include a link to AutoDrafters when displaying AD Values. Attribution is included in every response.
A fair request limit.
You can make 60 ranking requests per minute per IP, shared across formats. GET, HEAD, invalid ranking queries and conditional requests count. OPTIONS and the specifications do not. People sharing an IP share its limit.
Read X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds). A 429 response includes Retry-After in seconds. Cache results in your application; send the returned ETag as If-None-Match to receive 304 when the page is unchanged. Minute boundaries are fixed, not a rolling window.
Errors return { error: { code, message }, docs }. A temporary 503 includes a retry delay; a 422 means AD Values are not available here (not_configured) or the regular season is complete (season_complete), and retrying will not help. Values come from the latest saved inputs, which refresh in the background about every 15 minutes; a request never waits on a data refresh.
API changes.
v1 1.1.0 · Removed ·
Version 1 was retired on Oct 8, 2026, ahead of its announced Apr 5, 2027 sunset; use version 2.
Every /api/v1 request, including /api/v1/openapi.json, now returns 410 Gone with a Sunset header and a successor-version link to version 2.
Version 2 serves AD Value for redraft. It has no dynasty board, projected points or projection detail.
v2 2.0.0 · Changed ·
Players out for the season are valued at 0.
A player on injured reserve with a season-ending injury and no return estimate is now valued at 0 (counted at or below replacement in meta.coverage) instead of being withheld for unknown return timing.
The package note in meta.notes now says a trade package counts its best player most. Other values and ranks are unchanged.
v2 2.0.0 · Changed ·
Superflex boards price elite QBs as scarce.
In Superflex formats, QBs above the last QB1 (the 12th QB on public boards) are priced above their weekly lineup edge, the way Superflex trades price scarce QBs. On the PPR board, Josh Allen moved from 82.2 (#4) to 100 (#1).
1QB boards are unchanged. Values below the QB1 line keep their lineup value. meta.modelVersion is ad-value-2026.6.
v2 2.0.0 · Changed ·
AD Value prices the first-round tier as a tier.
Values of the top players (one per team in the format: 12 on public boards) move closer to 100, the way a fantasy first round is priced. On the PPR 1QB board, the second-best player moved from 81.7 to about 92.6.
The top player is still 100, order and ranks are unchanged, and every value below the tier is unchanged. meta.modelVersion is ad-value-2026.5.
v1 1.1.0 · Changed ·
horizon=remaining no longer reads reported injury-return dates.
Since Sep 17, 2026, remaining-season boards valued some injured-reserve and PUP players from return dates in a public injury report. Version 1 no longer reads that report.
Those players are ranked only with a reviewed return estimate; otherwise they are left out of data and counted in meta.unavailablePlayers.
The response format and the meaning of value are unchanged. AD Value (version 2) accounts for injury returns.
v2 2.0.0 · Added ·
AD Value added (AutoDrafters model, redraft rest-of-season, 1QB and Superflex, PPR/half/standard).
GET /api/v2/rankings/redraft lists every player with a positive AD Value in a 12-team format, ranked, with adValue on a scale where the most valuable player is 100.
Version 2 serves values only: no projected points, projection detail or injury return estimates. Dynasty returns 404 mode_unavailable.
Both versions share one request limit of 60 ranking requests per minute per IP.
v1 1.1.0 · Fixed ·
Restored the original meaning.
From Oct 1 to Oct 5, 2026, horizon=remaining and dynasty responses served different values (trade_value, consensus ranks) without a version change. That was a mistake; v1 again matches its original contract.
During that period, player-identity aliases added Oct 1 (Kenneth Gainwell, Chig Okonkwo and Joshua Palmer) also changed which players appeared on those v1 boards.
Version 1 again serves only published boards: value is points above the last starter for redraft (valueMetric points_above_starter) and dynasty value for dynasty (dynasty_value), with the original attribution.
Redraft qb=superflex returns 400 unsupported_format again, for both horizons.
meta.rankingBasis, meta.valueCoverage, meta.retrievedAt, meta.notes and the per-player rankingBasis are no longer emitted.
v1 1.1.0 · Deprecated ·
Version 1 is deprecated. It stops responding on Apr 5, 2027 (sunset); use version 2.
Every v1 response carries Deprecation, Sunset and Link (rel="successor-version", rel="deprecation") headers.
Version 1 receives no new data sources. AD Value is available only in version 2.