Author

GoodreadsAuthor

GoodreadsAuthor is a BetterReads object for interfacing with author data from Goodreads.

Properties

• gid: Goodreads id of the author (type: int)
• name: Author’s name (type: string)
• about: Goodreads “about the author” blurb (type: string)
• books: A list of GoodreadsBook objects for each of the author’s credited works (type: list)
• born_at: Author’s date of birth (type: datetime)
• died_at: Author’s date of death (type: datetime)
• fans_count: Author’s number of fans on Goodreads (type: int)
• gender: Author’s gender (type: string)
• hometown: Author’s hometown (type: string)
• link: Link to the author’s Goodreads author page (type: string)
• image_url: Url for an author’s featured image on their Goodreads page (type: string)
• small_image_url: Url for the small version of an author’s featured image on their Goodreads page (type: string)
• influences: A list of other creators the author is influenced by (type: string)
• user: A GoodreadsUser object for the author’s Goodreads user profile (type: GoodreadsUser)
• works_count: A count of the works an author is credited on (type: int)

Usage

You can query Author information from the GoodreadsClient by searching by id.

>>> from betterreads.client import GoodreadsClient

>>> gc = GoodreadsClient('GOODREADS_API_KEY', 'GOODREADS_SECRET')
>>> author = gc.author(2617)
>>> author.name
u'Jonathan Safran Foer'
>>> author.works_count
13
>>> author.books
[Extremely Loud and Incredibly Close, Everything Is Illuminated, ...]