The American Football API for developers ballers.

NFL and NCAA football under one API: schedules, play-by-play with EPA and Win Probability on every play, and weekly player stats, built on a decade of NFL history. Live scores resume for the 2026 NFL season.

1,000 req/day free (2,000 with GitHub). No credit card.

NFL · NCAAF · a decade of history · 294,989 plays with EPA + WP

The NFL API page focuses on the NFL historical surface with field-level docs for plays and weekly stats. See the NFL API →

What you get, by plan

One row per capability, not per field per endpoint. Season spans are counted from rows that are actually populated, and each capability names the simplest endpoint that returns it.

Offensive stats

CapabilityFreeSoloTrioEdgeProEndpoint
Carries—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Completions—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Interceptions thrown—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Pass attempts—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Passing touchdowns—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Passing yards—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
PPR fantasy points—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Receiving touchdowns—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Receiving yards—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Receptions—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Rushing touchdowns—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Rushing yards—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Targets—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats

Defensive stats

CapabilityFreeSoloTrioEdgeProEndpoint
Defensive touchdowns—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Forced fumbles—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Interception return yards—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Interceptions caught—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Passes defended—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Quarterback hits—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Sack yards—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Sacks—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Safeties—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Solo tackles—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Tackle assists—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Tackle-for-loss yards—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Tackles for loss—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Tackles with assist—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Two-point attempts defended—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Two-point conversions defended—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats

Kicking and special teams

CapabilityFreeSoloTrioEdgeProEndpoint
Extra points blocked—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Field goals blocked—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats
Punts blocked—PENDINGPENDINGPENDINGPENDING/v1/nfl/players/{player_id}/stats

Play-by-play

CapabilityFreeSoloTrioEdgeProEndpoint
Defending team————7 seasons/v1/nfl/games/{game_id}/plays
Distance to go————7 seasons/v1/nfl/games/{game_id}/plays
Down————7 seasons/v1/nfl/games/{game_id}/plays
Expected points added————PENDING/v1/nfl/team-stats
Field position————7 seasons/v1/nfl/games/{game_id}/plays
Game clock————7 seasons/v1/nfl/games/{game_id}/plays
Passer on a play————7 seasons/v1/nfl/games/{game_id}/plays
Play type————7 seasons/v1/nfl/games/{game_id}/plays
Receiver on a play————7 seasons/v1/nfl/games/{game_id}/plays
Rusher on a play————7 seasons/v1/nfl/games/{game_id}/plays
Score differential————7 seasons/v1/nfl/games/{game_id}/plays
Team in possession————7 seasons/v1/nfl/games/{game_id}/plays
Win probability————7 seasons/v1/nfl/games/{game_id}/plays
Yards gained————7 seasons/v1/nfl/games/{game_id}/plays

Team stats

CapabilityFreeSoloTrioEdgeProEndpoint
Completion percentage over expected—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Interceptions thrown (team)—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Passing air yards—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Passing EPA—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Passing first downs—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Receiving EPA—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Rushing EPA—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Rushing first downs—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats
Sacks taken—PENDINGPENDINGPENDINGPENDING/v1/nfl/team-stats

Schedules and fixtures

CapabilityFreeSoloTrioEdgeProEndpoint
Final scorePENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games
Game typePENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games
Kickoff datePENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games
Playing surfacePENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games
Rest days per teamPENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games
Roof typePENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games
StadiumPENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games
WeekPENDINGPENDINGPENDINGPENDINGPENDING/v1/nfl/games

Injuries, rosters and depth charts

CapabilityFreeSoloTrioEdgeProEndpoint
Depth chart position—PENDINGPENDINGPENDINGPENDING/v1/nfl/depth-charts
Depth chart rank—PENDINGPENDINGPENDINGPENDING/v1/nfl/depth-charts
Depth chart validity interval—PENDINGPENDINGPENDINGPENDING/v1/nfl/depth-charts
Jersey number—PENDINGPENDINGPENDINGPENDING/v1/players
Listed position—PENDINGPENDINGPENDINGPENDING/v1/nfl/rosters
Practice participation status—PENDINGPENDINGPENDINGPENDING/v1/nfl/injuries
Reported injury detail—PENDINGPENDINGPENDINGPENDING/v1/nfl/injuries
Roster status—PENDINGPENDINGPENDINGPENDING/v1/scores
Weekly injury report status—PENDINGPENDINGPENDINGPENDING/v1/nfl/injuries
Years of experience—PENDINGPENDINGPENDINGPENDING/v1/nfl/rosters

