works
questions-scraper
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:
{
"queryURL": "https://www.goodreads.com/book/5907/questions"
}
Response
200 Success
Returns a JSON object containing the scraped questions and answers.
{
"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 |
post/api/works/questions
Request body
Response
OK