# 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/main/site/euroleague_api/EuroLeagueData.html)
### Game stats
[game_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/game_stats.html)
### Player stats
[player_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/player_stats.html)
### Team stats
[team_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/team_stats.html)
### Standings
[standings.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/standings.html)
### Shot data
[shot_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/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/main/site/euroleague_api/play_by_play_data.html)
### Boxscore data
[boxscore_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/boxscore_data.html)
### Auxiliary functions
[utils.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/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/89/b8/0a074e1c730143268d30f81789ffd7efba9c7bef246d96c32b349892cc54/euroleague_api-0.0.13.tar.gz",
"platform": null,
"description": "# Euroleague API\n\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.\n\n## Installation\n\n```bash\npip install euroleague-api\n```\n\n## Example\n\n```python\nfrom euroleague_api.shot_data import ShotData\n\nseason = 2022\ngame_code = 1\ncompetition_code = \"E\"\n\nshotdata = ShotData(competition_code)\ndf = shotdata.get_game_shot_data(season, game_code)\n```\n\nSee also the `notebooks/get-season-stats.ipynb` notebook for examples.\n\n## Documentation\n\n### Euroleague Data class\n\n[EuroleagueData.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/EuroLeagueData.html)\n\n### Game stats\n\n[game_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/game_stats.html)\n\n### Player stats\n\n[player_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/player_stats.html)\n\n### Team stats\n\n[team_stats.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/team_stats.html)\n\n### Standings\n\n[standings.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/standings.html)\n\n### Shot data\n\n[shot_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/shot_data.html)\n\n### Play-by-play data\n\n[play_by_play_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/play_by_play_data.html)\n\n### Boxscore data\n\n[boxscore_data.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/boxscore_data.html)\n\n### Auxiliary functions\n\n[utils.py](https://htmlpreview.github.io/?https://github.com/giasemidis/euroleague_api/blob/main/site/euroleague_api/utils.html)\n\n## TODO\n\n- Add tests\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python wrapper of the Euroleague API",
"version": "0.0.13",
"project_urls": {
"Download": "https://github.com/giasemidis/euroleague_api/archive/refs/tags/v0.0.13.tar.gz",
"Homepage": "https://github.com/giasemidis/euroleague_api"
},
"split_keywords": [
"euroleague",
" api",
" basketball"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "de24985fcf816f0e53b4cc554290176ff9a629446e838ee806b33432b453f796",
"md5": "dc72ce0af44fae1d40d52634ccd8ff96",
"sha256": "0c8c12118e4df626a175ff37a0365c833c3a23a21a883cf12f4810570c248d65"
},
"downloads": -1,
"filename": "euroleague_api-0.0.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dc72ce0af44fae1d40d52634ccd8ff96",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 19013,
"upload_time": "2024-09-16T22:45:24",
"upload_time_iso_8601": "2024-09-16T22:45:24.730757Z",
"url": "https://files.pythonhosted.org/packages/de/24/985fcf816f0e53b4cc554290176ff9a629446e838ee806b33432b453f796/euroleague_api-0.0.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "89b80a074e1c730143268d30f81789ffd7efba9c7bef246d96c32b349892cc54",
"md5": "cb94f1b800f89e08901e543683d76fdb",
"sha256": "d43b5a542abec7756d515f1f0188435fc0d9662edc39528f196359b8fca92063"
},
"downloads": -1,
"filename": "euroleague_api-0.0.13.tar.gz",
"has_sig": false,
"md5_digest": "cb94f1b800f89e08901e543683d76fdb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 14094,
"upload_time": "2024-09-16T22:45:25",
"upload_time_iso_8601": "2024-09-16T22:45:25.711691Z",
"url": "https://files.pythonhosted.org/packages/89/b8/0a074e1c730143268d30f81789ffd7efba9c7bef246d96c32b349892cc54/euroleague_api-0.0.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-16 22:45:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "giasemidis",
"github_project": "euroleague_api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "euroleague-api"
}
JSON
