statsbombpy
easily stream StatsBomb data into Python
Decision gist · record as of 2026-08-14
Yes, if you have StatsBomb API credentials or want to use its free public datasets. Install friction is low, maintenance is active, and no known vulnerabilities exist. The main caveat is unclear licensing—verify the User Agreement and data usage terms before publishing research or deploying in production. Python version support is unspecified, so test compatibility with your environment.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- API access requires StatsBomb paid credentials (SB_USERNAME and SB_PASSWORD environment variables or creds dict argument); free data is available without authentication.
- Low friction: pure Python wheel with five common runtime dependencies (pandas, requests, requests-cache, inflect, joblib).
- Active maintenance—last commit 2026-07-30, 15 days old—and 738 GitHub stars suggest ongoing support.
License · maintenance · safety
(unclear) — License treatment is unclear; no SPDX or raw license metadata is available. Users should verify licensing terms, especially the StatsBomb User Agreement referenced in the package documentation, before using data in production or publishing research.
last release 2026-07-30 (15 days) · last repo commit 2026-07-30 · 738 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 108,663 downloads/mo, #12,546 on PyPI
Alternatives
Verify before relying
pip install statsbombpy
from statsbombpy import sb
# Free public data, no credentials needed
competitions_df = sb.competitions()
matches_df = sb.matches(competition_id=9, season_id=42)
events_df = sb.events(match_id=303299)- Whether free public data access requires email registration or has usage restrictions beyond the User Agreement.
- Python version compatibility (requires_python is unspecified in metadata).
- Whether the package's concurrency features (SB_CORES environment variable) scale predictably with system resources.
What it is and what it does
StatsBombpy is a Python client for StatsBomb's football analytics platform. It retrieves structured match, event, lineup, and competition data and returns it as pandas DataFrames, making it easy to load StatsBomb datasets into analysis workflows. The package supports both authenticated API access (for paying customers) and free public datasets hosted on GitHub.
The package handles authentication via environment variables or inline credentials, supports parallel event and frame fetching across multiple CPU cores (configurable via SB_CORES), and includes caching via requests-cache to reduce redundant API calls. Its main dependencies are pandas for data structures, requests for HTTP communication, and joblib for concurrent processing.
Use it for
- Fetch competition and match metadata for a specific league and season to build a fixture list for analysis.
- Download event-level data (passes, shots, fouls, etc.) for a single match and analyze player actions or team tactics.
- Retrieve lineup data to cross-reference player IDs, positions, and physical attributes with event records.
- Batch download events across multiple matches using parallel processing to speed up large dataset assembly.
- Combine StatsBomb data with external sources (team stats, player ratings) in a pandas workflow for custom analytics.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you have StatsBomb API credentials or want to use its free public datasets.
Install friction is low, maintenance is active, and no known vulnerabilities exist. The main caveat is unclear licensing—verify the User Agreement and data usage terms before publishing research or deploying in production. Python version support is unspecified, so test compatibility with your environment.
Install
statsbombpy on PyPI
Before you install
Low friction: pure Python wheel with five common runtime dependencies (pandas, requests, requests-cache, inflect, joblib). Active maintenance—last commit 2026-07-30, 15 days old—and 738 GitHub stars suggest ongoing support.
API access requires StatsBomb paid credentials (SB_USERNAME and SB_PASSWORD environment variables or creds dict argument); free data is available without authentication.
License in practice
License treatment is unclear; no SPDX or raw license metadata is available. Users should verify licensing terms, especially the StatsBomb User Agreement referenced in the package documentation, before using data in production or publishing research.
Quickstart
pip install statsbombpy
from statsbombpy import sb
# Free public data, no credentials needed
competitions_df = sb.competitions()
matches_df = sb.matches(competition_id=9, season_id=42)
events_df = sb.events(match_id=303299)Verify before relying
- Whether free public data access requires email registration or has usage restrictions beyond the User Agreement.
- Python version compatibility (requires_python is unspecified in metadata).
- Whether the package's concurrency features (SB_CORES environment variable) scale predictably with system resources.
Package facts
| License | Not declared unclear |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagespandasrequestsrequests-cacheinflectjoblib |
| Maintenance | Actively maintained 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 108,663 / month, #12,546 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: statsbombpy-1.22.0-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 › “football soccer data api python”
- statsbombpyStreams StatsBomb football analytics data into Python via API (for…
- espn-apiExtracts league, team, and player data from ESPN's Fantasy API for…
- nflreadpyDownloads and caches NFL data from nflverse repositories into Polars…
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 · nba_api · espn-api · pybaseball · nfl-data-py · eurostat · meteostat · MLB-StatsAPI · betfairlightweight · names-dataset