NFL Player Props API
Real-time NFL game lines, full player-prop coverage when the season opens, and automatic prop resolution against actual stats. Drop-in compatible with the-odds-api — switching is a base URL change.
No credit card. 1,000 requests / day on the free tier.
What you get for the NFL
Right now (preseason & offseason): game lines — moneylines (h2h), point spreads, totals (O/U), alt spreads, alt totals, and team totals across every scheduled NFL game from the full 16-book lineup — 11 sportsbooks/DFS + 5 exchanges. Final scores and box scores stream in within minutes of game-end via our /scores and /stats endpoints.
When the regular season opens (September 2026): full player-prop coverage activates — pass yards, pass TDs, rush yards, rush attempts, receptions, receiving yards, anytime TD scorer, and more. Every Over / Under graded against actual stats from the NFL’s public data feeds within minutes of game-end. The scaffolding is wired and tested today; the lines are simply unavailable while teams aren’t playing.
NFL markets we cover
Game lines (live year-round)
Pre-game and live odds across every NFL matchup, refreshed every 60 seconds (30s for in-progress games).
Quarterback player props (September 2026)
Per-game QB markets for every starter. Resolved against the NFL’s public passing stats.
Rushing & receiving props (September 2026)
Skill-position markets across RBs, WRs, TEs. Includes anytime touchdown for every offensive player projected to play.
Defensive & kicking props (September 2026)
Niche markets that other APIs charge premium credits for. Included in the standard player-prop response.
Prop resolution — did the bet win?
PropLine is the only NFL props API that grades every prop bet for you. After each game, we cross-reference the actual stats from the NFL’s public data feeds against every recorded prop line and return won / lost / push per outcome with the actual stat value.
Build CLV trackers, run prop-betting model backtests, ship a Sunday results dashboard, or just stop scraping box scores on Monday morning — all from one endpoint. The-odds-api stops at odds.
{
"key": "player_pass_yds",
"description": "Pass Yards - Patrick Mahomes",
"outcomes": [
{
"name": "Over",
"description": "Patrick Mahomes",
"point": 274.5,
"resolution": "won",
"actual_value": 291.0
}
]
}Prop resolution is available starting on the Hobby tier ($9/mo) via the /results endpoint. Free tier returns the structure with a 403 and an upgrade pointer.
Cross-book +EV with no-vig fair lines
For every (market, player, line) tuple on an NFL game, PropLine derives a no-vig fair price from a sharp anchor (Pinnacle preferred, Bovada fallback) and returns the EV percentage at every other book’s price for the same line. Outcomes with positive EV are flagged so your code can sort to the +EV plays in a single pass.
GET /v1/sports/football_nfl/events/{event_id}/ev
{
"lines": [{
"market_key": "player_rush_yds",
"description": "Saquon Barkley",
"point": 88.5,
"fair_source": "pinnacle",
"fair_probs": { "Over": 0.51, "Under": 0.49 },
"outcomes": [
{ "book": "fanduel", "name": "Over", "price": 110,
"ev_pct": 7.10, "is_plus_ev": true },
{ "book": "draftkings", "name": "Over", "price": -105,
"ev_pct": -0.50 }
]
}]
}+EV endpoint available starting on the Hobby tier ($9/mo).
Quick example
Fetch tonight’s NFL game lines across all books in a single request:
curl "https://api.prop-line.com/v1/sports/football_nfl/odds?apiKey=YOUR_API_KEY&markets=h2h,spreads,totals"Or get a single game’s player props during the season:
curl "https://api.prop-line.com/v1/sports/football_nfl/events/{EVENT_ID}/odds?apiKey=YOUR_API_KEY&markets=player_pass_yds,player_rush_yds,player_receptions,player_anytime_td"SDKs — one line to install
Official Python and Node clients with full type signatures.
Python
pip install proplinefrom propline import PropLine
client = PropLine("your_api_key")
events = client.get_events("football_nfl")
odds = client.get_odds(
"football_nfl",
event_id=events[0]["id"],
markets=["h2h", "spreads", "totals"],
)Node / TypeScript
npm install proplineimport { PropLine } from "propline";
const client = new PropLine("your_api_key");
const events = await client.getEvents("football_nfl");
const odds = await client.getOdds("football_nfl", {
eventId: events[0].id,
markets: ["h2h", "spreads", "totals"],
});Why PropLine for NFL data
| PropLine | the-odds-api | |
|---|---|---|
| Free tier | 1,000 requests / day | 500 requests / month |
| Hobby tier (full features) | $9 / mo, 5,000 / day | n/a |
| Pro tier | $19 / mo, 25,000 / day | $30 / mo, 100K credits |
| Prop resolution (won/lost/push) | Yes — automatic | No |
| Cross-book +EV | Yes — Pinnacle-anchored | No |
| Webhook push delivery | Streaming Lite ($39/mo) and up | No |
| Update frequency | Every 60 seconds (30s live) | Varies by tier |
| API response shape | the-odds-api compatible | — |
| Annual pricing | 2 months free | n/a |
Frequently asked questions
Do you have NFL player props right now?
Game lines (h2h, spreads, totals) are live year-round. Per-game player props (pass yards, rush yards, receptions, anytime TD, etc.) activate when the regular season opens in September. Our resolution scaffolding is already wired and tested — when the lines come back, prop resolution works on day one.
Where do you get NFL stats from?
ESPN's public scoreboard and box-score endpoints, plus the NFL's own JSON feeds. Both are free, both don't require auth. We poll once games complete and grade every Over/Under against actual passing/rushing/receiving stats within minutes.
What sportsbooks do you cover for NFL?
BetMGM, BetRivers, Bovada, DraftKings, FanDuel, Pinnacle, Unibet, 1xBet, and TAB AU for traditional sportsbooks. Plus Kalshi, Polymarket, Matchbook, Smarkets, and Novig for regulated event-contract and back/lay exchanges, and PrizePicks + Underdog Fantasy for DFS pick'em projections. Every NFL response includes a `bookmakers` array — line shopping across all 16 sources is a single API call.
How is this different from the-odds-api for NFL?
Three things they don't sell: (1) prop resolution — every prop graded against actual stats; (2) cross-book +EV with no-vig fair lines from a sharp anchor; (3) webhook push delivery for line movement and resolution events. On price, our free tier is 60× more generous (1,000 / day vs 500 / month) and our entry tier (Hobby) is $9/mo vs their $30/mo starter (Pro is $19/mo for 25K/day).
Is the response format compatible with the-odds-api?
Yes. Same JSON shape — events, bookmakers array, markets, outcomes. Migration is typically a base URL change. We even maintain a /switch-from-the-odds-api page with a cost calculator and an invoice-for-discount promo.
Can I build a commercial NFL betting tool with this?
Yes, on any tier. Free, Hobby ($9), Pro ($19), Streaming Lite ($39), and Streaming ($79) tiers can all be used in commercial products. Most apps fit comfortably in Hobby or Pro; Streaming Lite is for tools that need webhook line-movement alerts; Streaming is for trading bots that want every tick at 1M requests/day.
Does the free tier work during NFL Sundays?
Yes. 1,000 requests/day is enough to poll every Sunday slate's game lines roughly every 30 seconds. Heavy users (model backtests, live in-game scrapers, market-makers) typically upgrade to Hobby or Pro for the headroom — but plenty of weekend hobby projects stay on free permanently.
Will prop resolution work on day one of the season?
Yes. The resolver code is already shipped and the box-score parsers handle passing/rushing/receiving stat groups. The only thing missing is the props themselves — which Bovada and the other books only post during the season. The minute they do, every Over/Under that gets recorded will be graded automatically after each game.
Get your free NFL data API key
1,000 requests / day. No credit card. Same key works across every sport — switch from NFL to NBA to MLB without re-registering.
Free tier includes 1,000 requests/day. Upgrade anytime.