docs / goodreads

Goodreads

Books, ratings, reviews and author profiles.

base /goodreads/v14 endpoints

post/goodreads/v1/book_detail1 credit

full book by `id` OR `url`: title/author(s)/avg_rating/ratings_count/reviews_count/ratings_dist/genres/series/isbn/isbn13/asin/publisher/publish_year+original_year/editions + ~30 embedded reviews. (__NEXT_DATA__ apolloState + ld+json fallback.)

Parameter	Required
id	optional
url	optional
include_pii	optional

Try in playground →

post/goodreads/v1/search1 credit

book/author search via autocomplete typeahead (query → results[]{title,author,isbn,book_id}). (/search HTML SERP is AWS-WAF-walled → Phase-2; typeahead covers query→book.)

Parameter	Required
query	required

Try in playground →

post/goodreads/v1/author1 credit

author by `id` OR `url`: name/avg_rating/born/books/bio (best-effort).

Parameter	Required
id	optional
url	optional

Try in playground →

post/goodreads/v1/reviews1 credit

embedded reviews for a book (`id`|`url`|`book_id`) → reviews[]{user,rating,text,date,likes}. (~30 embedded; deep pagination = Phase-2.)

Parameter	Required
id	optional
url	optional
book_id	optional
include_pii	optional

Try in playground →

Example request · book_detail

curl -X POST https://api.reefapi.com/goodreads/v1/book_detail \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"id":"2767052"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}