Goodreads hub

Goodreads Review Comments API

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

GET /v1/goodreads/reviews/comments

1 credit Failed requests are free A not-found answer is still charged

About this endpoint

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.

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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Goodreads Review Comments API 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.