awards
winner-page
Winner Page
Scrapes detailed information about a specific Goodreads Choice Awards winner page using a direct category URL. Returns in-depth metadata about the winning book and the awards context.
Request
Method: POST
URL: {{Instance Domain}}/api/awards/winner-page
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 Choice Awards category page URL to scrape (e.g. https://www.goodreads.com/choiceawards/best-fiction-books-2023) |
Example Body:
{
"queryURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023"
}
Response
200 Success
Returns a JSON object containing detailed information about the Choice Awards winner page.
{
"status": "Received",
"statusCode": 200,
...
}
Response Field Descriptions
| Field | Type | Description |
|---|---|---|
| status | string | Human-readable status message |
| statusCode | number | HTTP status code of the response |
| category | string | The awards category name |
| year | string | The year of the Choice Awards |
| winner | object | Detailed metadata about the winning book including title, author, and cover image |
post/api/awards/winner-page
Request body
Response
OK