awards
winners-list
Winners List
Scrapes the list of winners from a Goodreads Choice Awards category page using a direct category URL. Returns structured information about all winning books in the specified awards category.
Request
Method: POST
URL: {{Instance Domain}}/api/awards/winners-list
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 the list of winners from the specified Choice Awards category.
{
"status": "Received",
"statusCode": 200,
...
}
Response Field Descriptions
| Field | Type | Description |
|---|---|---|
| status | string | Human-readable status message |
| statusCode | number | HTTP status code of the response |
| winners | array | List of winning books in the awards category, each with title, author, and metadata |
post/api/awards/winners-list
Request body
Response
OK