winners-list | BiblioReads

{
  "status": "Received",
  "source": "https://github.com/nesaku/biblioreads",
  "scrapeURL": "https://www.goodreads.com/choiceawards/best-books-2023",
  "genres": [
    {
      "id": 1,
      "name": "\nFiction\n",
      "url": "/choiceawards/best-fiction-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1671336608l/62047984.jpg",
      "title": "Yellowface"
    },
    {
      "id": 2,
      "name": "\nHistorical Fiction\n",
      "url": "/choiceawards/best-historical-fiction-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1677756582l/60654349._SY475_.jpg",
      "title": "Weyward"
    },
    {
      "id": 3,
      "name": "\nMystery & Thriller\n",
      "url": "/choiceawards/best-mystery-thriller-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1664729357l/62848145._SY475_.jpg",
      "title": "The Housemaid's Secret (The Housemaid, #2)"
    },
    {
      "id": 4,
      "name": "\nRomance\n",
      "url": "/choiceawards/best-romance-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1660145160l/61718053.jpg",
      "title": "Happy Place"
    },
    {
      "id": 5,
      "name": "\nRomantasy\n",
      "url": "/choiceawards/best-romantasy-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1761312598l/61431922._SY475_.jpg",
      "title": "Fourth Wing (The Empyrean, #1)"
    },
    {
      "id": 6,
      "name": "\nFantasy\n",
      "url": "/choiceawards/best-fantasy-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1648744814l/60652997.jpg",
      "title": "Hell Bent (Alex Stern, #2)"
    },
    {
      "id": 7,
      "name": "\nScience Fiction\n",
      "url": "/choiceawards/best-science-fiction-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1699617963l/60784549._SY475_.jpg",
      "title": "In the Lives of Puppets"
    },
    {
      "id": 8,
      "name": "\nHorror\n",
      "url": "/choiceawards/best-horror-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1674418461l/65916344.jpg",
      "title": "Holly (Holly Gibney, #3)"
    },
    {
      "id": 9,
      "name": "\nYoung Adult Fantasy\n",
      "url": "/choiceawards/best-young-adult-fantasy-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1655928079l/60784546.jpg",
      "title": "Divine Rivals (Letters of Enchantment, #1)"
    },
    {
      "id": 10,
      "name": "\nYoung Adult Fiction\n",
      "url": "/choiceawards/best-young-adult-fiction-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1678378842l/60683957.jpg",
      "title": "Check & Mate"
    },
    {
      "id": 11,
      "name": "\nDebut Novel\n",
      "url": "/choiceawards/best-debut-novel-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1677756582l/60654349._SY475_.jpg",
      "title": "Weyward"
    },
    {
      "id": 12,
      "name": "\nNonfiction\n",
      "url": "/choiceawards/best-nonfiction-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1665696294l/61358638._SY475_.jpg",
      "title": "Poverty, by America"
    },
    {
      "id": 13,
      "name": "\nMemoir & Autobiography\n",
      "url": "/choiceawards/best-memoir-autobiography-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1689090540l/63133205._SY475_.jpg",
      "title": "The Woman in Me"
    },
    {
      "id": 14,
      "name": "\nHistory & Biography\n",
      "url": "/choiceawards/best-history-biography-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1659407155l/61714633.jpg",
      "title": "The Wager: A Tale of Shipwreck, Mutiny and Murder"
    },
    {
      "id": 15,
      "name": "\nHumor\n",
      "url": "/choiceawards/best-humor-books-2023",
      "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1677855868l/65215014.jpg",
      "title": "Being Henry: The Fonz . . . and Beyond"
    }
  ],
  "lastScraped": "2026-06-15T00:43:13Z"
}

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

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

genreslist of objects

lastScrapeddatetime