# 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/74/27/9fcf33c4b8a02d3d6fd3fd1c5bda35718412a5c0ea119d0ec8aac92bc291/euroleague_api-0.0.16.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.16",
"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": null,
"digests": {
"blake2b_256": "a601698ffb10fb25db458341fc28d4a57c69d3ab2a640eb97c784f3ddc222505",
"md5": "f4dc065bc7b989ae27c6201213dbb5c8",
"sha256": "00e6e96a492d6c20996d34a9f2b214d57368022f70ba1b336441d5d520599026"
},
"downloads": -1,
"filename": "euroleague_api-0.0.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f4dc065bc7b989ae27c6201213dbb5c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 19792,
"upload_time": "2025-01-25T23:22:45",
"upload_time_iso_8601": "2025-01-25T23:22:45.555059Z",
"url": "https://files.pythonhosted.org/packages/a6/01/698ffb10fb25db458341fc28d4a57c69d3ab2a640eb97c784f3ddc222505/euroleague_api-0.0.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "74279fcf33c4b8a02d3d6fd3fd1c5bda35718412a5c0ea119d0ec8aac92bc291",
"md5": "c59b9db0359093872a3e40c261b154b3",
"sha256": "bfb0b5d4fe643c732150418bdd030aae4adf9b3f823c295fbcf62b096aa8941c"
},
"downloads": -1,
"filename": "euroleague_api-0.0.16.tar.gz",
"has_sig": false,
"md5_digest": "c59b9db0359093872a3e40c261b154b3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 14801,
"upload_time": "2025-01-25T23:22:47",
"upload_time_iso_8601": "2025-01-25T23:22:47.173793Z",
"url": "https://files.pythonhosted.org/packages/74/27/9fcf33c4b8a02d3d6fd3fd1c5bda35718412a5c0ea119d0ec8aac92bc291/euroleague_api-0.0.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-25 23:22:47",
"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
