<p align="center">
</p>
<p align="center">
<a href="https://pypi.org/project/FRScraper/">
<img src="https://img.shields.io/pypi/v/FRScraper" alt="pypi" />
</a>
<a href="https://pypi.org/project/FRScraper/">
<img src="https://img.shields.io/pypi/pyversions/FRScraper" alt="python version" />
</a>
<a href="https://pypi.org/project/FRScraper/">
<img src="https://img.shields.io/pypi/l/FRScraper" alt="license" />
</a>
</p>
# FRScraper
Python package for easy access to football data through scraping of [Football Reference](https://fbref.com/en/) website.
This allows users to obtain statistics, standings, and scores of the following tournaments:
- **Premier League** (England)
- **La Liga** (Spain)
- **Bundesliga** (Germany)
- **Ligue 1** (France)
- **Serie A** (Italy)
- **Eredivisie** (Netherlands)
- **Liga Portuguesa** (Portugal)
- **Campeonato Brasileiro** (Brazil)
- **Primera Division Argentina** (Argentina)
- **Ekstraklasa** (Poland)
- **Russian Premier League** (Russia)
- **Saudi Pro League** (Saudi Arabia)
## Installing
### Via `pip`
Install with the following command:
```
pip install FRScraper
```
## Documentation
For documentation about the API methods refer to [the documentation](https://github.com/GabrielPastorello/FRScraper/blob/main/API.md).
## Example of use
```
from FRScraper import FRScraper
```
```
# League table
df = FRScraper.get_rankings('ENG').head()
```
Output:
| | Rk | Squad | MP | W | D | L | ... | xGD | xGD/90 | Attendance | Top Scorer Goals |
| -- | -- | --------------- | -- | -- | -- | -- | --- | ---- | ------ | ---------- | ----------------- |
| 0 | 1 | Manchester City | 38 | 28 | 7 | 3 | ... | 44.9 | 1.18 | 50112 | 27 |
| 1 | 2 | Arsenal | 38 | 28 | 5 | 5 | ... | 48.2 | 1.27 | 60236 | 16 |
| 2 | 3 | Liverpool | 38 | 24 | 10 | 4 | ... | 42.0 | 1.11 | 55979 | 18 |
| 3 | 4 | Aston Villa | 38 | 20 | 8 | 10 | ... | 3.4 | 0.09 | 41858 | 19 |
| 4 | 5 | Tottenham | 38 | 20 | 6 | 12 | ... | 4.8 | 0.13 | 61482 | 17 |
More examples in the files.
Use it wisely!
Raw data
{
"_id": null,
"home_page": "https://github.com/GabrielPastorello/FRScraper",
"name": "FRScraper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "football reference, scraper, premier league, la liga, ligue 1, serie a, bundesliga, eredivisie, football data",
"author": "Gabriel Speranza Pastorello",
"author_email": "gabriel.pastorello01@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/55/91/db635b41f99634c029c40b58630beae54d3247cbf84cb8886b2376e04f67/frscraper-0.1.3.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n</p>\r\n<p align=\"center\">\r\n <a href=\"https://pypi.org/project/FRScraper/\">\r\n <img src=\"https://img.shields.io/pypi/v/FRScraper\" alt=\"pypi\" />\r\n </a>\r\n <a href=\"https://pypi.org/project/FRScraper/\">\r\n <img src=\"https://img.shields.io/pypi/pyversions/FRScraper\" alt=\"python version\" />\r\n </a>\r\n <a href=\"https://pypi.org/project/FRScraper/\">\r\n <img src=\"https://img.shields.io/pypi/l/FRScraper\" alt=\"license\" />\r\n </a>\r\n</p>\r\n\r\n# FRScraper\r\n\r\nPython package for easy access to football data through scraping of [Football Reference](https://fbref.com/en/) website.\r\n\r\nThis allows users to obtain statistics, standings, and scores of the following tournaments:\r\n- **Premier League** (England)\r\n- **La Liga** (Spain)\r\n- **Bundesliga** (Germany)\r\n- **Ligue 1** (France)\r\n- **Serie A** (Italy)\r\n- **Eredivisie** (Netherlands)\r\n- **Liga Portuguesa** (Portugal)\r\n- **Campeonato Brasileiro** (Brazil)\r\n- **Primera Division Argentina** (Argentina)\r\n- **Ekstraklasa** (Poland)\r\n- **Russian Premier League** (Russia)\r\n- **Saudi Pro League** (Saudi Arabia)\r\n\r\n## Installing\r\n### Via `pip`\r\nInstall with the following command:\r\n\r\n```\r\npip install FRScraper\r\n```\r\n\r\n## Documentation\r\nFor documentation about the API methods refer to [the documentation](https://github.com/GabrielPastorello/FRScraper/blob/main/API.md).\r\n\r\n## Example of use\r\n```\r\nfrom FRScraper import FRScraper\r\n```\r\n\r\n```\r\n# League table\r\ndf = FRScraper.get_rankings('ENG').head()\r\n```\r\nOutput:\r\n| | Rk | Squad | MP | W | D | L | ... | xGD | xGD/90 | Attendance | Top Scorer Goals |\r\n| -- | -- | --------------- | -- | -- | -- | -- | --- | ---- | ------ | ---------- | ----------------- |\r\n| 0 | 1 | Manchester City | 38 | 28 | 7 | 3 | ... | 44.9 | 1.18 | 50112 | 27 |\r\n| 1 | 2 | Arsenal | 38 | 28 | 5 | 5 | ... | 48.2 | 1.27 | 60236 | 16 |\r\n| 2 | 3 | Liverpool | 38 | 24 | 10 | 4 | ... | 42.0 | 1.11 | 55979 | 18 |\r\n| 3 | 4 | Aston Villa | 38 | 20 | 8 | 10 | ... | 3.4 | 0.09 | 41858 | 19 |\r\n| 4 | 5 | Tottenham | 38 | 20 | 6 | 12 | ... | 4.8 | 0.13 | 61482 | 17 |\r\n\r\nMore examples in the files.\r\n\r\nUse it wisely!\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python module for Football Reference scraping and easy access to football data from various leagues",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://github.com/GabrielPastorello/FRScraper"
},
"split_keywords": [
"football reference",
" scraper",
" premier league",
" la liga",
" ligue 1",
" serie a",
" bundesliga",
" eredivisie",
" football data"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "763eb1f0e79c47ab5bf6c37edad8cc2c88f4ce747936122a43282f8f730e3f10",
"md5": "b5b348575418766787fccbba7020cd46",
"sha256": "af7a47e5bb32c47ad5bf235771a55ec0ee326e281034288b9b4b85be1d43dfae"
},
"downloads": -1,
"filename": "FRScraper-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b5b348575418766787fccbba7020cd46",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 5325,
"upload_time": "2024-05-24T02:53:40",
"upload_time_iso_8601": "2024-05-24T02:53:40.925358Z",
"url": "https://files.pythonhosted.org/packages/76/3e/b1f0e79c47ab5bf6c37edad8cc2c88f4ce747936122a43282f8f730e3f10/FRScraper-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5591db635b41f99634c029c40b58630beae54d3247cbf84cb8886b2376e04f67",
"md5": "7d0ff37d56e751ca00f7251793928dab",
"sha256": "37f67c29c9b2c7d90cf52289e6128bc4299b6e8cc6115e36bb0a506df7215327"
},
"downloads": -1,
"filename": "frscraper-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "7d0ff37d56e751ca00f7251793928dab",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5074,
"upload_time": "2024-05-24T02:53:42",
"upload_time_iso_8601": "2024-05-24T02:53:42.003942Z",
"url": "https://files.pythonhosted.org/packages/55/91/db635b41f99634c029c40b58630beae54d3247cbf84cb8886b2376e04f67/frscraper-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-24 02:53:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GabrielPastorello",
"github_project": "FRScraper",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "pandas",
"specs": [
[
">=",
"2.2.2"
]
]
},
{
"name": "numpy",
"specs": [
[
">=",
"1.26.4"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
">=",
"2.8.2"
]
]
},
{
"name": "pytz",
"specs": [
[
">=",
"2024.1"
]
]
}
],
"lcname": "frscraper"
}
JSON
