editions-scraper

POST

https://biblioreads.eu.org/api/works/editions

POST

/api/works/editions

$ curl -X POST https://biblioreads.eu.org/api/works/editions \
>      -H "Content-Type: application/json" \
>      -d '{
>   "queryURL": "https://www.goodreads.com/work/editions/1540236"
> }'

200Successful

1 {
2   "status": "Received",
3   "source": "https://github.com/nesaku/biblioreads",
4   "scrapeURL": "https://www.goodreads.com/work/editions/1540236",
5   "book": "The Hobbit, or There and Back Again",
6   "bookURL": "/book/show/5907.The_Hobbit_or_There_and_Back_Again",
7   "author": "J.R.R. Tolkien",
8   "authorURL": "/author/show/656983.J_R_R_Tolkien",
9   "firstPublished": "\n        First published September 21st 1937\n      ",
10   "editions": [
11     {
12       "id": 1,
13       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546071216l/5907._SY75_.jpg",
14       "title": "The Hobbit, or There and Back Again (Paperback)",
15       "url": "/book/show/5907.The_Hobbit_or_There_and_Back_Again",
16       "publishDate": "\n            Published August 15th 2002\n              by Houghton Mifflin\n          ",
17       "editionInfo": "\n          Paperback, 366 pages\n        ",
18       "rating": "\n              4.29\n              \n                (4,213,716 ratings)\n              \n            ",
19       "ISBN": "",
20       "ASIN": "\n                B0DN8P5BQF\n              ",
21       "editionLanguage": "\n                English\n              "
22     },
23     {
24       "id": 2,
25       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1519739410l/38819529._SY75_.jpg",
26       "title": "The Hobbit (Middle Earth, #0)",
27       "url": "/book/show/38819529-the-hobbit",
28       "publishDate": "\n            Published February 15th 2012\n              by Houghton Mifflin Harcourt\n          ",
29       "editionInfo": "\n          75th Anniversary Edition, Kindle Edition, 297 pages\n        ",
30       "rating": "\n              4.48\n              \n                (32,940 ratings)\n              \n            ",
31       "ISBN": "",
32       "ASIN": "\n                B0079KT81G\n              ",
33       "editionLanguage": "\n                English\n              "
34     },
35     {
36       "id": 3,
37       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1390804912l/13512170._SY75_.jpg",
38       "title": "The Hobbit (ebook)",
39       "url": "/book/show/13512170-the-hobbit",
40       "publishDate": "\n            Published February 12th 2012\n              by Houghton Mifflin Harcourt\n          ",
41       "editionInfo": "\n          ebook, 322 pages\n        ",
42       "rating": "\n              4.47\n              \n                (19,263 ratings)\n              \n            ",
43       "ISBN": "",
44       "ASIN": "\n                B0DWTRC2VL\n              ",
45       "editionLanguage": "\n                English\n              "
46     },
47     {
48       "id": 4,
49       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1738628304l/227221._SY75_.jpg",
50       "title": "El hobbit (Paperback)",
51       "url": "/book/show/227221.El_hobbit",
52       "publishDate": "\n            Published December 2001\n              by Distal S R L\n          ",
53       "editionInfo": "\n          Translation, Paperback, 310 pages\n        ",
54       "rating": "\n              4.28\n              \n                (14,417 ratings)\n              \n            ",
55       "ISBN": "\n                  9789505470631\n                  \n                    (ISBN10: 9505470630)\n                  \n              ",
56       "ASIN": "\n                9505470630\n              ",
57       "editionLanguage": "\n                Spanish\n              "
58     },
59     {
60       "id": 5,
61       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1353984686l/16053513._SX50_.jpg",
62       "title": "The Hobbit (Kindle Edition)",
63       "url": "/book/show/16053513-the-hobbit",
64       "publishDate": "\n            Published February 15th 2012\n              by  Houghton Mifflin Harcourt\n          ",
65       "editionInfo": "\n          75th Anniversary Edition - Enhanced Edition, Kindle Edition, 322 pages\n        ",
66       "rating": "\n              4.49\n              \n                (9,802 ratings)\n              \n            ",
67       "ISBN": "\n                  9780547951966\n                  \n                    (ISBN10: 0547951965)\n                  \n              ",
68       "ASIN": "\n                B007978NU6\n              ",
69       "editionLanguage": "\n                English\n              "
70     },
71     {
72       "id": 6,
73       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1627646614l/11047558._SX50_.jpg",
74       "title": "The Hobbit (Kindle Edition)",
75       "url": "/book/show/11047558-the-hobbit",
76       "publishDate": "\n            Published April 20th 2009\n              by HarperCollins\n          ",
77       "editionInfo": "\n          Kindle Edition, 251 pages\n        ",
78       "rating": "\n              4.46\n              \n                (11,291 ratings)\n              \n            ",
79       "ISBN": "",
80       "ASIN": "\n                B002RI9ZY0\n              ",
81       "editionLanguage": "\n                English\n              "
82     },
83     {
84       "id": 7,
85       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1403185960l/15329._SY75_.jpg",
86       "title": "The Hobbit (The Lord of the Rings, #0)",
87       "url": "/book/show/15329.The_Hobbit",
88       "publishDate": "\n            Published July 12th 1986\n              by Del Rey Books\n          ",
89       "editionInfo": "\n          Mass Market Paperback, 306 pages\n        ",
90       "rating": "\n              4.31\n              \n                (11,464 ratings)\n              \n            ",
91       "ISBN": "",
92       "ASIN": "",
93       "editionLanguage": "\n                English\n              "
94     },
95     {
96       "id": 8,
97       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1439554741l/26098210._SY75_.jpg",
98       "title": "The Hobbit (Paperback)",
99       "url": "/book/show/26098210-the-hobbit",
100       "publishDate": "\n            Published October 27th 2011\n              by Harper Collins\n          ",
101       "editionInfo": "\n          75th Anniversary Edition, Paperback, 305 pages\n        ",
102       "rating": "\n              4.29\n              \n                (8,139 ratings)\n              \n            ",
103       "ISBN": "",
104       "ASIN": "\n                B0DT17Q7S1\n              ",
105       "editionLanguage": "\n                English\n              "
106     },
107     {
108       "id": 9,
109       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1661030650l/437049._SY75_.jpg",
110       "title": "The Hobbit, or There and Back Again (Paperback)",
111       "url": "/book/show/437049.The_Hobbit_or_There_and_Back_Again",
112       "publishDate": "\n            Published 1999\n              by Houghton Mifflin\n          ",
113       "editionInfo": "\n          Paperback, 275 pages\n        ",
114       "rating": "\n              4.36\n              \n                (8,907 ratings)\n              \n            ",
115       "ISBN": "\n                  9780618002214\n                  \n                    (ISBN10: 0618002219)\n                  \n              ",
116       "ASIN": "\n                0618002219\n              ",
117       "editionLanguage": "\n                English\n              "
118     },
119     {
120       "id": 10,
121       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1571502511l/42672._SY75_.jpg",
122       "title": "The Hobbit (Paperback)",
123       "url": "/book/show/42672.The_Hobbit",
124       "publishDate": "\n            Published 2006\n              by Harper Collins\n          ",
125       "editionInfo": "\n          Paperback, 353 pages\n        ",
126       "rating": "\n              4.28\n              \n                (6,302 ratings)\n              \n            ",
127       "ISBN": "",
128       "ASIN": "\n                B0DSZS9QSC\n              ",
129       "editionLanguage": "\n                English\n              "
130     }
131   ],
132   "lastScraped": "2026-06-15T00:42:13Z"
133 }

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:

1 {
2   "queryURL": "https://www.goodreads.com/work/editions/1540236"
3 }

Response

200 Success

Returns a JSON object containing all editions of the specified book work.

1 {
2   "status": "Received",
3   "statusCode": 200,
4   ...
5 }

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

## 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:** ```json { "queryURL": "https://www.goodreads.com/work/editions/1540236" } ``` --- ## Response ### 200 Success Returns a JSON object containing all editions of the specified book work. ```json { "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 |

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

bookstring

bookURLstring

authorstring

authorURLstring

firstPublishedstring

editionslist of objects

lastScrapeddatetime

1	{
2	"queryURL": "https://www.goodreads.com/work/editions/1540236"
3	}