NFL forecasts for your product
Retrieve the same pregame stat estimates and ranges shown on our NFL projection boards. One request returns a day’s players with stable game and player IDs.
Get access
Request an NFL licence with your product, intended use, expected volume, and launch date. We agree coverage, usage allowance, payment terms, and expiry, then issue a private API key. Commercial access is separate from a consumer subscription.
Request NFL API accessA working integration
# Keep the key in your server environment, never browser code. curl https://api.thelineup.pro/api/v1/nfl/games \ -H "X-Api-Key: $LINEUP_API_KEY" # Use a date returned by /games. curl "https://api.thelineup.pro/api/v1/nfl/forecasts?date=YYYY-MM-DD" \ -H "X-Api-Key: $LINEUP_API_KEY" curl https://api.thelineup.pro/api/v1/nfl/account \ -H "X-Api-Key: $LINEUP_API_KEY"
Optional game_id and player_id filters narrow the forecasts response. IDs returned by the feed work directly; custom identifier mapping is optional.
What you receive
Passing yards, passing touchdowns, completions, rushing yards and touchdowns, receiving yards and touchdowns, receptions, targets, and PPR fantasy points. Supported statistics depend on position.
Each available player includes a forecast ID, model version, generation timestamp, point estimates, lower and upper ranges, and availability status. Values come from the same stored forecasts as the board.
Ranges target 80% historical coverage. On the held-out 2025 season, coverage across supported position/stat groups was 77.7–84.8%. This is historical evidence, not a guarantee for an individual player. These statistical forecasts do not include over/under probabilities, betting EV, confirmed starting roles, or playing-time guarantees.
Refresh and missing data
The schedule covers today and the next six days in Eastern time. Forecasts refresh daily at 6:30 a.m. Eastern. Games already started are excluded. Forecasts older than 28 hours are returned as unavailable, with no stale values substituted.
Active backups may appear. A player without an eligible forecast is explicitly unavailable; this can reflect injury exclusion, fewer than two historical games, or pending generation. Missing forecasts are never represented as zero.
Usage and operations
Each successful HTTP request to games or forecasts consumes one request, including empty results. Account checks and failed HTTP requests do not. There is no per-player charge in this package. Allowances reset at midnight UTC; your agreement sets the daily allowance and licence price. Automated payment collection and overage charges are not part of this access flow.
Use the account endpoint to check expiry and usage, even after reaching your allowance. A revoked or expired key receives 401; exhausted allowances receive 429; unsupported date windows receive 422; service failures receive 503. Retry 503 responses with backoff. Keep credentials server-side and request replacement if compromised.