A Python script that takes a category from Board Game Geek and posts the contents to Pinterest.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Board Game Geek Scraper

This script takes a category from Board Game Geek and posts the contents to Pinterest.

You will need


  • Download and unzip this repository
  • Open a terminal window and change to the directory with this repository. Example:
cd ~/Downloads/BGG-Scraper/
  • If you don't have Requests and Beautiful Soup already installed, we can do that now:
sudo pip install -r requirements.txt
  • Update the scraper.py script with your Pinterest access token. Look for the line:
    "access_token": "Put your token in these quote marks",
  • Still in the script, update the category ID with the one you want to scrape. Its the number in the URL. Look for the line:
category_id = 1055
board_name = "the name goes in these quote marks"
  • Save the file!
  • Run it! In your terminal:
python scraper.py
  • Keep an eye on it initially. There will be a pause while the list of games is downloaded, then you should start seeing the names of the board games appearing.
  • Go to your Pinterest board - the games are showing up! It's exciting!
  • Keep your computer on and go and have a cup of tea. It'll take a little while to go through all the games.
  • Come back, check that the script reached the end of the list. You might need to tweak some of the parameters if there are more than 1k games in the category.
  • You're done. :)