Ratings and derived intelligence

CapabilityFreeSoloTrioEdgeProEndpoint
Current Elo rating—PENDINGPENDINGPENDINGPENDING/v1/teams/{id}/elo
Elo rating history—PENDINGPENDINGPENDINGPENDING/v1/teams/{id}/elo

Images and identity

CapabilityFreeSoloTrioEdgeProEndpoint
Player headshots—PENDINGPENDINGPENDINGPENDING/v1/players
Player name✓✓✓✓✓/v1/players
Player position✓✓✓✓✓/v1/players
Team abbreviationPENDINGPENDINGPENDINGPENDINGPENDING/v1/matches
Team name✓✓✓✓✓/v1/players

Measured against production on 2026-09-13. A capability appears here only when it has rows, an endpoint that returns it, and a source we may both serve and quote.

Stats included

Every football stat field the API returns today — 96 in total, grouped by how they are produced. Each group carries its own freshness, because a sport is rarely uniformly current.

Per-game player stats

Post-game

Written after the game ends — not a live in-game feed. Last ingested 2026-08-30.

Endpoint
/v1/players/:id/stats
Last updated
2026-08-30

Fields (77)

QB Hits, QB Rating, Adjusted QBR, Passes Defended, QB Hurries, Sacks, Solo Tackles, Defensive Touchdowns, Tackles for Loss, Total Tackles, Fumbles, Fumbles Lost, Fumbles Recovered, Interceptions, Interception Return Touchdowns, Interception Return Yards, Kick Return Average, Longest Kick Return, Kick Returns, Kick Return Touchdowns, Kick Return Yards, Field Goals, Longest Field Goal, Field Goal %, Kicking Points, Total Kicking Attempts, Extra Points, Yards per Attempt, Completions/Attempts, Interceptions Thrown, QBR, Passing Touchdowns, Passing Yards, Punt Return Average, Longest Punt Return, Punt Returns, Punt Return Touchdowns, Punt Return Yards, Punting Average, Punts Inside the 20, Longest Punt, Punts, Touchbacks, Punting Yards, Yards per Reception, Longest Reception, Receptions, Receiving Touchdowns, Receiving Yards, Yards per Carry, Carries, Longest Rush, Rushing Touchdowns, Rushing Yards, Completions Passing Attempts, Extra Points Made Extra Point Attempts, Field Goals Made Field Goal Attempts, Gross Average Punt Yards, Hurries, Interception Touchdowns, Interception Yards, Long Field Goal Made, Long Kick Return, Long Punt, Long Punt Return, Long Reception, Long Rushing, Punt Yards, Punts Inside20, Receiving Targets, Rushing Attempts, Sacks/Sack Yards Lost, Total Kicking Points, Yards per Kick Return, Yards per Pass Attempt, Yards per Punt Return, Yards per Rush Attempt

Team stats (per game)

Post-game

Written after the game ends — not a live in-game feed. Last ingested 2026-08-30.

Endpoint
/v1/matches/:id/statistics
Last updated
2026-08-30

Fields (25)

Completions/Attempts, Defensive Touchdowns, First Downs, First Downs (passing), First Downs (penalty), First Downs (rushing), Fourth-Down Efficiency, Fumbles Lost, Interceptions Thrown, Net Passing Yards, Time of Possession, Red Zone Attempts, Rushing Attempts, Rushing Yards, Sacks / Yards Lost, Score, Third-Down Efficiency, Total Drives, Total Offensive Plays, Total Penalties Yards, Total Yards, Turnovers, Yards per Pass, Yards per Play, Yards per Rush Attempt

Not included

  • Not shown here — player_per_week (new granularity, not yet mapped for display).
  • Not shown here — play_by_play: play-by-play events, not a stat line — mostly identifiers once classified.
  • Not shown here — rosters: roster listings — reference data, and no route serves them.

Missing a stat?

