.. 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`_, `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 <https://soccerdata.readthedocs.io/en/latest/intro.html>`__. For documentation on each of the
supported data sources, see the `example notebooks <https://soccerdata.readthedocs.io/en/latest/datasources/>`__
and `API reference <https://soccerdata.readthedocs.io/en/latest/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/
.. _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 <https://github.com/probberechts/soccerdata/blob/master/CONTRIBUTING.rst>`__.
Raw data
{
"_id": null,
"home_page": "https://github.com/probberechts/soccerdata",
"name": "soccerdata",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "soccer, football, soccer data, web scraping, soccer analytics",
"author": "Pieter Robberechts",
"author_email": "pieter.robberechts@kuleuven.be",
"download_url": "https://files.pythonhosted.org/packages/07/54/8fa5242331416d3e0b3962c8855cb37c2c8a93af4f055c058fdcbbe470a8/soccerdata-1.6.1.tar.gz",
"platform": null,
"description": ".. image:: https://raw.githubusercontent.com/probberechts/soccerdata/master/docs/_static/logo2.png\n :align: center\n :alt: SoccerData\n :width: 600px\n\n.. badges-begin\n\n|Downloads| |PyPI| |Python Version| |License| |Read the Docs| |Tests| |Codecov| |pre-commit| |Black|\n\n.. |Downloads| image:: https://static.pepy.tech/badge/soccerdata/month\n :target: https://pepy.tech/project/soccerdata\n :alt: Downloads Per Month\n.. |PyPI| image:: https://img.shields.io/pypi/v/soccerdata.svg\n :target: https://pypi.org/project/soccerdata/\n :alt: PyPI\n.. |Python Version| image:: https://img.shields.io/pypi/pyversions/soccerdata\n :target: https://pypi.org/project/soccerdata\n :alt: Python Version\n.. |License| image:: https://img.shields.io/pypi/l/soccerdata.svg\n :target: https://opensource.org/licenses/Apache-2.0\n :alt: License\n.. |Read the Docs| image:: https://img.shields.io/readthedocs/soccerdata/latest.svg?label=Read%20the%20Docs\n :target: https://soccerdata.readthedocs.io/\n :alt: Read the documentation at https://soccerdata.readthedocs.io/\n.. |Tests| image:: https://github.com/probberechts/soccerdata/workflows/CI/badge.svg\n :target: https://github.com/probberechts/soccerdata/actions?workflow=CI\n :alt: Tests\n.. |Codecov| image:: https://codecov.io/gh/probberechts/soccerdata/branch/master/graph/badge.svg\n :target: https://app.codecov.io/gh/probberechts/soccerdata\n :alt: Codecov\n.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white\n :target: https://github.com/pre-commit/pre-commit\n :alt: pre-commit\n.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n :alt: Black\n\n.. badges-end\n\nSoccerData is a collection of scrapers to gather soccer data from popular\nwebsites, including `Club Elo`_, `ESPN`_, `FBref`_, `FiveThirtyEight`_,\n`Football-Data.co.uk`_, `FotMob`_, `SoFIFA`_, `Understat`_ and `WhoScored`_.\nYou get Pandas DataFrames with sensible, matching column names and identifiers\nacross datasets. Data is downloaded when needed and cached locally.\n\n.. code:: python\n\n import soccerdata as sd\n\n # Create a scraper class instance for the 2018/19 Premier League\n five38 = sd.FiveThirtyEight('ENG-Premier League', '1819')\n\n # Fetch data\n games = five38.read_games()\n forecasts = five38.read_forecasts()\n clinches = five38.read_clinches()\n\nTo learn how to install, configure and use SoccerData, see the\n`Quickstart guide <https://soccerdata.readthedocs.io/en/latest/intro.html>`__. For documentation on each of the\nsupported data sources, see the `example notebooks <https://soccerdata.readthedocs.io/en/latest/datasources/>`__\nand `API reference <https://soccerdata.readthedocs.io/en/latest/reference/>`__.\n\n.. _Club Elo: https://www.clubelo.com/\n.. _ESPN: https://www.espn.com/soccer/\n.. _FBref: https://www.fbref.com/en/\n.. _FiveThirtyEight: https://fivethirtyeight.com/soccer-predictions/\n.. _Football-Data.co.uk: https://www.football-data.co.uk/\n.. _FotMob: https://fotmob.com/\n.. _SoFIFA: https://sofifa.com/\n.. _Understat: https://understat.com/\n.. _WhoScored: https://www.whoscored.com/\n\n**Usage Notice:** Please use this web scraping tool responsibly and in compliance with the terms of service of the\nwebsites you intend to scrape. The software is provided as-is, without any warranty or guarantees of any kind. The\ndevelopers disclaim any responsibility for misuse, legal consequences, or damages resulting from its use. It is\nyour responsibility to use the software in accordance with the laws and regulations of your jurisdiction.\n\n**Contribution and Issues:** As soccerdata relies on web scraping, any changes to the\nscraped websites will break the package. Hence, do not expect that all code\nwill work all the time. If you spot any bugs, then please `fork it and start\na pull request <https://github.com/probberechts/soccerdata/blob/master/CONTRIBUTING.rst>`__.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "A collection of wrappers over soccer data from various websites / APIs.",
"version": "1.6.1",
"project_urls": {
"Homepage": "https://github.com/probberechts/soccerdata",
"Repository": "https://github.com/probberechts/soccerdata"
},
"split_keywords": [
"soccer",
" football",
" soccer data",
" web scraping",
" soccer analytics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "14bd344a81d23b1f28ef4ca8bb413287d6f4bff61726dde29475e2e9b8470487",
"md5": "bb4d50fcfd4b838b5e2dce8b741e8f3e",
"sha256": "f020824eda0d3a83c09e914103cdba9ab4a6d7c1561893ac88e5bfbf1b0efe4b"
},
"downloads": -1,
"filename": "soccerdata-1.6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bb4d50fcfd4b838b5e2dce8b741e8f3e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 53499,
"upload_time": "2024-03-22T22:23:30",
"upload_time_iso_8601": "2024-03-22T22:23:30.391227Z",
"url": "https://files.pythonhosted.org/packages/14/bd/344a81d23b1f28ef4ca8bb413287d6f4bff61726dde29475e2e9b8470487/soccerdata-1.6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "07548fa5242331416d3e0b3962c8855cb37c2c8a93af4f055c058fdcbbe470a8",
"md5": "6bf1cc7ac073dd4ad44c849b367cce22",
"sha256": "a86677922bfe410ab37274cca7680e0d7194c269c4f3691d663f667e87b59ed3"
},
"downloads": -1,
"filename": "soccerdata-1.6.1.tar.gz",
"has_sig": false,
"md5_digest": "6bf1cc7ac073dd4ad44c849b367cce22",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 42315,
"upload_time": "2024-03-22T22:23:32",
"upload_time_iso_8601": "2024-03-22T22:23:32.323100Z",
"url": "https://files.pythonhosted.org/packages/07/54/8fa5242331416d3e0b3962c8855cb37c2c8a93af4f055c058fdcbbe470a8/soccerdata-1.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-22 22:23:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "probberechts",
"github_project": "soccerdata",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "soccerdata"
}
JSON
