Goodreads hub

Goodreads Book Editions API

Every edition of a book, with the facts a catalogue needs.

GET /v1/goodreads/books/{bookId}/editions

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

About this endpoint

GET /v1/goodreads/books/{bookId}/editions lists every edition of the book's work, 20 a page (limit 1 to 20). Each edition carries its own book id, title, fullTitle, url, cover, main author with role, format, pages, publisher, publishedAt, language, isbn, isbn13 and asin. totalCount is the number of editions; pass page.nextCursor back as cursor while page.hasMore is true.

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

Does it matter which edition's id I send?

No. Any edition's id lists the same editions, because they share one work. data.book says which id you sent and its workId.

Why are some ISBNs null?

Many editions, ebooks and audiobooks especially, carry no ISBN on the site. isbn, isbn13 and asin are null when the edition has none.

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 the book exists and editions lists them. not_found means no book has this id.