We build what people actually ask for. If a field you need is not on this page, tell us — requests are how we decide what to add next.

Name the field or the endpoint shape. Specifics help more than categories.

Goes straight to the team as a product signal. No newsletter, no account, nothing else done with your address.

What you can build

  • EPA / WP model

    Train win-probability and expected-points models on every play in the dataset.

  • Play-by-play research

    Query 294,989 plays with EPA and Win Probability for situational analysis.

  • Fantasy historical tool

    Weekly player stats across seasons for projections and backtests.

  • Schedule explorer

    Season schedules with stadium, surface, and final scores.

  • Betting backtest engine

    Replay historical games against closing lines to validate a model.

Walk through it end to end:

Endpoints

On the gateway at api.bigballsdata.com. Authenticate with the bearer token from /dashboard/keys.

MethodPathReturnsPlan
GET/v1/nfl/games?season=2024&week=1NFL schedules filtered by season and weekFree
GET/v1/nfl/games/:game_idSingle game with stadium, surface, scoresFree
GET/v1/nfl/games/:game_id/playsPlay-by-play with EPA + Win ProbabilityPro
GET/v1/nfl/players/:player_id/statsWeekly player stats (passing, rushing, receiving, PPR)Free
GET/v1/nfl/players/:player_id/game-logPer-season chronological game logFree
GET/v1/standings?sport=american_football&league=nflDivision + conference standingsFree

Start on the free tier

100 requests per minute and 1,000 per day, free — the highest per-minute burst of any free sports API we checked. Burst is what matters when something asks several questions in a row and waits on each answer.

  • Every sport and league we cover — the paid tiers add history depth and premium fields, not more leagues.
  • Calls are counted one for one — no credit weighting, no markets-times-regions arithmetic.
  • Link GitHub and the daily cap goes to 2,000.
  • No credit card.
Get a key →

Or ask your AI tool directly

Connect your account to Claude, ChatGPT, Cursor, Perplexity or any other MCP-compatible tool and ask for football data in conversation — scores, standings, player stats and Elo ratings, with no API key to paste and no code to write. Your plan and limits carry over exactly as they do here.

Connect your AI tool →

Integrate in a few lines

Node.js, @bigballsdata/sdktypescript
import { BigBallSportsClient } from '@bigballsdata/sdk';

const client = new BigBallSportsClient(process.env.BBS_API_KEY!);

type NflPlay = { posteam: string; play_type: string | null; epa: number | null; wp: number | null };

// Every play of a game, with EPA + win probability.
const plays = await client.get<NflPlay[]>('/v1/nfl/games/2025_01_DAL_PHI/plays');
for (const p of plays.data) {
  console.log(p.posteam, p.play_type, 'EPA', p.epa, 'WP', p.wp);
}

Free covers a real app. Scale when you need to.

1,000 req/day free (2,000 with GitHub). Production starts at $49/mo. Live WebSocket push on Pro+.

See all plans

Frequently asked

Is American football data live right now?
The NFL is between seasons, so there are no live games today. The NFL historical surface (schedules, weekly stats, and play-by-play with EPA + Win Probability) is available now; live scores resume for the 2026 season.
Does it include EPA and Win Probability?
Yes. /v1/nfl/games/:game_id/plays returns per-play EPA and Win Probability across the six loaded seasons (294,989 plays).
Does it cover NCAA football?
NCAAF schedules and records are covered via the college-football surface; the deepest play-level analytics (EPA / WP) are on the NFL surface today.
Is the American football API free?
Yes. Schedules, weekly stats, play-by-play, and standings on the free tier at 1,000 req/day (2,000 with GitHub), no credit card.

Leagues in this sport

Every league we serve for this sport, each with its own endpoints and coverage.

NFL API — Play-by-Play, Stats & SchedulesNCAAF API — FBS & FCS Scores + Odds

Stats reference

NFL Player Stats API

Build guides

NFL fantasy football API tutorialHow to build an NFL scouting toolHow to build an NFL conditions analytics toolNFL betting model API tutorialNFL live game center API tutorialHow to build an NCAAF scoreboard and live game centerHow to build college football rankings and conference standingsHow to build an NCAAF fantasy football app

Get an API key in 30 seconds