Review¶
GoodreadsReview¶
Betterreads interface for interacting with Goodreads review data.
Properties¶
- gid: Goodreads review id (type: int)
- book: Dict with information on the book the review belongs to (type: dict)
- rating: Review rating from 1 - 5 “stars” (type: int)
- shelves: Most common shelf names that contain this book (type: list)
- recommended_for: dict of users recommended for (type: dict)
- recommended_by: dict of users recommended by (type: dict)
- started_at: String representation of the date the user started reading the book (type: datetime)
- read_at: String representation of the date the user finished reading the book (type: datetime)
- body: Text body of the review (type: string)
- comments_count: Number of comments on the review (type: int)
- url: Link to the review on Goodreads (type: string)
- owned: boolean value (expressed as “0” or “1”) whether the user owns this book (type: boolean)
Usage¶
You can query Reviews by id using the GoodreadsClient.
>>> from betterreads.client import GoodreadsClient
>>> gc = GoodreadsClient('GOODREADS_API_KEY', 'GOODREADS_SECRET')
>>> review = gc.review(1)
>>> review.body
u'I was lukewarm on this book'
>>> review.owned
False