questions-scraper

POST

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

POST

/api/works/questions

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

200Successful

1 {
2   "status": "Received",
3   "source": "https://github.com/nesaku/biblioreads",
4   "scrapeURL": "https://www.goodreads.com/book/5907/questions",
5   "image": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1546071216l/5907._SX98_.jpg",
6   "book": "The Hobbit, or There and Back Again",
7   "bookURL": "/book/show/5907.The_Hobbit_or_There_and_Back_Again",
8   "author": "J.R.R. Tolkien",
9   "questions": [
10     {
11       "id": 1,
12       "date": "10 years ago",
13       "avatar": "https://s.gr-assets.com/assets/nophoto/user/m_100x100-c7bfe730633c9983e27caaa66a8e244a.png",
14       "authorName": "Jansen",
15       "authorURL": "/user/show/46123170-jansen",
16       "question": "Who else here was disappointed in the hobbit movies? I thought there was too much CGI and it strayed to much from the book. Reply if you think so too! :)",
17       "spoilerQuestion": "",
18       "shortAnswer": "\nI personally really enjoyed the films and the extrapolations they took from Tolkien's other works, besides The Hobbit. The Hobbit book, by itself, wou…moreI personally really enjoyed the films and the extrapolations they took from Tolkien's other works, besides The Hobbit. The Hobbit book, by itself, would not be possible to translate into a film without changing up and adding a few things to make it appeal to the mainstream audience. (\"All good stories deserve embellishment\") The Hobbit was a children's story, whereas LotR was written for adults. Therefore, the LotR films didn't need \"embellishment\", and since the filmmakers didn't want to make The Hobbit films for children, they changed things up, creating an engaging story with a deeper study into character and plot.(less)\n",
19       "answer": "I personally really enjoyed the films and the extrapolations they took from Tolkien's other works, besides The Hobbit. The Hobbit book, by itself, would not be possible to translate into a film without changing up and adding a few things to make it appeal to the mainstream audience. (\"All good stories deserve embellishment\") The Hobbit was a children's story, whereas LotR was written for adults. Therefore, the LotR films didn't need \"embellishment\", and since the filmmakers didn't want to make The Hobbit films for children, they changed things up, creating an engaging story with a deeper study into character and plot.(less)",
20       "likes": "100 likes"
21     },
22     {
23       "id": 2,
24       "date": "11 years ago",
25       "avatar": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1551199732i/22084880._UY100_CR25,0,100,100_.jpg",
26       "authorName": "Michael",
27       "authorURL": "/user/show/22084880-michael",
28       "question": "I've never really watched the Lord of the Rings movies or read the books (not for lack of interest, just haven't gotten around to it). Would you suggest I read The Hobbit before LotR?",
29       "spoilerQuestion": "",
30       "shortAnswer": "\nThe Hobbit can be sort of a \"gateway\" book, as it provides Tolkien's amazing fantasy and storytelling but without the (sometimes intimidating) detail …moreThe Hobbit can be sort of a \"gateway\" book, as it provides Tolkien's amazing fantasy and storytelling but without the (sometimes intimidating) detail and complexity of LOTR. The Hobbit will introduce Tolkien's world and mythology, so you will have some context when you read LOTR.(less)\n",
31       "answer": "The Hobbit can be sort of a \"gateway\" book, as it provides Tolkien's amazing fantasy and storytelling but without the (sometimes intimidating) detail and complexity of LOTR. The Hobbit will introduce Tolkien's world and mythology, so you will have some context when you read LOTR.(less)",
32       "likes": "39 likes"
33     },
34     {
35       "id": 3,
36       "date": "8 years ago",
37       "avatar": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1349361546i/13379612._UX100_CR0,6,100,100_.jpg",
38       "authorName": "Michael Chapman",
39       "authorURL": "/user/show/13379612-michael-chapman",
40       "question": "How could anyone read this book?",
41       "spoilerQuestion": "",
42       "shortAnswer": "\nBy opening at page 1, and starting from there...\n",
43       "answer": "",
44       "likes": "2 likes"
45     },
46     {
47       "id": 4,
48       "date": "10 years ago",
49       "avatar": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/users/1477779201i/52604380._UX100_CR0,0,100,100_.jpg",
50       "authorName": "SummerLily",
51       "authorURL": "/user/show/52604380-summerlily",
52       "question": "My friends, I have on my shelf The story of Kullervo, The silmarillion, The children of Húrin, The hobbit, the trilogy of The lord of the rings and Unfinished tales of Númenor and Middle-Earth. In what order should I read them? Am I missing any book in the series?",
53       "spoilerQuestion": "",
54       "shortAnswer": "\nWell, quite frankly, The Silmarillion is really boring. I highly suggest you read The Hobbit and LOTR first, to see if you even like his writing style…moreWell, quite frankly, The Silmarillion is really boring. I highly suggest you read The Hobbit and LOTR first, to see if you even like his writing style. Then, if you decide you are interested enough in Middle earth, go ahead and tackle the rest ;) (less)\n",
55       "answer": "Well, quite frankly, The Silmarillion is really boring. I highly suggest you read The Hobbit and LOTR first, to see if you even like his writing style. Then, if you decide you are interested enough in Middle earth, go ahead and tackle the rest ;) (less)",
56       "likes": "2 likes"
57     },
58     {
59       "id": 5,
60       "date": "11 years ago",
61       "avatar": "https://s.gr-assets.com/assets/nophoto/user/m_100x100-c7bfe730633c9983e27caaa66a8e244a.png",
62       "authorName": "Eduardo Jimenez",
63       "authorURL": "/user/show/34154133-eduardo-jimenez",
64       "question": "Should I read the Hobbit first or The Children of Hurin?",
65       "spoilerQuestion": "",
66       "shortAnswer": "\nIf you are new to Tolkien's mythology read the Hobbit first, is a nice door into this world. If you like it but you want more mature content then you …moreIf you are new to Tolkien's mythology read the Hobbit first, is a nice door into this world. If you like it but you want more mature content then you can go for The Children of Hurin and other works by Tolkien :) (less)\n",
67       "answer": "If you are new to Tolkien's mythology read the Hobbit first, is a nice door into this world. If you like it but you want more mature content then you can go for The Children of Hurin and other works by Tolkien :) (less)",
68       "likes": "4 likes"
69     }
70   ],
71   "unansweredQuestions": [
72     {
73       "id": 1,
74       "question": "北京丰台区小姐上门服务（电话微信同步█：19911761741█提供高质量小姐上门服务，面到满意付款，真人真照，假图免费，无定金，诚信第一！网址91friends.com?",
75       "spoilerQuestion": ""
76     }
77   ],
78   "lastScraped": "2026-06-15T00:42:39Z"
79 }

