Skip to content

Next Gen Stats Endpoints

Next Gen Stats endpoints ().

ngs

Next Gen Stats (NGS) API endpoints.

This module provides access to NFL Next Gen Stats data from nextgenstats.nfl.com, including player statistics, game information, charts, highlights, and leaderboards.

NgsBaseSDK 

NgsBaseSDK(sdk_config, parent_ref=None)

Bases: BaseSDK

Base SDK for Next Gen Stats endpoints.

Overrides _resolve_base_url to use nextgenstats.nfl.com.

Source code in src/griddy/core/basesdk.py 
128
129
130
131
132
133
134
135
136
def __init__(
    self,
    sdk_config: T_Config,
    parent_ref: Optional[object] = None,
) -> None:
    """Initialize the SDK with configuration and an optional parent reference."""
    self.sdk_configuration = sdk_config
    self.parent_ref = parent_ref
    self._cached_env_security = _UNRESOLVED

NextGenStats 

NextGenStats(sdk_config, parent_ref=None)

Bases: LazySubSDKMixin, NgsBaseSDK

Next Gen Stats SDK providing access to NGS data.

This SDK provides access to NFL Next Gen Stats data including: - League schedules and team information - Live game scores and game center data - Player passing, receiving, and rushing statistics - Top plays and leaderboards - Charts and highlights - News articles and videos

Usage

nfl = GriddyNFL()

League data

schedule = nfl.ngs.league.get_current_schedule() teams = nfl.ngs.league.get_teams()

Statistics

passing = nfl.ngs.stats.get_passing_stats(season=2025, season_type="REG")

Leaders

fastest = nfl.ngs.leaders.get_fastest_ball_carriers(season=2025)

Source code in src/griddy/core/basesdk.py 
128
129
130
131
132
133
134
135
136
def __init__(
    self,
    sdk_config: T_Config,
    parent_ref: Optional[object] = None,
) -> None:
    """Initialize the SDK with configuration and an optional parent reference."""
    self.sdk_configuration = sdk_config
    self.parent_ref = parent_ref
    self._cached_env_security = _UNRESOLVED

league instance-attribute 

league

League schedules and team information

games instance-attribute 

games

Live scores and game center data

stats instance-attribute 

stats

Player passing, receiving, and rushing statistics

leaders instance-attribute 

leaders

Top plays and leaderboards

content instance-attribute 

content

Charts and highlights

news instance-attribute 

news

News articles and videos (uses api.nfl.com)