Goodreads

List Goodreads review comments

List the comments under a Goodreads review, newest or oldest first, up to 100 in each order.

GET/v1/goodreads/reviews/comments
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
reviewIdstringrequiredquery

Review id: the `id` of a review from the book reviews endpoint, e.g. `kca://review:goodreads/amzn1.gr.review:goodreads.v1.-GjjHy9iBCConbkcwszIsw`.

sortstringoptionalquery

Order: `newest` or `oldest`. The site serves 100 comments in each order, so on a longer thread `oldest` reaches the start. Default `newest`.

one of: newest, oldest

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. Omit it for the first page.

min 1 chars · max 512 chars · pattern: ^[A-Za-z0-9_.~=-]+$

Response fields
26

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no review has this id.

one of: found, not_found

datareviewId
string

The review the comments are under.

datatotalCount
integernullable

Comments on the review, all of them, including any this endpoint cannot reach.

Comments on this page, in the order `sort` asks for.

datacomments[]id
string

Comment id.

datacomments[]text
stringnullable

Comment as plain text.

datacomments[]textHtml
stringnullable

Comment with the site's own formatting (HTML).

Who wrote it; null for a removed account.

datacomments[]authorid
integernullable

Member id.

datacomments[]authorname
stringnullable

Display name.

datacomments[]authorurl
stringnullable

Member profile URL.

datacomments[]authoravatar
stringnullable

Avatar image URL. Link only; the image is not hosted by Social Fetch.

datacomments[]authorisAuthor
booleannullable

Whether the member is a Goodreads author.

datacomments[]createdAt
stringnullable

When it was posted, ISO 8601.

datacomments[]updatedAt
stringnullable

When it was last edited, ISO 8601.

datatruncated
boolean

True when the review has more comments than the 100 the site serves in this order: the list ends early and `totalCount` says how many there are. Ask again with the other `sort` for the other end of the thread.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Pass as `cursor` to get the next page; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/goodreads/reviews/comments?reviewId=kca://review:goodreads/amzn1.gr.review:goodreads.v1.-GjjHy9iBCConbkcwszIsw" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Goodreads review comments.