harjoc / goodreads-group-books Goto Github PK

This lists the books of a Goodreads group's members, and sorts them by number of reads. Use it to search for the most read books in groups that are close to your interests.

You will need a free developer key from goodreads.com.

Needs python 3.x and goodreads bindings:

pip install goodreads

A complete result for a group with 3000 members is here: http://patraulea.com/goodreads/shelves_romania%20topbooks.html

1. Copy config-example.py to config.py and fill in the API key.

2. Get the group members: listbooks.py users. This saves them to group-id-users.json.

3. Get the books: listbooks.py books. This saves group-id/user-id.json for each user in group-id-users.json.

4. Sort by number of reads: sort.py > output.html.

There is a default of min_reads = 5 in sort.py so books with less reads don't show up in the output. You can change it as needed.