Goodreads Book Reviews API
Every reader review of a book, up to 100 a page, newest or oldest first, by star rating, language or text.
GET /v1/goodreads/books/{bookId}/reviews1 credit Failed requests are free A not-found answer is still charged
About this endpoint
GET /v1/goodreads/books/{bookId}/reviews lists the reader reviews of the book's work, across every edition. sort is default (the site's own ranking), newest or oldest; rating keeps one star rating; language keeps one language such as en; query keeps reviews containing a phrase. limit sets the page size, 1 to 100 (30 by default).
Each review carries id, url, author (with followers and reviewCount), rating (null when the reader left none), text and textHtml, containsSpoilers, likes, commentCount, shelf, the reviewer's own tags, recommendFor, createdAt and updatedAt. totalCount counts the reviews matching the filters. Pass page.nextCursor back as cursor while page.hasMore is true; a cursor only continues the book and filters it was issued for. Pass a review's id to the review comments route for its thread.
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 Reviews API FAQ
Is it every review or just the first page the book page shows?
Every review. The book page shows about 30; this route pages through all of them, up to 100 a call, following page.nextCursor.
Can I change filters halfway through?
No. A cursor belongs to the book, sort and filters it was issued for. Passing it with other filters is refused with HTTP 400; start again without a cursor.
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.
Why is rating null on some reviews?
A reader can write a review without giving stars. rating is 1 to 5 when given, null otherwise.
Other Goodreads endpoints
- BookGET /v1/goodreads/books/{bookId}
- 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