book-scraper | BiblioReads

Book Scraper

Scrapes detailed book metadata from a Goodreads book page using a direct book URL. Returns structured information about the book including title, author(s), cover image, series details, and more.

Request

Method: POST
URL: {{Instance Domain}}/api/book-scraper

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 book page URL to scrape (e.g. `https://www.goodreads.com/book/show/5907`)

Example Body:

1 {
2   "queryURL": "https://www.goodreads.com/book/show/5907"
3 }

Response

200 Success

Returns a JSON object containing the scraped book metadata.

1 {
2   "status": "Received",
3   "statusCode": 200,
4   "source": "string (GitHub source URL)",
5   "scrapeURL": "string (the Goodreads book URL that was scraped)",
6   "legacyBookID": "number",
7   "bookID": "string (KCA book ID)",
8   "resourceID": "string (KCA work ID)",
9   "cover": "string (image URL)",
10   "series": "string",
11   "seriesURL": "string",
12   "seriesPosition": "string",
13   "workURL": "string",
14   "title": "string",
15   "author": [
16     {
17       "id": "number",
18       "name": "string",
19       "role": "string (e.g. Author, Editor, Illustrator)",
20       "url": "string"
21     }
22   ]
23 }

Response Field Descriptions

Field	Type	Description
status	string	Human-readable status message (e.g. `"Received"`)
statusCode	number	HTTP status code of the scrape operation
source	string	URL pointing to the GitHub source of the scraper
scrapeURL	string	The Goodreads book URL that was scraped
legacyBookID	number	The legacy numeric Goodreads book ID
bookID	string	KCA-format book identifier
resourceID	string	KCA-format work identifier
cover	string	URL of the book’s cover image
series	string	Name of the series the book belongs to (if any)
seriesURL	string	URL to the series page on Goodreads
seriesPosition	string	Position of the book within the series
workURL	string	URL to the book’s work page on Goodreads
title	string	Title of the book
author	array	List of contributors (authors, editors, illustrators, etc.)
author[].id	number	Goodreads author ID
author[].name	string	Full name of the contributor
author[].role	string	Role of the contributor (e.g. `Author`, `Editor`, `Illustrator`)
author[].url	string	URL to the contributor’s Goodreads profile

## Book Scraper Scrapes detailed book metadata from a Goodreads book page using a direct book URL. Returns structured information about the book including title, author(s), cover image, series details, and more. --- ## Request **Method:** `POST` **URL:** `{{Instance Domain}}/api/book-scraper` ### 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 book page URL to scrape (e.g. `https://www.goodreads.com/book/show/5907`) | **Example Body:** ``` json { "queryURL": "https://www.goodreads.com/book/show/5907" } ``` --- ## Response ### 200 Success Returns a JSON object containing the scraped book metadata. ``` json { "status": "Received", "statusCode": 200, "source": "string (GitHub source URL)", "scrapeURL": "string (the Goodreads book URL that was scraped)", "legacyBookID": "number", "bookID": "string (KCA book ID)", "resourceID": "string (KCA work ID)", "cover": "string (image URL)", "series": "string", "seriesURL": "string", "seriesPosition": "string", "workURL": "string", "title": "string", "author": [ { "id": "number", "name": "string", "role": "string (e.g. Author, Editor, Illustrator)", "url": "string" } ] } ``` ### Response Field Descriptions | Field | Type | Description | | --- | --- | --- | | status | string | Human-readable status message (e.g. `"Received"`) | | statusCode | number | HTTP status code of the scrape operation | | source | string | URL pointing to the GitHub source of the scraper | | scrapeURL | string | The Goodreads book URL that was scraped | | legacyBookID | number | The legacy numeric Goodreads book ID | | bookID | string | KCA-format book identifier | | resourceID | string | KCA-format work identifier | | cover | string | URL of the book's cover image | | series | string | Name of the series the book belongs to (if any) | | seriesURL | string | URL to the series page on Goodreads | | seriesPosition | string | Position of the book within the series | | workURL | string | URL to the book's work page on Goodreads | | title | string | Title of the book | | author | array | List of contributors (authors, editors, illustrators, etc.) | | author\[\].id | number | Goodreads author ID | | author\[\].name | string | Full name of the contributor | | author\[\].role | string | Role of the contributor (e.g. `Author`, `Editor`, `Illustrator`) | | author\[\].url | string | URL to the contributor's Goodreads profile |

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

