# Euroleague API
This is a python package of the Euroleague API for the *Euroleague* and *EuroCup* leagues. The API endpoints were found on the [swagger platform](https://api-live.euroleague.net/swagger/index.html), with the addition of a few more API endpoints (e.g. shot data) found on blogs and discussions. More endpoints will be added.
## Installation
```bash
pip install euroleague-api
```
## Example
```python
from euroleague_api.shot_data import ShotData
season = 2022
game_code = 1
competition_code = "E"
shotdata = ShotData(competition_code)
df = shotdata.get_game_shot_data(season, game_code)
```
See also the `notebooks/get-season-stats.ipynb` notebook for examples.
## Documentation
### Euroleague Data class
[EuroleagueData.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/EuroLeagueData.html)
### Game stats
[game_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/game_stats.html)
### Player stats
[player_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/player_stats.html)
### Team stats
[team_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/team_stats.html)
### Standings
[standings.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/standings.html)
### Shot data
[shot_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/shot_data.html)
### Play-by-play data
[play_by_play_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/play_by_play_data.html)
### Boxscore data
[boxscore_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/boxscore_data.html)
### Auxiliary functions
[utils.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/utils.html)
## TODO
- Add tests
Raw data
{
"_id": null,
"home_page": "https://github.com/giasemidis/euroleague_api",
"name": "euroleague-api",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "euroleague, api, basketball",
"author": "Georgios Giasemidis",
"author_email": "g.giasemidis@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3d/92/f372cc4f910e7e71228a9898fbd6d69d4fe33eeb5b954748cb2cb4dfad35/euroleague_api-0.0.11.tar.gz",
"platform": null,
"description": "# Euroleague API\r\n\r\nThis is a python package of the Euroleague API for the *Euroleague* and *EuroCup* leagues. The API endpoints were found on the [swagger platform](https://api-live.euroleague.net/swagger/index.html), with the addition of a few more API endpoints (e.g. shot data) found on blogs and discussions. More endpoints will be added.\r\n\r\n## Installation\r\n\r\n```bash\r\npip install euroleague-api\r\n```\r\n\r\n## Example\r\n\r\n```python\r\nfrom euroleague_api.shot_data import ShotData\r\n\r\nseason = 2022\r\ngame_code = 1\r\ncompetition_code = \"E\"\r\n\r\nshotdata = ShotData(competition_code)\r\ndf = shotdata.get_game_shot_data(season, game_code)\r\n```\r\n\r\nSee also the `notebooks/get-season-stats.ipynb` notebook for examples.\r\n\r\n## Documentation\r\n\r\n### Euroleague Data class\r\n\r\n[EuroleagueData.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/EuroLeagueData.html)\r\n\r\n### Game stats\r\n\r\n[game_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/game_stats.html)\r\n\r\n### Player stats\r\n\r\n[player_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/player_stats.html)\r\n\r\n### Team stats\r\n\r\n[team_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/team_stats.html)\r\n\r\n### Standings\r\n\r\n[standings.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/standings.html)\r\n\r\n### Shot data\r\n\r\n[shot_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/shot_data.html)\r\n\r\n### Play-by-play data\r\n\r\n[play_by_play_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/play_by_play_data.html)\r\n\r\n### Boxscore data\r\n\r\n[boxscore_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/boxscore_data.html)\r\n\r\n### Auxiliary functions\r\n\r\n[utils.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/refactor-class-comp/site/euroleague_api/utils.html)\r\n\r\n## TODO\r\n\r\n- Add tests\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python wrapper of the Euroleague API",
"version": "0.0.11",
"project_urls": {
"Download": "https://github.com/giasemidis/euroleague_api/archive/refs/tags/v0.0.11.tar.gz",
"Homepage": "https://github.com/giasemidis/euroleague_api"
},
"split_keywords": [
"euroleague",
" api",
" basketball"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c9db7e14a6e55e034159a0ed136c9a57ea462497df5206eaf73be208ee5c19ce",
"md5": "525384bc11151b85ebf93d8b339e6ff2",
"sha256": "d8bd7f5e85497abe8ee3d6c9a87c1959ff91fa2c6079e73ff93db1181ca8ddcc"
},
"downloads": -1,
"filename": "euroleague_api-0.0.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "525384bc11151b85ebf93d8b339e6ff2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 16670,
"upload_time": "2024-04-07T23:29:31",
"upload_time_iso_8601": "2024-04-07T23:29:31.517172Z",
"url": "https://files.pythonhosted.org/packages/c9/db/7e14a6e55e034159a0ed136c9a57ea462497df5206eaf73be208ee5c19ce/euroleague_api-0.0.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3d92f372cc4f910e7e71228a9898fbd6d69d4fe33eeb5b954748cb2cb4dfad35",
"md5": "a990a939f1a531ba2ab2020cd4fb880c",
"sha256": "67d368be9c91959eb59c8cc403ad7fc3abee2b046957e674182aeca175bf9050"
},
"downloads": -1,
"filename": "euroleague_api-0.0.11.tar.gz",
"has_sig": false,
"md5_digest": "a990a939f1a531ba2ab2020cd4fb880c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 11797,
"upload_time": "2024-04-07T23:29:32",
"upload_time_iso_8601": "2024-04-07T23:29:32.767081Z",
"url": "https://files.pythonhosted.org/packages/3d/92/f372cc4f910e7e71228a9898fbd6d69d4fe33eeb5b954748cb2cb4dfad35/euroleague_api-0.0.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-07 23:29:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "giasemidis",
"github_project": "euroleague_api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": []
},
{
"name": "pandas",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "mypy",
"specs": []
},
{
"name": "pandas-stubs",
"specs": []
},
{
"name": "pre-commit",
"specs": []
},
{
"name": "nbstripout",
"specs": []
},
{
"name": "xmltodict",
"specs": []
},
{
"name": "tqdm",
"specs": []
},
{
"name": "twine",
"specs": []
},
{
"name": "pdocs",
"specs": []
},
{
"name": "build",
"specs": []
}
],
"lcname": "euroleague-api"
}
JSON
