> 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. # book-scraper POST https://biblioreads.eu.org/api/book-scraper Content-Type: application/json ## 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 | Reference: https://docs.biblioreads.eu.org/api-endpoints/book-scraper ## Request ### Body (application/json) - `queryURL` (string, required) ## Response ### 200 OK - `status` (string, required) - `statusCode` (integer, required) - `source` (string, required) - `scrapeURL` (string, required) - `legacyBookID` (integer, required) - `bookID` (string, required) - `resourceID` (string, required) - `cover` (string, required) - `series` (string, required) - `seriesURL` (string, required) - `seriesPosition` (string, required) - `workURL` (string, required) - `title` (string, required) - `author` (list of object, required) - `id` (integer, required) - `name` (string, required) - `role` (string, required) - `url` (string, required) - `rating` (string, required) - `ratingCount` (string, required) - `reviewsCount` (string, required) - `desc` (string, required) - `genres` (list of string, required) - `bookEdition` (string, required) - `publishDate` (string, required) - `publisher` (string, required) - `language` (string, required) - `asin` (string, required) - `related` (list of any, required) - `reviews` (list of any, required) - `reviewBreakdown` (object, required) - `rating1` (string, required) - `rating2` (string, required) - `rating3` (string, required) - `rating4` (string, required) - `rating5` (string, required) - `quotes` (string, required) - `quotesURL` (string, required) - `questions` (string, required) - `questionsURL` (string, required) - `lastScraped` (datetime, required) - `isbn` (any, optional, nullable) - `isbn13` (any, optional, nullable) ## Examples **Request** ```json { "queryURL": "https://www.goodreads.com/book/show/5907" } ``` **Response** ```json { "status": "Received", "statusCode": 200, "source": "https://github.com/nesaku/biblioreads", "scrapeURL": "https://www.goodreads.com/book/show/5907", "legacyBookID": 5907, "bookID": "kca://book/amzn1.gr.book.v1.7HhPxEJT1NiirAiej27XwA", "resourceID": "kca://work/amzn1.gr.work.v1.Upx53g0wmFL_YBYIGV2Lzg", "cover": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1546071216i/5907.jpg", "series": "Middle Earth", "seriesURL": "/series/66175-middle-earth", "seriesPosition": "1", "workURL": "https://www.goodreads.com/book/show/5907.The_Hobbit_or_There_and_Back_Again", "title": "The Hobbit, or There and Back Again", "author": [ { "id": 1, "name": "J.R.R. Tolkien", "role": "Author", "url": "/author/show/656983.J_R_R_Tolkien" }, { "id": 2, "name": "Douglas A. Anderson", "role": "Editor", "url": "/author/show/1582.Douglas_A_Anderson" }, { "id": 3, "name": "Michael Hague", "role": "Illustrator", "url": "/author/show/13290.Michael_Hague" }, { "id": 4, "name": "Jemima Catlin", "role": "Illustrator", "url": "/author/show/6971179.Jemima_Catlin" } ], "rating": "4.30", "ratingCount": "4,559,227", "reviewsCount": "92,248", "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).", "genres": [ "Fantasy", "Classics", "Fiction", "Adventure", "Young Adult", "Audiobook", "High Fantasy", "Science Fiction Fantasy", "Dragons", "Novels" ], "bookEdition": "366 pages, Paperback", "publishDate": "Thu Aug 15 2002", "publisher": "Houghton Mifflin", "language": "English", "asin": "B0DN8P5BQF", "related": [ { "key": "value" } ], "reviews": [ { "key": "value" } ], "reviewBreakdown": { "rating1": "93418", "rating2": "143920", "rating3": "536882", "rating4": "1313802", "rating5": "2471205" }, "quotes": "923", "quotesURL": "/work/quotes/1540236", "questions": "116", "questionsURL": "/book/5907/questions", "lastScraped": "2026-06-15T00:42:03Z" } ``` **SDK Code** ```python import requests url = "https://biblioreads.eu.org/api/book-scraper" payload = { "queryURL": "https://www.goodreads.com/book/show/5907" } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://biblioreads.eu.org/api/book-scraper'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"queryURL":"https://www.goodreads.com/book/show/5907"}' }; 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/book-scraper" payload := strings.NewReader("{\n \"queryURL\": \"https://www.goodreads.com/book/show/5907\"\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/book-scraper") 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/book/show/5907\"\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/book-scraper") .header("Content-Type", "application/json") .body("{\n \"queryURL\": \"https://www.goodreads.com/book/show/5907\"\n}") .asString(); ``` ```php request('POST', 'https://biblioreads.eu.org/api/book-scraper', [ 'body' => '{ "queryURL": "https://www.goodreads.com/book/show/5907" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://biblioreads.eu.org/api/book-scraper"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"queryURL\": \"https://www.goodreads.com/book/show/5907\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = ["queryURL": "https://www.goodreads.com/book/show/5907"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://biblioreads.eu.org/api/book-scraper")! 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() ```