docs / goodreads

Goodreads

Books, ratings, reviews and author profiles.

base /goodreads/v14 endpoints

post/goodreads/v1/book_detail1 credit

Fetch full book data from Goodreads by book ID or URL: title, authors, average rating, total ratings and reviews count, star distribution, genres, series, ISBN/ISBN-13/ASIN, publisher, publication year, edition count, plus up to 30 embedded reader reviews.

Parameter		Allowed / range	Description
id	optional	—	Goodreads numeric book id (the digits in /book/show/<id>-slug). Supply `id` OR `url`.
url	optional	—	Full Goodreads book URL — an alternative to `id`.
reviews_limit = 30	optional	1–	Maximum number of reviews to return per book (up to ~30 are embedded on the Goodreads book page; default 30).
include_pii = false	optional	—	If true, do NOT redact reviewer display data (default redacts phone/email, keeps public name).

Try in playground →

post/goodreads/v1/search1 credit

Search for books or authors on Goodreads by title, author name, or keyword → returns matching results with title, author, ISBN, book ID, average rating, and cover URL.

Parameter		Allowed / range	Description
query	required	—	Book/author search text (autocomplete typeahead → results[]).

Try in playground →

post/goodreads/v1/author1 credit

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

Parameter		Allowed / range	Description
id	optional	—	Goodreads numeric author id (the digits in /author/show/<id>). Supply `id` OR `url`.
url	optional	—	Full Goodreads author URL — an alternative to `id`.

Try in playground →

post/goodreads/v1/reviews1 credit

Fetch reader reviews for a book on Goodreads (by ID or URL) → each review includes the user, star rating, full review text, date, likes count, and spoiler flag. Returns up to 30 reviews per request.

Parameter		Allowed / range	Description
id	optional	—	Goodreads numeric book id (the digits in /book/show/<id>-slug). Supply `id` OR `url`.
url	optional	—	Full Goodreads book URL — an alternative to `id`.
reviews_limit = 30	optional	1–	Maximum number of reviews to return per book (up to ~30 are embedded on the Goodreads book page; default 30).
include_pii = false	optional	—	If true, do NOT redact reviewer display data (default redacts phone/email, keeps public name).

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
}