Goodreads hub

Goodreads Book API

One book as typed JSON: authors, series, genres, edition facts and the full rating summary.

GET /v1/goodreads/books/{bookId}

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

About this endpoint

GET /v1/goodreads/books/{bookId} takes the number from the book URL, for example 2767052 for The Hunger Games (2767052-the-hunger-games or the full URL also work). On data.lookupStatus: found, data.book carries id, workId, url, title, fullTitle, originalTitle, description (plain text) and descriptionHtml, cover, authors, series, genres, format, pages, publisher, publishedAt, firstPublishedAt, language, isbn, isbn13, asin, rating, awards, places, characters, quotesCount and questionsCount.

authors lists the main author first with image, followers and worksCount, then translators, illustrators and other credits with their role. rating covers every edition of the work: average, count, reviewCount, a five-value distribution (1 star first) and reviewsByLanguage. workId is shared by every edition; pass the book id to the editions route to list them.

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 Book API FAQ

Which inputs does the book route take?

Only the book id from the Goodreads URL, for example 2767052. The slug form 2767052-the-hunger-games or the full book URL is accepted and reduced to the number. Anything else is refused before any request is made.

Are the ratings for this edition or for the book?

For the book across all its editions: rating.average, rating.count and the distribution are the work's totals, as the book page shows them. format, pages, publisher, publishedAt and the ISBNs describe the edition the id names.

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.

What does lookupStatus mean here?

found means data.book is the book. not_found means no book has this id, and data.book is null. HTTP 200 only means the request finished.