# NBA Summer League Headshots
Get NBA Summer League player headshots
## Installation
```bash
pip install nba-summer-league-headshots
```
## Basic
```python
from nba_summer_league_headshots import get_headshot, get_headshots
# Get one player's headshot
image_path = get_headshot("Bronny James")
print(f"Saved to: {image_path}")
# Get multiple players' headshots
players = ["Bronny James", "Dalton Knecht", "Reed Sheppard"]
result = get_headshots(players)
print(f"Downloaded: {result['total_found']} players to {result['output_dir']}")
```
## Advanced
```python
from nba_summer_league_headshots import GLeagueAPI
api = GLeagueAPI()
# List all available players
all_players = api.list_all_players()
print(f"Total players: {len(all_players)}")
# Get all players from a specific team
hawks_players = api.get_team("Atlanta Hawks")
for player in hawks_players:
print(f"{player['name']} - {player['team']}")
# Search for players by name
james_players = api.search_players("James")
print(f"Players with 'James': {james_players}")
# Copy individual headshots with custom directory
headshot_path = api.copy_headshot("Bronny James", "./my_custom_folder")
# Batch download multiple players' headshots
result = api.batch_download(["Bronny James", "Dalton Knecht"], output_dir="./my_custom_folder")
```
## Command Line
```bash
# Download player headshots
nba-headshots -d "Bronny James" "Dalton Knecht"
# Search players
nba-headshots -s "James"
# List team players
nba-headshots -t "Atlanta Hawks"
# See all options
nba-headshots --help
```
## Example
```python
from nba_summer_league_headshots import GLeagueAPI
api = GLeagueAPI()
# List all available players
all_players = api.list_all_players()
result = api.batch_download(all_players, output_dir="./my_custom_folder")
```
## API Reference
### Simple Functions
- `get_headshot(player_name, output_dir="./headshots")` → Save one player's image
- `get_headshots(player_names, output_dir="./headshots")` → Save multiple players' images
### Advanced API (GLeagueAPI)
- `list_all_players()` → Get list of all players
- `get_team(team_name)` → Get all players from a specific NBA team -> type: string
- `search_players(query)` → Find players by name -> type: string
- `copy_headshot(name, output_dir)` → Copy single player to custom directory -> type: string, output_dir: string
- `batch_download(names, output_dir)` → Download multiple with detailed results -> type: list, output_dir: string
Raw data
{
"_id": null,
"home_page": "https://github.com/BuddyBob/summer_league_headshot_api",
"name": "nba-summer-league-headshots",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "nba, basketball, headshots, summer league, sports, api",
"author": "Thavas Antonio",
"author_email": "Thavas Antonio <thavasantonio@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/7e/c7/273f686cd91055dd330b3ba347dc801b531893f73f69671bd74a303431e4/nba_summer_league_headshots-1.0.2.tar.gz",
"platform": null,
"description": "# NBA Summer League Headshots\n\nGet NBA Summer League player headshots \n\n## Installation\n\n```bash\npip install nba-summer-league-headshots\n```\n\n## Basic\n\n```python\nfrom nba_summer_league_headshots import get_headshot, get_headshots\n\n# Get one player's headshot\nimage_path = get_headshot(\"Bronny James\")\nprint(f\"Saved to: {image_path}\")\n\n# Get multiple players' headshots \nplayers = [\"Bronny James\", \"Dalton Knecht\", \"Reed Sheppard\"]\nresult = get_headshots(players)\nprint(f\"Downloaded: {result['total_found']} players to {result['output_dir']}\")\n```\n\n\n## Advanced \n\n\n```python\nfrom nba_summer_league_headshots import GLeagueAPI\n\napi = GLeagueAPI()\n\n# List all available players\nall_players = api.list_all_players()\nprint(f\"Total players: {len(all_players)}\")\n\n# Get all players from a specific team\nhawks_players = api.get_team(\"Atlanta Hawks\")\nfor player in hawks_players:\n print(f\"{player['name']} - {player['team']}\")\n\n# Search for players by name\njames_players = api.search_players(\"James\")\nprint(f\"Players with 'James': {james_players}\")\n\n# Copy individual headshots with custom directory\nheadshot_path = api.copy_headshot(\"Bronny James\", \"./my_custom_folder\")\n\n# Batch download multiple players' headshots\nresult = api.batch_download([\"Bronny James\", \"Dalton Knecht\"], output_dir=\"./my_custom_folder\")\n\n```\n\n\n## Command Line\n\n```bash\n# Download player headshots\nnba-headshots -d \"Bronny James\" \"Dalton Knecht\"\n\n# Search players \nnba-headshots -s \"James\"\n\n# List team players\nnba-headshots -t \"Atlanta Hawks\"\n\n# See all options\nnba-headshots --help\n```\n\n## Example\n```python\nfrom nba_summer_league_headshots import GLeagueAPI\n\napi = GLeagueAPI()\n\n# List all available players\nall_players = api.list_all_players()\nresult = api.batch_download(all_players, output_dir=\"./my_custom_folder\")\n\n```\n\n\n## API Reference\n\n### Simple Functions\n- `get_headshot(player_name, output_dir=\"./headshots\")` \u2192 Save one player's image\n- `get_headshots(player_names, output_dir=\"./headshots\")` \u2192 Save multiple players' images\n\n### Advanced API (GLeagueAPI)\n- `list_all_players()` \u2192 Get list of all players \n- `get_team(team_name)` \u2192 Get all players from a specific NBA team -> type: string\n- `search_players(query)` \u2192 Find players by name -> type: string\n- `copy_headshot(name, output_dir)` \u2192 Copy single player to custom directory -> type: string, output_dir: string\n- `batch_download(names, output_dir)` \u2192 Download multiple with detailed results -> type: list, output_dir: string\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "NBA Summer League 2025 Player Headshots API - Access 431+ verified player images",
"version": "1.0.2",
"project_urls": {
"Bug Reports": "https://github.com/BuddyBob/summer_league_headshot_api/issues",
"Homepage": "https://github.com/BuddyBob/summer_league_headshot_api",
"Source": "https://github.com/BuddyBob/summer_league_headshot_api"
},
"split_keywords": [
"nba",
" basketball",
" headshots",
" summer league",
" sports",
" api"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8988cce12d1c0d4d03c28ef78256b90953b071736d346c7d851010a48d485a77",
"md5": "1e2728fe70b0e9cf1b189d9369e3d205",
"sha256": "41c0f6662e94bed13e287bfaa60fc46178ae78959b81efbd2693a1c137043d9e"
},
"downloads": -1,
"filename": "nba_summer_league_headshots-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1e2728fe70b0e9cf1b189d9369e3d205",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 12777639,
"upload_time": "2025-07-29T00:31:54",
"upload_time_iso_8601": "2025-07-29T00:31:54.864258Z",
"url": "https://files.pythonhosted.org/packages/89/88/cce12d1c0d4d03c28ef78256b90953b071736d346c7d851010a48d485a77/nba_summer_league_headshots-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7ec7273f686cd91055dd330b3ba347dc801b531893f73f69671bd74a303431e4",
"md5": "835497a8c6470ab7c438cfe3f8e1f8bf",
"sha256": "09909b3a2b063d957b1ec107cac8b536bc9680d465feaf3ced35dc25331a4355"
},
"downloads": -1,
"filename": "nba_summer_league_headshots-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "835497a8c6470ab7c438cfe3f8e1f8bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 12465150,
"upload_time": "2025-07-29T00:31:57",
"upload_time_iso_8601": "2025-07-29T00:31:57.745302Z",
"url": "https://files.pythonhosted.org/packages/7e/c7/273f686cd91055dd330b3ba347dc801b531893f73f69671bd74a303431e4/nba_summer_league_headshots-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-29 00:31:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BuddyBob",
"github_project": "summer_league_headshot_api",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nba-summer-league-headshots"
}
JSON