statusCodeinteger

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

legacyBookIDinteger

bookIDstring

resourceIDstring

coverstringformat: "uri"

seriesstring

seriesURLstring

seriesPositionstring

workURLstringformat: "uri"

titlestring

authorlist of objects

ratingstring

ratingCountstring

reviewsCountstring

descstring

genreslist of strings

bookEditionstring

publishDatestring

publisherstring

languagestring

asinstring

reviewslist of any

reviewBreakdownobject

quotesstring

quotesURLstring

questionsstring

questionsURLstring

lastScrapeddatetime

isbnany or nullOptional

isbn13any or nullOptional

Book Scraper

Scrapes detailed book metadata from a Goodreads book page using a direct book URL. Returns structured information about the book including title, author(s), cover image, series details, and more.

Request

Method: POST
URL: {{Instance Domain}}/api/book-scraper

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 book page URL to scrape (e.g. `https://www.goodreads.com/book/show/5907`)

Example Body:

1 {
2   "queryURL": "https://www.goodreads.com/book/show/5907"
3 }

Response

200 Success

Returns a JSON object containing the scraped book metadata.

1 {
2   "status": "Received",
3   "statusCode": 200,
4   "source": "string (GitHub source URL)",
5   "scrapeURL": "string (the Goodreads book URL that was scraped)",
6   "legacyBookID": "number",
7   "bookID": "string (KCA book ID)",
8   "resourceID": "string (KCA work ID)",
9   "cover": "string (image URL)",
10   "series": "string",
11   "seriesURL": "string",
12   "seriesPosition": "string",
13   "workURL": "string",
14   "title": "string",
15   "author": [
16     {
17       "id": "number",
18       "name": "string",
19       "role": "string (e.g. Author, Editor, Illustrator)",
20       "url": "string"
21     }
22   ]
23 }

Response Field Descriptions

Field	Type	Description
status	string	Human-readable status message (e.g. `"Received"`)
statusCode	number	HTTP status code of the scrape operation
source	string	URL pointing to the GitHub source of the scraper
scrapeURL	string	The Goodreads book URL that was scraped
legacyBookID	number	The legacy numeric Goodreads book ID
bookID	string	KCA-format book identifier
resourceID	string	KCA-format work identifier
cover	string	URL of the book’s cover image
series	string	Name of the series the book belongs to (if any)
seriesURL	string	URL to the series page on Goodreads
seriesPosition	string	Position of the book within the series
workURL	string	URL to the book’s work page on Goodreads
title	string	Title of the book
author	array	List of contributors (authors, editors, illustrators, etc.)
author[].id	number	Goodreads author ID
author[].name	string	Full name of the contributor
author[].role	string	Role of the contributor (e.g. `Author`, `Editor`, `Illustrator`)
author[].url	string	URL to the contributor’s Goodreads profile

$	curl -X POST https://biblioreads.eu.org/api/book-scraper \
>	-H "Content-Type: application/json" \
>	-d '{
>	"queryURL": "https://www.goodreads.com/book/show/5907"
>	}'

