> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/goodreads/books-bookid-reviews>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/goodreads/books-bookid-reviews.mdx>

---

# 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}/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.

## Request

- **Endpoint:** `GET /v1/goodreads/books/{bookId}/reviews`
- **Credits:** 1 credit
Failed requests are free
A not-found answer is still charged
- **Input:** by book id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/goodreads/books/bookid/reviews/get)
- **Platform page:** [/platforms/goodreads](https://www.socialfetch.dev/platforms/goodreads)

## 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.
