Goodreads Book API
One book as typed JSON: authors, series, genres, edition facts and the full rating summary.
GET /v1/goodreads/books/{bookId}1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/goodreads/books/{bookId} takes the number from the book URL, for example 2767052 for The Hunger Games (2767052-the-hunger-games or the full URL also work). On data.lookupStatus: found, data.book carries id, workId, url, title, fullTitle, originalTitle, description (plain text) and descriptionHtml, cover, authors, series, genres, format, pages, publisher, publishedAt, firstPublishedAt, language, isbn, isbn13, asin, rating, awards, places, characters, quotesCount and questionsCount.
authors lists the main author first with image, followers and worksCount, then translators, illustrators and other credits with their role. rating covers every edition of the work: average, count, reviewCount, a five-value distribution (1 star first) and reviewsByLanguage. workId is shared by every edition; pass the book id to the editions route to list them.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Goodreads Book API FAQ
Which inputs does the book route take?
Only the book id from the Goodreads URL, for example 2767052. The slug form 2767052-the-hunger-games or the full book URL is accepted and reduced to the number. Anything else is refused before any request is made.
Are the ratings for this edition or for the book?
For the book across all its editions: rating.average, rating.count and the distribution are the work's totals, as the book page shows them. format, pages, publisher, publishedAt and the ISBNs describe the edition the id names.
How many credits does a call cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
What does lookupStatus mean here?
found means data.book is the book. not_found means no book has this id, and data.book is null. HTTP 200 only means the request finished.
Other Goodreads endpoints
- Book reviewsGET /v1/goodreads/books/{bookId}/reviews
- Book editionsGET /v1/goodreads/books/{bookId}/editions
- Review commentsGET /v1/goodreads/reviews/comments
- Book searchGET /v1/goodreads/search
- SeriesGET /v1/goodreads/series/{seriesId}
- AuthorGET /v1/goodreads/authors/{authorId}
- Author booksGET /v1/goodreads/authors/{authorId}/books
- QuotesGET /v1/goodreads/quotes