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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file soccerdata-1.9.1.tar.gz.
File metadata
- Download URL: soccerdata-1.9.1.tar.gz
- Upload date:
- Size: 1.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5c903a9813b58bd6eab30e50fddc1400eb42426fa1accbbc1a0aad0141d679d6
|
|
| MD5 |
c254ab27e01369262f97e47305b36283
|
|
| BLAKE2b-256 |
d1a2a2f97263f6ad12494966fc50cea363be1654f0e03a6749fd3757071a0cba
|
File details
Details for the file soccerdata-1.9.1-py3-none-any.whl.
File metadata
- Download URL: soccerdata-1.9.1-py3-none-any.whl
- Upload date:
- Size: 52.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
15c135e9995f27535cd26ba360edccdbf664051796675ba2cd5109e0cc63d2bc
|
|
| MD5 |
7225facf246d369e199b4dee7fb4d148
|
|
| BLAKE2b-256 |
86a46c714aa3806eb5413dc35c20763ebcd274a871bd785df7bfb48d393f22cc
|
