Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/probberechts/soccerdata

⛏⚽ Scrape soccer data from Club Elo, ESPN, FBref, FiveThirtyEight, Football-Data.co.uk, FotMob, SoFIFA, Understat and WhoScored.
https://github.com/probberechts/soccerdata

elo-rating espn fbref fivethirtyeight fotmob soccer soccer-analytics soccer-data sofifa sports-data understat whoscored

Last synced: about 1 month ago
JSON representation

⛏⚽ Scrape soccer data from Club Elo, ESPN, FBref, FiveThirtyEight, Football-Data.co.uk, FotMob, SoFIFA, Understat and WhoScored.

Awesome Lists containing this project

README 

        
.. image:: https://raw.githubusercontent.com/probberechts/soccerdata/master/docs/_static/logo2.png

   :align: center

   :alt: SoccerData

   :width: 600px



.. badges-begin



|Downloads| |PyPI| |Python Version| |License| |Read the Docs| |Tests| |Codecov| |pre-commit| |Black|



.. |Downloads| image:: https://static.pepy.tech/badge/soccerdata/month

   :target: https://pepy.tech/project/soccerdata

   :alt: Downloads Per Month

.. |PyPI| image:: https://img.shields.io/pypi/v/soccerdata.svg

   :target: https://pypi.org/project/soccerdata/

   :alt: PyPI

.. |Python Version| image:: https://img.shields.io/pypi/pyversions/soccerdata

   :target: https://pypi.org/project/soccerdata

   :alt: Python Version

.. |License| image:: https://img.shields.io/pypi/l/soccerdata.svg

   :target: https://opensource.org/licenses/Apache-2.0

   :alt: License

.. |Read the Docs| image:: https://img.shields.io/readthedocs/soccerdata/latest.svg?label=Read%20the%20Docs

   :target: https://soccerdata.readthedocs.io/

   :alt: Read the documentation at https://soccerdata.readthedocs.io/

.. |Tests| image:: https://github.com/probberechts/soccerdata/workflows/CI/badge.svg

   :target: https://github.com/probberechts/soccerdata/actions?workflow=CI

   :alt: Tests

.. |Codecov| image:: https://codecov.io/gh/probberechts/soccerdata/branch/master/graph/badge.svg

   :target: https://app.codecov.io/gh/probberechts/soccerdata

   :alt: Codecov

.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white

   :target: https://github.com/pre-commit/pre-commit

   :alt: pre-commit

.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg

   :target: https://github.com/psf/black

   :alt: Black



.. badges-end



SoccerData is a collection of scrapers to gather soccer data from popular

websites, including `Club Elo`_, `ESPN`_, `FBref`_, `FiveThirtyEight`_,

`Football-Data.co.uk`_, `FotMob`_, `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.



.. code:: python



   import soccerdata as sd



   # Create a scraper class instance for the 2018/19 Premier League

   five38 = sd.FiveThirtyEight('ENG-Premier League', '1819')



   # Fetch data

   games = five38.read_games()

   forecasts = five38.read_forecasts()

   clinches = five38.read_clinches()



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 `__.



.. _Club Elo: https://www.clubelo.com/

.. _ESPN: https://www.espn.com/soccer/

.. _FBref: https://www.fbref.com/en/

.. _FiveThirtyEight: https://fivethirtyeight.com/soccer-predictions/

.. _Football-Data.co.uk: https://www.football-data.co.uk/

.. _FotMob: https://fotmob.com/

.. _Sofascore: https://www.sofascore.com/

.. _SoFIFA: https://sofifa.com/

.. _Understat: https://understat.com/

.. _WhoScored: https://www.whoscored.com/



**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 `__.