Created: 2012-03-26 13:50
Updated: 2016-07-02 16:42
License: mit


This is now deprecated since Shelfari has merged with Goodreads.

Build Status Code Climate Gem Version

This gem uses mechanize to scrape content from and simulate an API, because currently there is no official one. Given the nature of obtaining the data, things might break often, so use at your own risk.

Table of contents


gem install shelfari


require 'shelfari'
library =

Get info about a book

myBook = library.book_by_id(5831441)

This returns the following JSON

    "bookid": "5831441",
    "editionid": "7405802",
    "title": "The Girl Who Kicked the Hornet's Nest",
    "author": "Stieg Larsson",
    "cover": "",
    "url": ""


book_by_id(id) #returns information about a book based on id
book_by_isbn(isbn) #returns information about a book based on isbn
user(username) #returns user details
now_reading(username) #returns the books the user is currently reading
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more