quotes-scraper

POST

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

POST

/api/works/quotes

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

200Successful

1 {
2   "status": "Received",
3   "source": "https://github.com/nesaku/biblioreads",
4   "scrapeURL": "https://www.goodreads.com/work/quotes/1540236",
5   "bookURL": "/book/show/5907.The_Hobbit_or_There_and_Back_Again",
6   "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546071216l/5907._SY75_.jpg",
7   "name": "The Hobbit, or There and Back Again Quotes",
8   "quotes": [
9     {
10       "id": 1,
11       "text": "\n      “Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on?”\n    \n ",
12       "author": "\n    J.R.R. Tolkien,\n  ",
13       "book": "The Hobbit, or There and Back Again",
14       "likes": "4609 likes"
15     },
16     {
17       "id": 2,
18       "text": "\n      “There is nothing like looking, if you want to find something. You certainly usually find something, if you look, but it is not always quite the something you were after.”\n    \n ",
19       "author": "\n    J.R.R. Tolkien,\n  ",
20       "book": "The Hobbit, or There and Back Again",
21       "likes": "2683 likes"
22     },
23     {
24       "id": 3,
25       "text": "\n      “In a hole in the ground there lived a hobbit.”\n    \n ",
26       "author": "\n    J.R.R. Tolkien,\n  ",
27       "book": "The Hobbit, or There and Back Again",
28       "likes": "2247 likes"
29     },
30     {
31       "id": 4,
32       "text": "\n      “Far over the misty mountains coldTo dungeons deep and caverns oldWe must away ere break of dayTo seek the pale enchanted gold.The dwarves of yore made mighty spells,While hammers fell like ringing bellsIn places deep, where dark things sleep,In hollow halls beneath the fells.For ancient king and elvish lordThere many a gleaming golden hoardThey shaped and wrought, and light they caughtTo hide in gems on hilt of sword.On silver necklaces they strungThe flowering stars, on crowns they hungThe dragon-fire, in twisted wireThey meshed the light of moon and sun.Far over the misty mountains coldTo dungeons deep and caverns oldWe must away, ere break of day,To claim our long-forgotten gold.Goblets they carved there for themselvesAnd harps of gold; where no man delvesThere lay they long, and many a songWas sung unheard by men or elves.The pines were roaring on the height,The wind was moaning in the night.The fire was red, it flaming spread;The trees like torches blazed with light.The bells were ringing in the daleAnd men looked up with faces pale;The dragon's ire more fierce than fireLaid low their towers and houses frail.The mountain smoked beneath the moon;The dwarves, they heard the tramp of doom.They fled their hall to dying fallBeneath his feet, beneath the moon.Far over the misty mountains grimTo dungeons deep and caverns dimWe must away, ere break of day,To win our harps and gold from him!”\n    \n ",
33       "author": "\n    J.R.R. Tolkien,\n  ",
34       "book": "The Hobbit, or There and Back Again",
35       "likes": "1994 likes"
36     },
37     {
38       "id": 5,
39       "text": "\n      “So comes snow after fire, and even dragons have their endings.”\n    \n ",
40       "author": "\n    J.R.R. Tolkien,\n  ",
41       "book": "The Hobbit, or There and Back Again",
42       "likes": "1885 likes"
43     },
44     {
45       "id": 6,
46       "text": "\n      “May the wind under your wings bear you where the sun sails and the moon walks.”\n    \n ",
47       "author": "\n    J.R.R. Tolkien,\n  ",
48       "book": "The Hobbit, or There and Back Again",
49       "likes": "1855 likes"
50     },
51     {
52       "id": 7,
53       "text": "\n      “Where there's life there's hope.”\n    \n ",
54       "author": "\n    J.R.R. Tolkien,\n  ",
55       "book": "The Hobbit, or There and Back Again",
56       "likes": "1815 likes"
57     },
58     {
59       "id": 8,
60       "text": "\n      “It does not do to leave a live dragon out of your calculations, if you live near him.”\n    \n ",
61       "author": "\n    J.R.R. Tolkien,\n  ",
62       "book": "The Hobbit, or There and Back Again",
63       "likes": "1751 likes"
64     },
65     {
66       "id": 9,
67       "text": "\n      “It cannot be seen, cannot be felt,Cannot be heard, cannot be smelt,It lies behind stars and under hills,And empty holes it fills,It comes first and follows after,Ends life, kills laughter.”\n    \n ",
68       "author": "\n    J.R.R. Tolkien,\n  ",
69       "book": "The Hobbit, or There and Back Again",
70       "likes": "1322 likes"
71     },
72     {
73       "id": 10,
74       "text": "\n      “Where did you go to, if I may ask?' said Thorin to Gandalf as they rode along.To look ahead,' said he.And what brought you back in the nick of time?'Looking behind,' said he.”\n    \n ",
75       "author": "\n    J.R.R. Tolkien,\n  ",
76       "book": "The Hobbit, or There and Back Again",
77       "likes": "1312 likes"
78     },
79     {
80       "id": 11,
81       "text": "\n      “There is more in you of good than you know, child of the kindly West. Some courage and some wisdom, blended in measure. If more of us valued food and cheer and song above hoarded gold, it would be a merrier world.”\n    \n ",
82       "author": "\n    J.R.R. Tolkien,\n  ",
83       "book": "The Hobbit, or There and Back Again",
84       "likes": "1179 likes"
85     },
86     {
87       "id": 12,
88       "text": "\n      “Good Morning!\" said Bilbo, and he meant it. The sun was shining, and the grass was very green. But Gandalf looked at him from under long bushy eyebrows that stuck out further than the brim of his shady hat.\"What do you mean?\" he said. \"Do you wish me a good morning, or mean that it is a good morning whether I want it or not; or that you feel good this morning; or that it is a morning to be good on?\"\"All of them at once,\" said Bilbo. \"And a very fine morning for a pipe of tobacco out of doors, into the bargain....\"Good morning!\" he said at last. \"We don't want any adventures here, thank you! You might try over The Hill or across The Water.\" By this he meant that the conversation was at an end.\"What a lot of things you do use Good morning for!\" said Gandalf. \"Now you mean that you want to get rid of me, and that it won't be good till I move off.”\n    \n ",
89       "author": "\n    J.R.R. Tolkien,\n  ",
90       "book": "The Hobbit, or There and Back Again",
91       "likes": "1146 likes"
92     },
93     {
94       "id": 13,
95       "text": "\n      “I am looking for someone to share in an adventure that I am arranging, and it's very difficult to find anyone.' I should think so — in these parts! We are plain quiet folk and have no use for adventures. Nasty disturbing uncomfortable things! Make you late for dinner!”\n    \n ",
96       "author": "\n    J.R.R. Tolkien,\n  ",
97       "book": "The Hobbit, or There and Back Again",
98       "likes": "972 likes"
99     },
100     {
101       "id": 14,
102       "text": "\n      “Go back?\" he thought. \"No good at all! Go sideways? Impossible! Go forward? Only thing to do! On we go!\" So up he got, and trotted along with his little sword held in front of him and one hand feeling the wall, and his heart all of a patter and a pitter.”\n    \n ",
103       "author": "\n    J.R.R. Tolkien,\n  ",
104       "book": "The Hobbit, or There and Back Again",
105       "likes": "959 likes"
106     },
107     {
108       "id": 15,
109       "text": "\n      “Then something Tookish woke up inside him, and he wished to go and see the great mountains, and hear the pine-trees and the waterfalls, and explore the caves, and wear a sword instead of a walking-stick.”\n    \n ",
110       "author": "\n    J.R.R. Tolkien,\n  ",
111       "book": "The Hobbit, or There and Back Again",
112       "likes": "929 likes"
113     },
114     {
115       "id": 16,
116       "text": "\n      “You have nice manners for a thief and a liar,\" said the dragon.”\n    \n ",
117       "author": "\n    J.R.R. Tolkien,\n  ",
118       "book": "The Hobbit, or There and Back Again",
119       "likes": "837 likes"
120     },
121     {
122       "id": 17,
123       "text": "\n      “In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to eat: it was a hobbit-hole, and that means comfort.”\n    \n ",
124       "author": "\n    J.R.R. Tolkien,\n  ",
125       "book": "The Hobbit, or There and Back Again",
126       "likes": "726 likes"
127     },
128     {
129       "id": 18,
130       "text": "\n      “May the hair on your toes never fall out!”\n    \n ",
131       "author": "\n    J.R.R. Tolkien,\n  ",
132       "book": "The Hobbit, or There and Back Again",
133       "likes": "583 likes"
134     },
135     {
136       "id": 19,
137       "text": "\n      “There are no safe paths in this part of the world. Remember you are over the Edge of the Wild now, and in for all sorts of fun wherever you go.”\n    \n ",
138       "author": "\n    J.R.R. Tolkien,\n  ",
139       "book": "The Hobbit, or There and Back Again",
140       "likes": "525 likes"
141     },
142     {
143       "id": 20,
144       "text": "\n      “The road goes ever on and on”\n    \n ",
145       "author": "\n    J.R.R. Tolkien,\n  ",
146       "book": "The Hobbit, or There and Back Again",
147       "likes": "511 likes"
148     },
149     {
150       "id": 21,
151       "text": "\n      “Now it is a strange thing, but things that are good to have and days that are good to spend are soon told about, and not much to listen to; while things that are uncomfortable, palpitating, and even gruesome, may make a good tale, and take a deal of telling anyway.”\n    \n ",
152       "author": "\n    J.R.R. Tolkien,\n  ",
153       "book": "The Hobbit, or There and Back Again",
154       "likes": "403 likes"
155     },
156     {
157       "id": 22,
158       "text": "\n      “This thing all things devours:Birds, beasts, trees, flowers;Gnaws iron, bites steel;Grinds hard stones to meal;Slays king, ruins town,And beats high mountain down.”\n    \n ",
159       "author": "\n    J.R.R. Tolkien,\n  ",
160       "book": "The Hobbit, or There and Back Again",
161       "likes": "398 likes"
162     },
163     {
164       "id": 23,
165       "text": "\n      “Farewell! O Gandalf! May you ever appear where you are most needed and least expected!”\n    \n ",
166       "author": "\n    J.R.R. Tolkien,\n  ",
167       "book": "The Hobbit, or There and Back Again",
168       "likes": "372 likes"
169     },
170     {
171       "id": 24,
172       "text": "\n      “Never laugh at live dragons, Bilbo you fool!”\n    \n ",
173       "author": "\n    J.R.R. Tolkien,\n  ",
174       "book": "The Hobbit, or There and Back Again",
175       "likes": "356 likes"
176     },
177     {
178       "id": 25,
179       "text": "\n      “I come from under the hill, and under the hills and over the hills my paths led. And through the air, I am he that walks unseen.I am the clue-finder, the web-cutter, the stinging fly. I was chosen for the lucky number.I am he that buries his friends alive and drowns them and draws them alive again from the water. I came from the end of a bag, but no bag went over me.I am the friend of bears and the guest of eagles. I am Ringwinner and Luckwearer; and I am Barrel-rider.”\n    \n ",
180       "author": "\n    J.R.R. Tolkien,\n  ",
181       "book": "The Hobbit, or There and Back Again",
182       "likes": "344 likes"
183     },
184     {
185       "id": 26,
186       "text": "\n      “It was at this point that Bilbo stopped. Going on from there was the bravest thing he ever did. The tremendous things that happened afterward were as nothing compared to it. He fought the real battle in the tunnel alone, before he ever saw the vast danger that lay in wait.”\n    \n ",
187       "author": "\n    J.R.R. Tolkien,\n  ",
188       "book": "The Hobbit, or There and Back Again",
189       "likes": "336 likes"
190     },
191     {
192       "id": 27,
193       "text": "\n      “A safe fairyland is untrue to all worlds.”\n    \n ",
194       "author": "\n    J.R.R. Tolkien,\n  ",
195       "book": "The Hobbit, or There and Back Again",
196       "likes": "313 likes"
197     },
198     {
199       "id": 28,
200       "text": "\n      “Sorry! I don't want any adventures, thank you. Not Today. Good morning! But please come to tea -any time you like! Why not tomorrow? Good bye!”\n    \n ",
201       "author": "\n    J.R.R. Tolkien,\n  ",
202       "book": "The Hobbit, or There and Back Again",
203       "likes": "311 likes"
204     },
205     {
206       "id": 29,
207       "text": "\n      “Voiceless it cries,Wingless flutters,Toothless bites,Mouthless mutters.”\n    \n ",
208       "author": "\n    J.R.R. Tolkien,\n  ",
209       "book": "The Hobbit, or There and Back Again",
210       "likes": "256 likes"
211     },
212     {
213       "id": 30,
214       "text": "\n      “A box without hinges, key, or lid,Yet golden treasure inside is hid.”\n    \n ",
215       "author": "\n    J.R.R. Tolkien,\n  ",
216       "book": "The Hobbit, or There and Back Again",
217       "likes": "246 likes"
218     }
219   ],
220   "lastScraped": "2026-06-15T00:42:22Z"
221 }

