works
editions-scraper
Editions Scraper
Scrapes all available editions of a specific book work from its Goodreads editions page using a direct work editions URL. Returns structured metadata about each edition including format, language, publisher, and ISBN details.
Request
Method: POST
URL: {{Instance Domain}}/api/works/editions
Headers
| Key | Value | Description |
|---|---|---|
| Content-Type | application/json | Indicates the request body is JSON |
Body
| Field | Type | Required | Description |
|---|---|---|---|
| queryURL | string | Yes | The full Goodreads work editions page URL (e.g. https://www.goodreads.com/work/editions/1540236) |
Example Body:
{
"queryURL": "https://www.goodreads.com/work/editions/1540236"
}
Response
200 Success
Returns a JSON object containing all editions of the specified book work.
{
"status": "Received",
"statusCode": 200,
...
}
Response Field Descriptions
| Field | Type | Description |
|---|---|---|
| status | string | Human-readable status message |
| statusCode | number | HTTP status code of the scrape operation |
| scrapeURL | string | The Goodreads URL that was scraped |
| editions | array | List of editions of the book |
| editions[].title | string | Title of the edition |
| editions[].format | string | Format of the edition (e.g. Hardcover, Paperback, ebook) |
| editions[].language | string | Language the edition is published in |
| editions[].publisher | string | Publisher of the edition |
| editions[].isbn | string | ISBN identifier for the edition |
| editions[].coverImage | string | URL of the edition cover image |
post/api/works/editions
Request body
Response
OK