List Goodreads book editions
List every edition of a Goodreads book with its format, publisher, language and ISBNs.
Headers
Get your API keyAPI key (`sfk_...`)
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
Rows per page, 1 to 20. Default 20.
≥ 1 · ≤ 20
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_.~=-]+$
Endpoint-specific response payload.
`not_found` when no book has this id.
one of: found, not_found
The book; null when not found.
Book id.
Work id.
Title.
Book page URL.
Editions of the work.
Editions on this page.
Book id of this edition.
Title.
Title with the series.
Edition page URL.
Cover image URL. Link only; not hosted by Social Fetch.
Main author of this edition.
Author id.
Name.
Author page URL.
Credit.
Format, e.g. `Paperback`.
Number of pages.
Publisher.
Publication date, ISO 8601.
Language.
ISBN-10.
ISBN-13.
Amazon ASIN.
Pagination state for the current page.
Whether another page is available.
Pass as `cursor` to get the next page; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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/editions" \
-H "x-api-key: YOUR_API_KEY"Responses
Goodreads book editions.