Skip to main content

A collection of wrappers over soccer data from various websites / APIs.

Project description

SoccerData

PyPI Python Version License Read the documentation at https://soccerdata.readthedocs.io/ Tests Codecov pre-commit Black

SoccerData is a collection of wrappers over soccer data from Club Elo, ESPN, FBref, FiveThirtyEight, Football-Data.co.uk, SoFIFA 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 scraper class instance for the Premier League
five38 = sd.FiveThirtyEight('ENG-Premier League', '1819')

# Fetch dataframes
games = five38.read_games()

To learn how to install, configure and use SoccerData, see the Quickstart guide. For documentation on each of the supported data sources, see the API reference.

Disclaimer: 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

soccerdata-0.0.2.tar.gz (24.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

soccerdata-0.0.2-py3-none-any.whl (30.2 kB view details)

Uploaded Python 3

File details

Details for the file soccerdata-0.0.2.tar.gz.

File metadata

  • Download URL: soccerdata-0.0.2.tar.gz
  • Upload date:
  • Size: 24.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for soccerdata-0.0.2.tar.gz
Algorithm Hash digest
SHA256 f1dbef9e987fc0e17eddf0acb9b77344f660eab09853e0417b86587749690262
MD5 cd34eeecb5caec7f537600f1d78cd14e
BLAKE2b-256 5af3d4865a3320bf9290de6640168cc02f2ce7359528e3f4d8f0e0a2904426b5

See more details on using hashes here.

File details

Details for the file soccerdata-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: soccerdata-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 30.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.11.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for soccerdata-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e1d3e5117340e05da33afeaad29f1251f1095818a818099069151a6100dd1684
MD5 ae08bebf42d486d456b454b201279021
BLAKE2b-256 06e6fb100dfdc587e4350a4236fa8be8f6e31e5598fc0c67330a5fc126323313

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page