Goodreads export

The built-in export tool on Goodreads doesn't include all of your information. This has been an issue for years.

This project aims to generate better exports via screen scraping. Simply specify your list ID and a JSON export will be generated.

Output

An Extract object. For a full connected "graph" of reviews and metadata, see reviewsFromExtract.

Installation

npm install -g goodreads-export

Usage

By default, the extract will be printed to stdout. To save the output to a file, pipe the output.

goodreads-export {list_id} > goodreads_extract.json

To find {list_id}, navigate to My Books while logged in to Goodreads. The URL of that page contains the ID. For example,

https://www.goodreads.com/review/list/{list_id}?shelf=%23ALL%23