1	{
2	"status": "Received",
3	"statusCode": 200,
4	"source": "https://github.com/nesaku/biblioreads",
5	"scrapeURL": "https://www.goodreads.com/book/show/5907",
6	"legacyBookID": 5907,
7	"bookID": "kca://book/amzn1.gr.book.v1.7HhPxEJT1NiirAiej27XwA",
8	"resourceID": "kca://work/amzn1.gr.work.v1.Upx53g0wmFL_YBYIGV2Lzg",
9	"cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907.jpg",
10	"series": "Middle Earth",
11	"seriesURL": "/series/66175-middle-earth",
12	"seriesPosition": "1",
13	"workURL": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again",
14	"title": "The Hobbit, or There and Back Again",
15	"author": [
16	{
17	"id": 1,
18	"name": "J.R.R. Tolkien",
19	"role": "Author",
20	"url": "/author/show/656983.J_R_R_Tolkien"
21	},
22	{
23	"id": 2,
24	"name": "Douglas A. Anderson",
25	"role": "Editor",
26	"url": "/author/show/1582.Douglas_A_Anderson"
27	},
28	{
29	"id": 3,
30	"name": "Michael Hague",
31	"role": "Illustrator",
32	"url": "/author/show/13290.Michael_Hague"
33	},
34	{
35	"id": 4,
36	"name": "Jemima Catlin",
37	"role": "Illustrator",
38	"url": "/author/show/6971179.Jemima_Catlin"
39	}
40	],
41	"rating": "4.30",
42	"ratingCount": "4,559,227",
43	"reviewsCount": "92,248",
44	"desc": "In a hole in the ground there lived a hobbit. Not a nasty, dirty, wet hole, filled with the ends of worms and an oozy smell, nor yet a dry, bare, sandy hole with nothing in it to sit down on or to eat: it was a hobbit-hole, and that means comfort.\r\nWritten for J.R.R. Tolkien’s own children, The Hobbit met with instant critical acclaim when it was first published in 1937. Now recognized as a timeless classic, this introduction to the hobbit Bilbo Baggins, the wizard Gandalf, Gollum, and the spectacular world of Middle-earth recounts of the adventures of a reluctant hero, a powerful and dangerous ring, and the cruel dragon Smaug the Magnificent. The text in this 372-page paperback edition is based on that first published in Great Britain by Collins Modern Classics (1998), and includes a note on the text by Douglas A. Anderson (2001).",
45	"genres": [
46	"Fantasy",
47	"Classics",
48	"Fiction",
49	"Adventure",
50	"Young Adult",
51	"Audiobook",
52	"High Fantasy",
53	"Science Fiction Fantasy",
54	"Dragons",
55	"Novels"
56	],
57	"bookEdition": "366 pages, Paperback",
58	"publishDate": "Thu Aug 15 2002",
59	"publisher": "Houghton Mifflin",
60	"language": "English",
61	"asin": "B0DN8P5BQF",
62	"related": [
63	{
64	"key": "value"
65	}
66	],
67	"reviews": [
68	{
69	"key": "value"
70	}
71	],
72	"reviewBreakdown": {
73	"rating1": "93418",
74	"rating2": "143920",
75	"rating3": "536882",
76	"rating4": "1313802",
77	"rating5": "2471205"
78	},
79	"quotes": "923",
80	"quotesURL": "/work/quotes/1540236",
81	"questions": "116",
82	"questionsURL": "/book/5907/questions",
83	"lastScraped": "2026-06-15T00:42:03Z"
84	}

1	{
2	"status": "Received",
3	"statusCode": 200,
4	"source": "string (GitHub source URL)",
5	"scrapeURL": "string (the Goodreads book URL that was scraped)",
6	"legacyBookID": "number",
7	"bookID": "string (KCA book ID)",
8	"resourceID": "string (KCA work ID)",
9	"cover": "string (image URL)",
10	"series": "string",
11	"seriesURL": "string",
12	"seriesPosition": "string",
13	"workURL": "string",
14	"title": "string",
15	"author": [
16	{
17	"id": "number",
18	"name": "string",
19	"role": "string (e.g. Author, Editor, Illustrator)",
20	"url": "string"
21	}
22	]
23	}