> 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. # winner-page POST https://biblioreads.eu.org/api/awards/winner-page Content-Type: application/json ## 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:** ```json { "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. ```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 | | 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 | Reference: https://docs.biblioreads.eu.org/api-endpoints/awards/winner-page ## Request ### Body (application/json) - `queryURL` (string, required) ## Response ### 200 OK - `status` (string, required) - `source` (string, required) - `scrapeURL` (string, required) - `genre` (string, required) - `cover` (string, required) - `url` (string, required) - `title` (string, required) - `author` (list of object, required) - `id` (integer, required) - `name` (string, required) - `url` (string, required) - `desc` (string, required) - `longDesc` (string, required) - `numberOfVotes` (string, required) - `nominees` (list of object, required) - `id` (integer, required) - `url` (string, required) - `numberOfVotes` (string, required) - `cover` (string, required) - `title` (string, required) - `lastScraped` (datetime, required) ## Examples **Request** ```json { "queryURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023" } ``` **Response** ```json { "status": "Received", "source": "https://github.com/nesaku/biblioreads", "scrapeURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023", "genre": "Readers' Favorite Fiction", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1671336608l/62047984.jpg", "url": "/book/show/62047984-yellowface", "title": "Yellowface", "author": [ { "id": 1, "name": "R.F. Kuang", "url": "/author/show/16820001.R_F_Kuang" } ], "desc": "\nR.F. Kuang continues her astonishing ascent from genre specialist to literary sensation with Yellowface, a lacerating parable about the publishing industry itself. A combination of satire, metafiction, and slow-burn thriller, the book ultimately delivers a sly cultural critique concerning race and tokenism in the book business.\n", "longDesc": "", "numberOfVotes": "\n200,722\nvotes\n", "nominees": [ { "id": 1, "url": "/book/show/62047984-yellowface", "numberOfVotes": "\n200,722\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1671336608l/62047984.jpg", "title": "Yellowface by R.F. Kuang" }, { "id": 2, "url": "/book/show/61771675-hello-beautiful", "numberOfVotes": "\n60,171\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1687803098l/61771675._SY475_.jpg", "title": "Hello Beautiful by Ann Napolitano" }, { "id": 3, "url": "/book/show/62926992-the-wishing-game", "numberOfVotes": "\n57,702\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1684817680l/62926992.jpg", "title": "The Wishing Game by Meg Shaffer" }, { "id": 4, "url": "/book/show/63241104-tom-lake", "numberOfVotes": "\n53,470\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1691084837l/63241104._SY475_.jpg", "title": "Tom Lake by Ann Patchett" }, { "id": 5, "url": "/book/show/62873996-the-five-star-weekend", "numberOfVotes": "\n45,859\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1680591253l/62873996.jpg", "title": "The Five-Star Weekend by Elin Hilderbrand" }, { "id": 6, "url": "/book/show/62971668-someone-else-s-shoes", "numberOfVotes": "\n44,333\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1666822989l/62971668.jpg", "title": "Someone Else's Shoes by Jojo Moyes" }, { "id": 7, "url": "/book/show/62919793-the-invisible-hour", "numberOfVotes": "\n24,132\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1686761095l/62919793.jpg", "title": "The Invisible Hour by Alice Hoffman" }, { "id": 8, "url": "/book/show/60784605-maame", "numberOfVotes": "\n21,854\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1666031380l/60784605._SY475_.jpg", "title": "Maame by Jessica George" }, { "id": 9, "url": "/book/show/61214136-the-collected-regrets-of-clover", "numberOfVotes": "\n18,050\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1663608724l/61214136.jpg", "title": "The Collected Regrets of Clover by Mikki Brammer" }, { "id": 10, "url": "/book/show/61246258-pineapple-street", "numberOfVotes": "\n17,864\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1659404866l/61246258.jpg", "title": "Pineapple Street by Jenny Jackson" }, { "id": 11, "url": "/book/show/60701439-big-swiss", "numberOfVotes": "\n7,486\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1653958990l/60701439.jpg", "title": "Big Swiss by Jen Beagin" }, { "id": 12, "url": "/book/show/62919375-shark-heart", "numberOfVotes": "\n6,218\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1686092164l/62919375._SY475_.jpg", "title": "Shark Heart by Emily Habeck" }, { "id": 13, "url": "/book/show/59381516-evil-eye", "numberOfVotes": "\n5,708\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1660158235l/59381516.jpg", "title": "Evil Eye by Etaf Rum" }, { "id": 14, "url": "/book/show/62049729-the-celebrants", "numberOfVotes": "\n5,282\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1685352566l/62049729.jpg", "title": "The Celebrants by Steven Rowley" }, { "id": 15, "url": "/book/show/60784757-birnam-wood", "numberOfVotes": "\n4,425\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1653578326l/60784757.jpg", "title": "Birnam Wood by Eleanor Catton" }, { "id": 16, "url": "/book/show/61815336-the-connellys-of-county-down", "numberOfVotes": "\n3,589\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1665471122l/61815336.jpg", "title": "The Connellys of County Down by Tracey Lange" }, { "id": 17, "url": "/book/show/62039166-the-bee-sting", "numberOfVotes": "\n3,083\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1674502938l/62039166.jpg", "title": "The Bee Sting by Paul Murray" }, { "id": 18, "url": "/book/show/65650229-wellness", "numberOfVotes": "\n2,983\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1695742140l/65650229._SY475_.jpg", "title": "Wellness by Nathan Hill" }, { "id": 19, "url": "/book/show/65215321-blackouts", "numberOfVotes": "\n2,611\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1677161651l/65215321.jpg", "title": "Blackouts by Justin Torres" }, { "id": 20, "url": "/book/show/123414019-family-meal", "numberOfVotes": "\n2,176\nvotes\n", "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1679494794l/123414019.jpg", "title": "Family Meal by Bryan Washington" } ], "lastScraped": "2026-06-15T00:43:07Z" } ``` **SDK Code** ```python import requests url = "https://biblioreads.eu.org/api/awards/winner-page" payload = { "queryURL": "https://www.goodreads.com/choiceawards/best-fiction-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/winner-page'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"queryURL":"https://www.goodreads.com/choiceawards/best-fiction-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/winner-page" payload := strings.NewReader("{\n \"queryURL\": \"https://www.goodreads.com/choiceawards/best-fiction-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/winner-page") 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-fiction-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/winner-page") .header("Content-Type", "application/json") .body("{\n \"queryURL\": \"https://www.goodreads.com/choiceawards/best-fiction-books-2023\"\n}") .asString(); ``` ```php request('POST', 'https://biblioreads.eu.org/api/awards/winner-page', [ 'body' => '{ "queryURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://biblioreads.eu.org/api/awards/winner-page"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"queryURL\": \"https://www.goodreads.com/choiceawards/best-fiction-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-fiction-books-2023"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://biblioreads.eu.org/api/awards/winner-page")! 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() ```