Goodreads Scraper

A python wrapper for goodreads API

View Demo · Documentation · Report Bug · Request Feature

Table of Contents

• 1. Getting Started
  • 1.1. Dependencies
  • 1.2. Installation
• 2. Usage
  • 2.1. Initialize the client
  • 2.2. Search for books
  • 2.3. Search for books
• 3. License
• 4. Contact
• 5. Acknowledgements

1. Getting Started

You will need a Goodreads API key for this to work. Unfortunately, Goodreads is not giving out new keys at this time, so unless you have signed up from a while ago - this wont work for you.

On the launch of the script, you will be prompted for the API key. If you are using windows, you will be prompted to save this key locally for ease (using keypass library).

1.1. Dependencies

All the dependencies should automatically be installed when installing the script. This project heavily relies on the requests library to make the api calls.

1.2. Installation

Install with pip

  pip install akgoodreads

2. Usage

2.1. Initialize the client

import akgoodreads
client = goodreads.Goodreads("<your email>")

2.2. Search for books

With title

client.book("Ender's Game", limit = 5)

or with goodreads ID

client._book_from_id(50)

2.3. Search for books

With title

client.author("Rowling")

or with goodreads ID

client._author_from_id(7995)

3. License

See LICENSE.txt.

4. Contact

Arun Kishore - @rpakishore

Github Link: https://github.com/rpakishore/

5. Acknowledgements

• Awesome README Template
• Banner Maker
• Shields.io
• Carbon