diff --git a/README.md b/README.md index 6daf3fc..bd42e92 100644 --- a/README.md +++ b/README.md @@ -8,29 +8,27 @@ This documentation provides the necessary information to use the NBA Stats API. # [View API Documentation](https://documenter.getpostman.com/view/24232555/2s93shzpR3) - - --- - ### Base URL All URLs referenced in this documentation use the following base URL: -> https://nba-stats-db.herokuapp.com/ +> ### Endpoints Top 20 Scorers by Season Method: `Get` -> https://nba-stats-db.herokuapp.com/api/playerdata/topscorers/total/season/2023/ +> Success Response: `Code: 200` Content: + ``` { "count": 20, @@ -101,22 +99,23 @@ Content: "team": "PHI", "season": 2023 }, - ... - ] -} + ... + ] +} ``` Top 20 Scorers in Playoffs Method: `Get` -> https://nba-stats-db.herokuapp.com/api/playerdata/topscorers/playoffs/2022/ +> Success Response: `Code: 200` Content: + ``` { "count": 20, @@ -187,22 +186,23 @@ Content: "team": "GSW", "season": 2022 }, - ... - ] -} + ... + ] +} ``` Top 20 Assists by Season Method: `Get` -> https://nba-stats-db.herokuapp.com/api/top_assists/totals/2023/ +> Success Response: `Code: 200` Content: + ``` { "count": 20, @@ -273,23 +273,23 @@ Content: "team": "DEN", "season": 2023 }, - ... - ] -} + ... + ] +} ``` Top 20 Assists in Playoffs Method: `Get` -> https://nba-stats-db.herokuapp.com/api/top_assists/playoffs/2022/ - +> Success Response: `Code: 200` Content: + ``` { "count": 20, @@ -360,22 +360,23 @@ Content: "team": "GSW", "season": 2022 }, - ... - ] -} + ... + ] +} ``` Top 20 Rebounders (Total Rebounds) by Season Method: `Get` -> https://nba-stats-db.herokuapp.com/api/top_rebounds/totals/2023/ +> Success Response: `Code: 200` Content: + ``` { "count": 20, @@ -446,9 +447,9 @@ Content: "team": "CHI", "season": 2023 }, - ... - ] -} + ... + ] +} ``` diff --git a/USAGE.md b/USAGE.md new file mode 100644 index 0000000..5a0fbf2 --- /dev/null +++ b/USAGE.md @@ -0,0 +1,5 @@ +# Activate Python Shell + +``` +source venv/bin/activate +``` diff --git a/nba_data/data.py b/nba_data/data.py new file mode 100644 index 0000000..c18e70b --- /dev/null +++ b/nba_data/data.py @@ -0,0 +1 @@ +teams_data = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOK', 'DAL', 'SAS', 'DEN', 'MIN', 'SEA', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] \ No newline at end of file diff --git a/nba_data/nba_scraper_advanced.py b/nba_data/nba_scraper_advanced.py index 2e7ed4b..74e7786 100644 --- a/nba_data/nba_scraper_advanced.py +++ b/nba_data/nba_scraper_advanced.py @@ -6,6 +6,7 @@ from bs4 import BeautifulSoup import csv import json import time +from data import teams_data sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) @@ -27,10 +28,11 @@ from nba_data.models import PlayerAdvancedData # Change MEM to VAN for 2001 and prior. # Change LAC to SDC for 1984 and prior. -teams = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'DAL', 'SAS', 'DEN', 'MIN', 'OKC', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] +teams = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'DAL', 'SAS', 'DEN', 'MIN', 'SEA', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] + season = input('What season? ') -for team in teams: +for team in teams_data: url_make = 'https://www.basketball-reference.com/teams/' + team + '/' + season + '.html' response = requests.get(url_make) diff --git a/nba_data/nba_scraper_playoffs_advanced.py b/nba_data/nba_scraper_playoffs_advanced.py index 9bb8fc4..52a8dc7 100644 --- a/nba_data/nba_scraper_playoffs_advanced.py +++ b/nba_data/nba_scraper_playoffs_advanced.py @@ -6,6 +6,7 @@ from bs4 import BeautifulSoup import csv import json import time +from data import teams_data sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) @@ -29,13 +30,11 @@ from nba_data.models import PlayerPlayoffAdvancedData teams = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'DAL', 'SAS', 'DEN', 'MIN', 'OKC', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] -teams2 = ['HOU' ,'PHI', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'SAS', 'DEN', 'MIN', 'OKC', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] - -team_abbreviations = ['ATL', 'BOS', 'BRK', 'CHI', 'CHO', 'CLE', 'DAL', 'DEN', 'DET', 'GSW', 'HOU', 'IND', 'LAC', 'LAL', 'MEM', 'MIA', 'MIL', 'MIN', 'NOP', 'NYK', 'OKC', 'ORL', 'PHI', 'PHO', 'POR', 'SAC', 'SAS', 'TOR', 'UTA', 'WAS'] - season = input('What season? ') -for team in teams: +teams2 = 'PHI' + +for team in teams2: url_make = 'https://www.basketball-reference.com/teams/' + team + '/' + season + '.html' response = requests.get(url_make) diff --git a/nba_data/nba_scraper_playoffs_totals.py b/nba_data/nba_scraper_playoffs_totals.py index 47853ff..fb002a4 100644 --- a/nba_data/nba_scraper_playoffs_totals.py +++ b/nba_data/nba_scraper_playoffs_totals.py @@ -6,6 +6,7 @@ from bs4 import BeautifulSoup import csv import json import time +from data import teams_data sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) @@ -27,14 +28,11 @@ from nba_data.models import PlayerPlayoffTotalsData # Change LAC to SDC for 1984 and prior. -teams = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'DAL', 'SAS', 'DEN', 'MIN', 'OKC', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] - - -team_abbreviations = ['ATL', 'BOS', 'BRK', 'CHI', 'CHO', 'CLE', 'DAL', 'DEN', 'DET', 'GSW', 'HOU', 'IND', 'LAC', 'LAL', 'MEM', 'MIA', 'MIL', 'MIN', 'NOP', 'NYK', 'OKC', 'ORL', 'PHI', 'PHO', 'POR', 'SAC', 'SAS', 'TOR', 'UTA', 'WAS'] +teams = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'DAL', 'SAS', 'DEN', 'MIN', 'SEA', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] season = input('What season? ') -for team in teams: +for team in teams_data: url_make = 'https://www.basketball-reference.com/teams/' + team + '/' + season + '.html' response = requests.get(url_make) diff --git a/nba_data/nba_scraper_shot_chart.py b/nba_data/nba_scraper_shot_chart.py index fc94fd8..c24bc48 100644 --- a/nba_data/nba_scraper_shot_chart.py +++ b/nba_data/nba_scraper_shot_chart.py @@ -12,10 +12,11 @@ django.setup() from nba_data.models import PlayerShotChartData -player_name = 'James Harden' -season = 2010 -# team = 'LAL' # You might want to find a way to get this from the webpage -url = 'https://www.basketball-reference.com/players/h/hardeja01/shooting/' + \ +player_name = 'Damian Lillard' +season = 2013 + +# Player name and season will be inserted into DB. Modify before running script. +url = 'https://www.basketball-reference.com/players/l/lillada01/shooting/' + \ str(season) response = requests.get(url) diff --git a/nba_data/nba_scraper_totals.py b/nba_data/nba_scraper_totals.py index 600e30a..c81300d 100644 --- a/nba_data/nba_scraper_totals.py +++ b/nba_data/nba_scraper_totals.py @@ -6,6 +6,7 @@ from bs4 import BeautifulSoup import csv import json import time +from data import teams_data sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) @@ -26,14 +27,14 @@ from nba_data.models import PlayerTotalsData # Change MEM to VAN for 2001 and prior. # Change LAC to SDC for 1984 and prior. -teams = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'DAL', 'SAS', 'DEN', 'MIN', 'OKC', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] +teams = ['HOU' ,'PHI', 'BOS', 'NYK', 'NJN', 'TOR', 'MEM', 'NOH', 'DAL', 'SAS', 'DEN', 'MIN', 'SEA', 'UTA', 'POR', 'MIL', 'CLE', 'CHI', 'IND', 'DET', 'SAC', 'PHO', 'GSW', 'LAC', 'LAL', 'MIA', 'ATL', 'WAS', 'ORL', 'CHA'] # team = input('What team? ') # OMIT above. Will now only ask for season and iterate thru teams list. season = input('What season? ') -for team in teams: +for team in teams_data: url_make = 'https://www.basketball-reference.com/teams/' + team + '/' + season + '.html' response = requests.get(url_make)