A script for backing up reviews from your Goodreads account
Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
LICENSE
README.rst
backup_goodreads.py
requirements.txt

README.rst

backup-goodreads

This is a Python script for backing up your reviews from Goodreads. It mimics the export function provided by Goodreads, but in script form.

Installation

This script can run in Python 2 or Python 3. Create a virtualenv and install dependencies:

$ git clone git@github.com:alexwlchan/backup-goodreads.git
$ virtualenv env
$ source env/bin/activate
$ pip install -r requirements.txt

You need to set up two things before you can use the script:

  1. Make your Goodreads reviews public. This script only uses the basic API, not OAuth, and so private reviews can't be backed up.
  2. Get your Goodreads user ID. This is the 8-digit number in the URL of your profile page. For example, if your user page was https://www.goodreads.com/user/show/12345678-john-smith, then your user ID is 12345678.
  3. Get a developer API key from the Goodreads website.

Usage

Run the script, passing your user ID and API key as command-line flags:

$ python backup_goodreads.py --user-id=12345678 --api-key=abcdefg123

This will write your Goodreads reviews to goodreads_reviews.json.

License

This script is licensed under the MIT license.