SoccerData is a collection of scrapers to gather soccer data from popular websites, including Club Elo, ESPN, FBref, Football-Data.co.uk, Sofascore, SoFIFA, Understat and WhoScored. You get Pandas DataFrames with sensible, matching column names and identifiers across datasets. Data is downloaded when needed and cached locally.
import soccerdata as sd
# Create a scraper class instance for the 2020/21 Premier League
fbref = sd.FBref('ENG-Premier League', '2021')
# Fetch data
games = fbref.read_schedule()
team_season_stats = fbref.read_team_season_stats(stat_type="passing")
player_season_stats = fbref.read_player_season_stats(stat_type="standard")To learn how to install, configure and use SoccerData, see the Quickstart guide. For documentation on each of the supported data sources, see the example notebooks and API reference.
Usage Notice: Please use this web scraping tool responsibly and in compliance with the terms of service of the websites you intend to scrape. The software is provided as-is, without any warranty or guarantees of any kind. The developers disclaim any responsibility for misuse, legal consequences, or damages resulting from its use. It is your responsibility to use the software in accordance with the laws and regulations of your jurisdiction.
Contribution and Issues: As SoccerData relies on web scraping, any changes to the scraped websites will break the package. Hence, do not expect that all code will work all the time. If you spot any bugs, then please fork it and start a pull request.
1 maintainer
Metadata
1 maintainer
Release files for soccerdata 2026.43.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| soccerdata-2026.43.0.tar.gz | 1.8 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| soccerdata-2026.43.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.9 MB
Release files / soccerdata-2026.43.0.tar.gz
| Download URL | soccerdata-2026.43.0.tar.gz |
|---|---|
| Size | 1.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
085bb7be0b44f2b4369a52b5829379858c3a7076e4edc734cb778351ba9d1875
|
|
BLAKE2b-256 checksum How to use checksums |
6f59a8bcbe1636b509ee25fdd0a212bd2b4d9d8c21c6f52d8bdf29dd903cc63c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / soccerdata-2026.43.0-py3-none-any.whl
| Download URL | soccerdata-2026.43.0-py3-none-any.whl |
|---|---|
| Size | 54.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
13139629ad423d28e76ac83d054086b7e02d8299a4d743d2565a834a17bd3d37
|
|
BLAKE2b-256 checksum How to use checksums |
7fa8bafe95deb5fd1e7dd8d405244cafc341767a16e9be7b1249f2a3be569728
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for soccerdata 2026.43.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
