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