This is a Python script for backing up your reviews from Goodreads. It mimics the export function provided by Goodreads, but in script form.
This script can run in Python 2 or Python 3. Create a virtualenv and install dependencies:
$ git clone email@example.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:
- Make your Goodreads reviews public. This script only uses the basic API, not OAuth, and so private reviews can't be backed up.
- 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
- Get a developer API key from the Goodreads website.
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
This script is licensed under the MIT license.