Quotes Scraper

Scrapes quotes associated with a specific book work from its Goodreads quotes page. Returns a list of quotes with attribution and like counts.

Request

Method: POST
URL: {{Instance Domain}}/api/works/quotes

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 quotes page URL (e.g. `https://www.goodreads.com/work/quotes/1540236`)

Example Body:

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

Response

200 Success

Returns a JSON object containing the scraped quotes.

1 {
2   "status": "Received",
3   "statusCode": 200,
4   "scrapeURL": "string",
5   "quotes": [
6     {
7       "quote": "string",
8       "author": "string",
9       "likes": "string",
10       "tags": ["string"]
11     }
12   ]
13 }

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
quotes	array	List of quotes from the book
quotes[].quote	string	The quote text
quotes[].author	string	The author attributed to the quote
quotes[].likes	string	Number of likes the quote has received
quotes[].tags	array	List of tags associated with the quote

## Quotes Scraper Scrapes quotes associated with a specific book work from its Goodreads quotes page. Returns a list of quotes with attribution and like counts. --- ## Request **Method:** `POST` **URL:** `{{Instance Domain}}/api/works/quotes` ### 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 quotes page URL (e.g. `https://www.goodreads.com/work/quotes/1540236`) | **Example Body:** ```json { "queryURL": "https://www.goodreads.com/work/quotes/1540236" } ``` --- ## Response ### 200 Success Returns a JSON object containing the scraped quotes. ```json { "status": "Received", "statusCode": 200, "scrapeURL": "string", "quotes": [ { "quote": "string", "author": "string", "likes": "string", "tags": ["string"] } ] } ``` ### 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 | | quotes | array | List of quotes from the book | | quotes[].quote | string | The quote text | | quotes[].author | string | The author attributed to the quote | | quotes[].likes | string | Number of likes the quote has received | | quotes[].tags | array | List of tags associated with the quote |

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

bookURLstring

imagestringformat: "uri"

namestring

quoteslist of objects

lastScrapeddatetime

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

1	{
2	"status": "Received",
3	"statusCode": 200,
4	"scrapeURL": "string",
5	"quotes": [
6	{
7	"quote": "string",
8	"author": "string",
9	"likes": "string",
10	"tags": ["string"]
11	}
12	]
13	}