Questions Scraper

Scrapes community Q&A questions for a book from its Goodreads questions page. Returns a list of questions and answers submitted by the Goodreads community.

Request

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

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 book questions page URL (e.g. `https://www.goodreads.com/book/5907/questions`)

Example Body:

1 {
2   "queryURL": "https://www.goodreads.com/book/5907/questions"
3 }

Response

200 Success

Returns a JSON object containing the scraped questions and answers.

1 {
2   "status": "Received",
3   "statusCode": 200,
4   "scrapeURL": "string",
5   "questions": [
6     {
7       "question": "string",
8       "askedBy": "string",
9       "answers": [
10         {
11           "answer": "string",
12           "answeredBy": "string",
13           "likes": "string"
14         }
15       ]
16     }
17   ]
18 }

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
questions	array	List of community questions for the book
questions[].question	string	The question text
questions[].askedBy	string	Username of the person who asked the question
questions[].answers	array	List of answers to the question
questions[].answers[].answer	string	The answer text
questions[].answers[].answeredBy	string	Username of the person who answered
questions[].answers[].likes	string	Number of likes on the answer

## Questions Scraper Scrapes community Q&A questions for a book from its Goodreads questions page. Returns a list of questions and answers submitted by the Goodreads community. --- ## Request **Method:** `POST` **URL:** `{{Instance Domain}}/api/works/questions` ### 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 book questions page URL (e.g. `https://www.goodreads.com/book/5907/questions`) | **Example Body:** ```json { "queryURL": "https://www.goodreads.com/book/5907/questions" } ``` --- ## Response ### 200 Success Returns a JSON object containing the scraped questions and answers. ```json { "status": "Received", "statusCode": 200, "scrapeURL": "string", "questions": [ { "question": "string", "askedBy": "string", "answers": [ { "answer": "string", "answeredBy": "string", "likes": "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 | | questions | array | List of community questions for the book | | questions[].question | string | The question text | | questions[].askedBy | string | Username of the person who asked the question | | questions[].answers | array | List of answers to the question | | questions[].answers[].answer | string | The answer text | | questions[].answers[].answeredBy | string | Username of the person who answered | | questions[].answers[].likes | string | Number of likes on the answer |

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

imagestringformat: "uri"

bookstring

bookURLstring

authorstring

questionslist of objects

unansweredQuestionslist of objects

lastScrapeddatetime

1	{
2	"queryURL": "https://www.goodreads.com/book/5907/questions"
3	}

1	{
2	"status": "Received",
3	"statusCode": 200,
4	"scrapeURL": "string",
5	"questions": [
6	{
7	"question": "string",
8	"askedBy": "string",
9	"answers": [
10	{
11	"answer": "string",
12	"answeredBy": "string",
13	"likes": "string"
14	}
15	]
16	}
17	]
18	}