Overview
The NFL API delivers schedules, rosters, standings, statistics, draft coverage, and real-time scoring for the National Football League, with full play-by-play for every game.
This integration guide is a companion to the NFL API reference. The reference documents every field of every feed; these pages show how the feeds work together: which feed answers which question, how IDs connect payloads, how fast data moves, and what a game looks like at each point in its lifecycle.
How the Guide Is Organized
Start with NFL API Basics and NFL Fundamentals, then follow the Integration Scenarios that match your use case.
Ready to test?Already have an account and want to browse the data? Visit the interactive sandbox.
What the API Provides
- Schedules: season, weekly, current-season, and current-week views with venue and broadcast detail
- Game detail: live boxscores, full play-by-play, team and player game statistics, and game-day rosters
- League structure: hierarchy, teams, seasons, and tournament feeds with brackets and seeds
- Team and player data: team profiles, full rosters, player profiles, free agents, weekly depth charts, and weekly injury reports
- Standings and statistics: postgame standings, league leaders, seasonal team and player statistics, and seasonal awards
- The NFL Draft: draft summaries, prospects, top prospects, trades, and team draft summaries
- Change tracking: a daily change log of modified entities plus daily transactions for reconciliation
Real-time delivery is also available through the Push Events, Push Statistics, and Push Pulse feeds; the Push Feeds page covers the subscription workflow.
The League at a Glance
An NFL year is three seasons, and the API's season types follow them: the preseason (PRE) in August, an 18-week regular season (REG) from early September into January, and the postseason (PST) running from the Wild Card round through the Super Bowl. Season year plus season type address every seasonal feed; the Fundamentals page walks through that addressing.
Thirty-two teams sit in two conferences of four divisions each. The League Hierarchy feed carries that structure, the Postgame Standings feed carries the records behind playoff seeding, and the tournament feeds carry the bracket itself; the Tracking Playoffs scenario builds one from them. The league year continues in the spring with the NFL Draft, which the Tracking the Draft scenario covers.
Companion Tools
- The interactive reference lets you try every endpoint against your key
- The Postman workspace carries a ready-made NFL collection
- Simulations replay past games on demand for integration testing, including Push
Updated 3 days ago
