Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

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

NFL Integration Guide MapFoundations first, then the scenario for your use case
Every page stands alone; the foundational pages carry the concepts the scenarios build on.

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


Did this page help you?