Goodreads

List Goodreads book editions

List every edition of a Goodreads book with its format, publisher, language and ISBNs.

GET/v1/goodreads/books/{bookId}/editions
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
bookIdintegerrequiredpath

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

limitintegeroptionalquery

Rows per page, 1 to 20. Default 20.

≥ 1 · ≤ 20

cursorstringoptionalquery

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_.~=-]+$

Response fields
36

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no book has this id.

one of: found, not_found

The book; null when not found.

databookid
integer

Book id.

databookworkId
integernullable

Work id.

databooktitle
stringnullable

Title.

databookurl
stringnullable

Book page URL.

datatotalCount
integernullable

Editions of the work.

Editions on this page.

dataeditions[]id
integer

Book id of this edition.

dataeditions[]title
string

Title.

dataeditions[]fullTitle
stringnullable

Title with the series.

dataeditions[]url
string

Edition page URL.

dataeditions[]cover
stringnullable

Cover image URL. Link only; not hosted by Social Fetch.

Main author of this edition.

dataeditions[]authorid
integernullable

Author id.

dataeditions[]authorname
string

Name.

dataeditions[]authorurl
stringnullable

Author page URL.

dataeditions[]authorrole
stringnullable

Credit.

dataeditions[]format
stringnullable

Format, e.g. `Paperback`.

dataeditions[]pages
integernullable

Number of pages.

dataeditions[]publisher
stringnullable

Publisher.

dataeditions[]publishedAt
stringnullable

Publication date, ISO 8601.

dataeditions[]language
stringnullable

Language.

dataeditions[]isbn
stringnullable

ISBN-10.

dataeditions[]isbn13
stringnullable

ISBN-13.

dataeditions[]asin
stringnullable

Amazon ASIN.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Pass as `cursor` to get the next page; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.