nfl-data-py
python library for interacting with NFL data sourced from nflfastR
Decision gist · record as of 2026-08-14
Yes, with conditions. The package is useful for NFL data analysis and fantasy football work, has low install friction, and carries a permissive MIT license. However, the abandoned repository status is a significant concern: there is no active maintenance, and you should verify that the upstream data sources remain accessible before committing to it in production. For one-off analysis or personal projects, it is likely stable enough; for ongoing systems, consider monitoring the upstream sources directly or seeking an actively maintained alternative.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Low install friction with four common dependencies (numpy, pandas, appdirs, fastparquet).
- However, the repository is archived and marked abandoned, with the last commit on 2025-09-25 and no active maintenance.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license text.
last release 2024-09-20 (693 days) · last repo commit 2025-09-25 · 434 stars · archived
0 known vulnerabilities (OSV.dev, 2026-08-14) · 120,941 downloads/mo, #12,003 on PyPI
Alternatives
Verify before relying
pip install nfl_data_py
import nfl_data_py as nfl
# Import play-by-play data for specified years
data = nfl.import_pbp_data(years=[1999])
# Import weekly stats
weekly = nfl.import_weekly_data(years=[1999])- Whether the upstream data sources (nflfastR, nfldata, dynastyprocess, Draft Scout) remain actively maintained and accessible
- Whether the package's data import functions continue to work reliably given the abandoned repository status
- Performance characteristics when importing large multi-year datasets with the downcast option
What it is and what it does
nfl_data_py is a wrapper library that fetches NFL statistics and metadata from multiple upstream sources and loads them into pandas DataFrames. It provides import functions for play-by-play data (the core use case), weekly and seasonal aggregates, rosters, draft picks, combine results, schedules, officials, and various other game-related datasets spanning back to 1999. The library depends on pandas for data manipulation, numpy for numerical operations, fastparquet for efficient file handling, and appdirs for cache management.
The package is designed for analysts and fantasy football enthusiasts who need structured access to historical NFL data without manually downloading or parsing files. It supports optional memory optimization through float downcasting and local caching to reduce repeated network requests. However, the repository is archived and abandoned, meaning no active maintenance or bug fixes are being applied—users relying on it should verify that the upstream data sources remain accessible and that the import functions continue to work with current data formats.
Use it for
- Analyze historical play-by-play data to study offensive and defensive performance trends across seasons
- Build fantasy football models using weekly player statistics, combine metrics, and draft pick valuations
- Research receiver target share, air yards, and dominator ratings for talent evaluation
- Fetch NFL schedules, rosters, and injury reports for season-long tracking applications
- Retrieve QBR history and advanced stats from Pro Football Reference for quarterback analysis
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
The package is useful for NFL data analysis and fantasy football work, has low install friction, and carries a permissive MIT license. However, the abandoned repository status is a significant concern: there is no active maintenance, and you should verify that the upstream data sources remain accessible before committing to it in production. For one-off analysis or personal projects, it is likely stable enough; for ongoing systems, consider monitoring the upstream sources directly or seeking an actively maintained alternative.
Install
nfl-data-py on PyPI
Before you install
Low install friction with four common dependencies (numpy, pandas, appdirs, fastparquet). However, the repository is archived and marked abandoned, with the last commit on 2025-09-25 and no active maintenance.
License in practice
MIT license permits commercial and private use with minimal restrictions, requiring only attribution and inclusion of the license text.
Quickstart
pip install nfl_data_py
import nfl_data_py as nfl
# Import play-by-play data for specified years
data = nfl.import_pbp_data(years=[1999])
# Import weekly stats
weekly = nfl.import_weekly_data(years=[1999])Verify before relying
- Whether the upstream data sources (nflfastR, nfldata, dynastyprocess, Draft Scout) remain actively maintained and accessible
- Whether the package's data import functions continue to work reliably given the abandoned repository status
- Performance characteristics when importing large multi-year datasets with the downcast option
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.6.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesnumpypandasappdirsfastparquet |
| Maintenance | Abandoned 693 days since the last release |
| Last repo commit | repository archived |
| First released | |
| Downloads | 120,941 / month, #12,003 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersIntended Audience :: Science/ResearchLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Scientific/Engineering :: Information Analysis |
Evidence: nfl_data_py-0.3.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “NFL play-by-play data import”
- nfl-data-pyImports NFL play-by-play, weekly, seasonal, roster, draft, combine,…
- nflreadpyDownloads and caches NFL data from nflverse repositories into Polars…
- nba_apinba_api provides Python access to NBA.com's official stats and live…
Give your agent the search over MCP, or paste the wish link into any chat.
More Information Analysis packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyarrow provides Python bindings to Apache Arrow's C++ libraries for efficient columnar data processing, serialization, and interoperability with pandas, NumPy, and other Python ecosystem tools.
NetworkX provides data structures and algorithms for creating, analyzing, and manipulating graphs and networks, supporting everything from simple undirected graphs to complex directed and weighted networks.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
ContourPy calculates contours of 2D quadrilateral grids using C++11 algorithms wrapped in Python, offering serial and multithreaded implementations without requiring Matplotlib as a dependency.
Snowpark Python provides APIs to query and process data directly in Snowflake without moving data to your local system, with support for both native Snowpark and pandas-compatible interfaces.
Install it if you use Snowflake and want to process data without moving it to your application layer.
See also nflreadpy · espn-api · MLB-StatsAPI · ucimlrepo · pybaseball · nba_api · statsbombpy · pandas-read-xml · gspread-dataframe · prophet