Ballchasing Stat Scraper in Python

This script is a refactor of another developer's work. Credit will be updated when available.

Setting Up Ballchasing API Key

Windows

1. Open Start and search for "Environment Variables".
2. Click "Edit the System Environment Variables".
3. Click "Environment Variables" at the bottom right corner https://github.com/user-attachments/assets/2e723aa7-2d6e-4b17-a4a0-ffd27b61b4a1
4. Under the Users section, click "New" https://github.com/user-attachments/assets/a59d43ea-9aa3-440c-9369-55e3a98b9712
5. Set Variable Name to BALLCHASING_API_KEY.
6. Set Variable Value to your unique API key.
7. Restart your PC for changes to take effect.

macOS and Linux

• macOS Guide
• Linux Guide

Installing Prerequisites

1. Clone the repository.
2. Run pip install argparse json pandas requests.

Creating URL JSON File

Create a urls.json file in the script directory with your group URLs:

[
    "https://ballchasing.com/group/rtku4-rl-wk9-griffins-vs-pegasus-jah697qbqy"
]

Running the Script

Execute the script from the terminal:

python bc_scraper_refactor.py urls.json

An output directory will be created for the CSV files. Note: Existing CSVs with the same name will be overwritten.