> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.biblioreads.eu.org/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.biblioreads.eu.org/_mcp/server. # winners-list POST https://biblioreads.eu.org/api/awards/winners-list Content-Type: application/json ## 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:** ```json { "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. ```json { "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 | Reference: https://docs.biblioreads.eu.org/api-endpoints/awards/winners-list ## Request ### Body (application/json) - `queryURL` (string, required) ## Response ### 200 OK - `status` (string, required) - `source` (string, required) - `scrapeURL` (string, required) - `genres` (list of object, required) - `id` (integer, required) - `name` (string, required) - `url` (string, required) - `cover` (string, required) - `title` (string, required) - `lastScraped` (datetime, required) ## Examples **Request** ```json { "queryURL": "https://www.goodreads.com/choiceawards/best-books-2023" } ``` **Response** ```json { "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" } ``` **SDK Code** ```python import requests url = "https://biblioreads.eu.org/api/awards/winners-list" payload = { "queryURL": "https://www.goodreads.com/choiceawards/best-books-2023" } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://biblioreads.eu.org/api/awards/winners-list'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"queryURL":"https://www.goodreads.com/choiceawards/best-books-2023"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://biblioreads.eu.org/api/awards/winners-list" payload := strings.NewReader("{\n \"queryURL\": \"https://www.goodreads.com/choiceawards/best-books-2023\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://biblioreads.eu.org/api/awards/winners-list") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"queryURL\": \"https://www.goodreads.com/choiceawards/best-books-2023\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://biblioreads.eu.org/api/awards/winners-list") .header("Content-Type", "application/json") .body("{\n \"queryURL\": \"https://www.goodreads.com/choiceawards/best-books-2023\"\n}") .asString(); ``` ```php request('POST', 'https://biblioreads.eu.org/api/awards/winners-list', [ 'body' => '{ "queryURL": "https://www.goodreads.com/choiceawards/best-books-2023" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://biblioreads.eu.org/api/awards/winners-list"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"queryURL\": \"https://www.goodreads.com/choiceawards/best-books-2023\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = ["queryURL": "https://www.goodreads.com/choiceawards/best-books-2023"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://biblioreads.eu.org/api/awards/winners-list")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```