summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorRasmus Luha <rasmus.luha@gmail.com>2022-03-17 18:58:20 +0200
committerRasmus Luha <rasmus.luha@gmail.com>2022-03-17 18:58:20 +0200
commit76350412051aed8af69b5f797e157679f7b8a698 (patch)
tree6d7e3bdc58cbe4ee5cf00e99c98a097ffb825e11 /README.md
parent9d2cb2a1a7b29d167805ce8fad81ae0250d08417 (diff)
Readme update
Diffstat (limited to 'README.md')
-rw-r--r--README.md43
1 files changed, 36 insertions, 7 deletions
diff --git a/README.md b/README.md
index 1176168..286d0be 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,49 @@
# Overview
This project has the functionality to fetch data about NBA and store it in csv format files.
-It also has an API to serve the data. API can be accessed here.
+It also has an API to serve the data. API can be accessed [here](https://luhamus-nba-data.herokuapp.com/).
## How to use
### API
From the api you can fetch data as follows:
* For teams, the endpoint is "/teams" and you can fetch data as follows:
-'''bash
- https//:{api_url}/teams
-'''
+```
+{api_url}/teams
+```
+or just use [this](https://luhamus-nba-data.herokuapp.com/teams).
+
* For player information, the endpoint is "/players/{team_name}
- you can get the team name from fetching the teams data.
- - Examples: Bulls, Celtics, Hawks, Nets, Hornets.
'''
- https//:{api_url}/players/celtics
- https//:{api_url}/players/hawks
+ https//:{api_url}/players/{team_name}
'''
+ - Examples with Bulls, Celtics, Hawks:
+ * [this](https://luhamus-nba-data.herokuapp.com/teams/bulls).
+ * [this](https://luhamus-nba-data.herokuapp.com/teams/celtics).
+ * [this](https://luhamus-nba-data.herokuapp.com/teams/hawks).
- NB: you shouldn't use the "full_name", like "Chicago Bulls".
+### Fetching Data
+Code for fetching data in in directory AllAboutData, where the
+fetched data will also be stored.
+To use the data fetching script, you should clone the repo and do following:
+```bash
+git clone {repo}
+cd {cloned_repo_name}
+python -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+```
+Then you should make a file
+```
+.env
+```
+and add your api key there like this.
+```bash
+API_KEY = {your_api_key}
+```
+You can get yourself the api key from this [link](https://rapidapi.com/theapiguy/api/free-nba/).
+Once you have done that you can use the script.
+```bash
+cd AllAboutData
+python getData.py
+```