# 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/f4/ca/3fb4fe87ab943a28ab420b5849bdbff82ae9e2f5def0a6d3c6eeeb0bd61b/euroleague_api-0.0.15.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.15",
"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": "d5956c0a21a594b346d759ab5c007d3f1d2ea72e293375eab5d583a80217f40d",
"md5": "c6f5d5625ccd303480a9669511503c4a",
"sha256": "e9d783307b6017905d59baa4a78953ed90b9a5cac481eb62e97b507b46055aaf"
},
"downloads": -1,
"filename": "euroleague_api-0.0.15-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6f5d5625ccd303480a9669511503c4a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 19581,
"upload_time": "2024-12-11T23:21:41",
"upload_time_iso_8601": "2024-12-11T23:21:41.972811Z",
"url": "https://files.pythonhosted.org/packages/d5/95/6c0a21a594b346d759ab5c007d3f1d2ea72e293375eab5d583a80217f40d/euroleague_api-0.0.15-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f4ca3fb4fe87ab943a28ab420b5849bdbff82ae9e2f5def0a6d3c6eeeb0bd61b",
"md5": "43a894d79879605ac64f9323a333704c",
"sha256": "8714a0d8f3a49b1f6e7e393618c08b58a31110c387f12f066295dc2bb71bf043"
},
"downloads": -1,
"filename": "euroleague_api-0.0.15.tar.gz",
"has_sig": false,
"md5_digest": "43a894d79879605ac64f9323a333704c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 14610,
"upload_time": "2024-12-11T23:21:44",
"upload_time_iso_8601": "2024-12-11T23:21:44.266721Z",
"url": "https://files.pythonhosted.org/packages/f4/ca/3fb4fe87ab943a28ab420b5849bdbff82ae9e2f5def0a6d3c6eeeb0bd61b/euroleague_api-0.0.15.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-11 23:21:44",
"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
