---
title: "List a Goodreads book's editions"
method: GET
path: "/goodreads/book/{id}/editions"
tags: ["Goodreads"]
---

# List a Goodreads book's editions

`GET /goodreads/book/{id}/editions`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/goodreads/book/{id}/editions`
- Auth: API key in header `x-api-key`

Returns a work's paginated edition list (per-edition book id, format, page count, publication date, publisher, ISBN/ISBN13/ASIN, language, and rating) — every other translation, printing, and format of the requested book id. Goodreads keys editions by a separate "work id", not the book id in the path; requests against a book with no editions data return an upstream error.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoodreadsEditionsResponseDoc
  - `code` integer
  - `data` GoodreadsEditionsResponse
    - `book_id` string: Goodreads book id that was requested.
    - `editions` GoodreadsEdition[]: Editions of the work on this page.
      - `asin` string: Amazon ASIN of the edition.
      - `authors` string[]: Names of the authors credited on the edition.
      - `average_rating` number: Average rating of the edition out of 5.
      - `book_id` string: Goodreads book id of this edition.
      - `format` string: Binding or format of the edition, such as `Hardcover`.
      - `isbn` string: ISBN-10 of the edition.
      - `isbn13` string: ISBN-13 of the edition.
      - `language` string: Language the edition is published in.
      - `pages` integer: Number of pages in the edition.
      - `publication_date` string: Publication date as Goodreads shows it, such as `October 14th 2008`.
      - `publisher` string: Publisher of the edition.
      - `ratings_count` integer: Number of ratings the edition has received.
      - `title` string: Title of the edition.
      - `uri` string: Goodreads URL of the edition's book page.
    - `page` integer: Page number of editions returned.
    - `source_url` string: URL the data was read from.
    - `title` string: Title of the work as shown on the editions page.
    - `work_id` string: Goodreads work id shared by all the editions listed.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)