winner-page

POST

https://biblioreads.eu.org/api/awards/winner-page

POST

/api/awards/winner-page

$ curl -X POST https://biblioreads.eu.org/api/awards/winner-page \
>      -H "Content-Type: application/json" \
>      -d '{
>   "queryURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023"
> }'

200Successful

1 {
2   "status": "Received",
3   "source": "https://github.com/nesaku/biblioreads",
4   "scrapeURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023",
5   "genre": "Readers' Favorite Fiction",
6   "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1671336608l/62047984.jpg",
7   "url": "/book/show/62047984-yellowface",
8   "title": "Yellowface",
9   "author": [
10     {
11       "id": 1,
12       "name": "R.F. Kuang",
13       "url": "/author/show/16820001.R_F_Kuang"
14     }
15   ],
16   "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",
17   "longDesc": "",
18   "numberOfVotes": "\n200,722\nvotes\n",
19   "nominees": [
20     {
21       "id": 1,
22       "url": "/book/show/62047984-yellowface",
23       "numberOfVotes": "\n200,722\nvotes\n",
24       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1671336608l/62047984.jpg",
25       "title": "Yellowface by R.F. Kuang"
26     },
27     {
28       "id": 2,
29       "url": "/book/show/61771675-hello-beautiful",
30       "numberOfVotes": "\n60,171\nvotes\n",
31       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1687803098l/61771675._SY475_.jpg",
32       "title": "Hello Beautiful by Ann Napolitano"
33     },
34     {
35       "id": 3,
36       "url": "/book/show/62926992-the-wishing-game",
37       "numberOfVotes": "\n57,702\nvotes\n",
38       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1684817680l/62926992.jpg",
39       "title": "The Wishing Game by Meg Shaffer"
40     },
41     {
42       "id": 4,
43       "url": "/book/show/63241104-tom-lake",
44       "numberOfVotes": "\n53,470\nvotes\n",
45       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1691084837l/63241104._SY475_.jpg",
46       "title": "Tom Lake by Ann Patchett"
47     },
48     {
49       "id": 5,
50       "url": "/book/show/62873996-the-five-star-weekend",
51       "numberOfVotes": "\n45,859\nvotes\n",
52       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1680591253l/62873996.jpg",
53       "title": "The Five-Star Weekend by Elin Hilderbrand"
54     },
55     {
56       "id": 6,
57       "url": "/book/show/62971668-someone-else-s-shoes",
58       "numberOfVotes": "\n44,333\nvotes\n",
59       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1666822989l/62971668.jpg",
60       "title": "Someone Else's Shoes by Jojo Moyes"
61     },
62     {
63       "id": 7,
64       "url": "/book/show/62919793-the-invisible-hour",
65       "numberOfVotes": "\n24,132\nvotes\n",
66       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1686761095l/62919793.jpg",
67       "title": "The Invisible Hour by Alice Hoffman"
68     },
69     {
70       "id": 8,
71       "url": "/book/show/60784605-maame",
72       "numberOfVotes": "\n21,854\nvotes\n",
73       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1666031380l/60784605._SY475_.jpg",
74       "title": "Maame by Jessica George"
75     },
76     {
77       "id": 9,
78       "url": "/book/show/61214136-the-collected-regrets-of-clover",
79       "numberOfVotes": "\n18,050\nvotes\n",
80       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1663608724l/61214136.jpg",
81       "title": "The Collected Regrets of Clover by Mikki Brammer"
82     },
83     {
84       "id": 10,
85       "url": "/book/show/61246258-pineapple-street",
86       "numberOfVotes": "\n17,864\nvotes\n",
87       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1659404866l/61246258.jpg",
88       "title": "Pineapple Street by Jenny   Jackson"
89     },
90     {
91       "id": 11,
92       "url": "/book/show/60701439-big-swiss",
93       "numberOfVotes": "\n7,486\nvotes\n",
94       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1653958990l/60701439.jpg",
95       "title": "Big Swiss by Jen Beagin"
96     },
97     {
98       "id": 12,
99       "url": "/book/show/62919375-shark-heart",
100       "numberOfVotes": "\n6,218\nvotes\n",
101       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1686092164l/62919375._SY475_.jpg",
102       "title": "Shark Heart by Emily Habeck"
103     },
104     {
105       "id": 13,
106       "url": "/book/show/59381516-evil-eye",
107       "numberOfVotes": "\n5,708\nvotes\n",
108       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1660158235l/59381516.jpg",
109       "title": "Evil Eye by Etaf Rum"
110     },
111     {
112       "id": 14,
113       "url": "/book/show/62049729-the-celebrants",
114       "numberOfVotes": "\n5,282\nvotes\n",
115       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1685352566l/62049729.jpg",
116       "title": "The Celebrants by Steven  Rowley"
117     },
118     {
119       "id": 15,
120       "url": "/book/show/60784757-birnam-wood",
121       "numberOfVotes": "\n4,425\nvotes\n",
122       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1653578326l/60784757.jpg",
123       "title": "Birnam Wood by Eleanor Catton"
124     },
125     {
126       "id": 16,
127       "url": "/book/show/61815336-the-connellys-of-county-down",
128       "numberOfVotes": "\n3,589\nvotes\n",
129       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1665471122l/61815336.jpg",
130       "title": "The Connellys of County Down by Tracey Lange"
131     },
132     {
133       "id": 17,
134       "url": "/book/show/62039166-the-bee-sting",
135       "numberOfVotes": "\n3,083\nvotes\n",
136       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1674502938l/62039166.jpg",
137       "title": "The Bee Sting by Paul Murray"
138     },
139     {
140       "id": 18,
141       "url": "/book/show/65650229-wellness",
142       "numberOfVotes": "\n2,983\nvotes\n",
143       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1695742140l/65650229._SY475_.jpg",
144       "title": "Wellness by Nathan  Hill"
145     },
146     {
147       "id": 19,
148       "url": "/book/show/65215321-blackouts",
149       "numberOfVotes": "\n2,611\nvotes\n",
150       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1677161651l/65215321.jpg",
151       "title": "Blackouts by Justin Torres"
152     },
153     {
154       "id": 20,
155       "url": "/book/show/123414019-family-meal",
156       "numberOfVotes": "\n2,176\nvotes\n",
157       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1679494794l/123414019.jpg",
158       "title": "Family Meal by Bryan Washington"
159     }
160   ],
161   "lastScraped": "2026-06-15T00:43:07Z"
162 }

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:

1 {
2   "queryURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023"
3 }

Response

200 Success

Returns a JSON object containing detailed information about the Choice Awards winner page.

1 {
2   "status": "Received",
3   "statusCode": 200,
4   ...
5 }

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

## 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 |

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

genrestring

coverstringformat: "uri"

urlstring

titlestring

authorlist of objects

descstring

longDescstring

numberOfVotesstring

nomineeslist of objects

lastScrapeddatetime

1	{
2	"queryURL": "https://www.goodreads.com/choiceawards/best-fiction-books-2023"
3	}