Goodreads

List Goodreads book reviews

List the reader reviews of a Goodreads book across its editions, with ratings and likes.

GET/v1/goodreads/books/{bookId}/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
7
bookIdintegerrequiredpath

Goodreads book id: the number in the page URL, e.g. `2767052`. A slug such as `2767052-the-hunger-games` or the full URL also works.

≥ 1 · ≤ 2147483647

sortstringoptionalquery

Order: `default` (the site's own ranking), `newest` or `oldest`. Default `default`.

one of: default, newest, oldest

ratingintegeroptionalquery

Only reviews with this star rating, 1 to 5. Omit for all.

≥ 1 · ≤ 5

languagestringoptionalquery

Only reviews in this language, as a two-letter code such as `en` or `es`.

pattern: ^[A-Za-z]{2,3}$

querystringoptionalquery

Only reviews that contain this text, up to 100 characters.

min 1 chars · max 100 chars

limitintegeroptionalquery

Rows per page, 1 to 100. Default 30.

≥ 1 · ≤ 100

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
40

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no book has this id.

one of: found, not_found

The book; null when not found.

databookid
integer

Book id.

databookworkId
integernullable

Work id.

databooktitle
stringnullable

Title.

databookurl
stringnullable

Book page URL.

datatotalCount
integernullable

Reviews matching the filters, across every edition.

Reviews on this page.

datareviews[]id
string

Review id. Pass it as `reviewId` to the review comments endpoint.

datareviews[]url
stringnullable

Review page URL.

Who wrote it; null for a removed account.

datareviews[]authorid
integernullable

Member id.

datareviews[]authorname
stringnullable

Display name.

datareviews[]authorurl
stringnullable

Member profile URL.

datareviews[]authoravatar
stringnullable

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

datareviews[]authorisAuthor
booleannullable

Whether the member is a Goodreads author.

datareviews[]authorfollowers
integernullable

Followers.

datareviews[]authorreviewCount
integernullable

Text reviews the member has written.

datareviews[]rating
integernullable

Star rating, 1 to 5; null when the review has none.

datareviews[]text
stringnullable

Review text as plain text.

datareviews[]textHtml
stringnullable

Review text with the site's own formatting (HTML).

datareviews[]containsSpoilers
boolean

Whether the reviewer marked it as containing spoilers.

datareviews[]likes
integernullable

Likes.

datareviews[]commentCount
integernullable

Comments.

datareviews[]shelf
stringnullable

Shelf the reviewer put the book on, e.g. `read`.

The reviewer's own shelves for the book.

datareviews[]tags[]
stringoptional
datareviews[]recommendFor
stringnullable

Who the reviewer recommends it to.

datareviews[]createdAt
stringnullable

When it was posted, ISO 8601.

datareviews[]updatedAt
stringnullable

When it was last edited, ISO 8601.

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/books/2767052/reviews" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Goodreads book reviews.