> **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/reviews-comments>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/goodreads/reviews-comments.mdx>

---

# Goodreads Review Comments API

The comment thread under a review, newest or oldest first.

`GET /v1/goodreads/reviews/comments` takes `reviewId`, the `id` of a review from the book reviews route (for example `kca://review:goodreads/amzn1.gr.review:goodreads.v1.-GjjHy9iBCConbkcwszIsw`; the last segment alone also works). It returns `totalCount` and `comments`, 10 a page, newest first (`sort=oldest` for oldest first), each with `id`, `text`, `textHtml`, `author` (`id`, `name`, `url`, `avatar`, `isAuthor`), `createdAt` and `updatedAt`. Pass `page.nextCursor` back as `cursor`, with the same `sort`, while `page.hasMore` is true. The site serves 100 comments in each order, so `truncated` is true on a longer thread: read its newest 100, then its oldest 100.

## Request

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

## FAQ

### Where do I get a reviewId?

From the id of any review returned by GET /v1/goodreads/books/{bookId}/reviews. The numeric id in a review page URL is not accepted.

### What if the review has no comments?

lookupStatus is found, totalCount is 0 and comments is empty. An id that matches no review returns not_found.

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

### Can I get every comment on a long thread?

Up to 200 of them. The site serves the newest 100 and the oldest 100 comments of a thread, so on a review with more, truncated is true and totalCount gives the full count. Read it with sort=newest, then with sort=oldest; the comments in the middle are not served.

### Why only 10 comments a page?

That is the most the site serves per page. Follow page.nextCursor for the rest of the thread.
