> 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. # author-info-scraper POST https://biblioreads.eu.org/api/author/info Content-Type: application/json ## Author Scraper Scrapes author profile information from a Goodreads author page using a direct author URL. Returns structured details about the author including biography, genres, and other profile metadata. *** ## Request **Method:** `POST`\ **URL:** `{{Instance Domain}}/api/author/info` ### 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 author page URL to scrape (e.g. `https://www.goodreads.com/author/show/1077326.J_K_Rowling`) | **Example Body:** ```json { "queryURL": "https://www.goodreads.com/author/show/1077326.J_K_Rowling" } ``` *** ## Response ### 200 Success Returns a JSON object containing the scraped author profile information. ```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 | | name | string | Full name of the author | | bio | string | Author biography as listed on Goodreads | | genres | array | List of genres the author is known for | | image | string | URL of the author's profile image | Reference: https://docs.biblioreads.eu.org/api-endpoints/author/author-info-scraper ## Request ### Body (application/json) - `queryURL` (string, required) ## Response ### 200 OK - `status` (string, required) - `source` (string, required) - `scrapeURL` (string, required) - `image` (string, required) - `name` (string, required) - `website` (string, required) - `genre` (list of string, required) - `influences` (list of object, required) - `id` (integer, required) - `author` (string, required) - `url` (string, required) - `birthDate` (string, required) - `deathDate` (string, required) - `desc` (string, required) - `books` (list of object, required) - `id` (integer, required) - `cover` (string, required) - `title` (string, required) - `url` (string, required) - `rating` (string, required) - `publishDate` (string, required) - `series` (list of object, required) - `id` (integer, required) - `cover` (string, required) - `title` (string, required) - `seriesURL` (string, required) - `author` (string, required) - `authorURL` (string, required) - `rating` (string, required) - `lastScraped` (datetime, required) ## Examples **Request** ```json { "queryURL": "https://www.goodreads.com/author/show/3389.Stephen_King" } ``` **Response** ```json { "status": "Received", "source": "https://github.com/nesaku/biblioreads", "scrapeURL": "https://www.goodreads.com/author/show/3389.Stephen_King", "image": "https://images.gr-assets.com/authors/1362814142p5/3389.jpg", "name": "Stephen King", "website": "http://www.stephenking.com", "genre": [ "Horror", "Mystery", "Literature & Fiction" ], "influences": [ { "id": 1, "author": "Robert Bloch", "url": "https://www.goodreads.com/author/show/12540.Robert_Bloch" }, { "id": 2, "author": "Ray Bradbury", "url": "https://www.goodreads.com/author/show/1630.Ray_Bradbury" }, { "id": 3, "author": "Charles Dickens", "url": "https://www.goodreads.com/author/show/239579.Charles_Dickens" }, { "id": 4, "author": "Shirley Jackson", "url": "https://www.goodreads.com/author/show/13388.Shirley_Jackson" }, { "id": 5, "author": "H.P. Lov", "url": "https://www.goodreads.com/author/show/9494.H_P__Lovecraft" }, { "id": 6, "author": "Robert Bloch", "url": "https://www.goodreads.com/author/show/12540.Robert_Bloch" }, { "id": 7, "author": "Ray Bradbury", "url": "https://www.goodreads.com/author/show/1630.Ray_Bradbury" }, { "id": 8, "author": "Charles Dickens", "url": "https://www.goodreads.com/author/show/239579.Charles_Dickens" }, { "id": 9, "author": "Shirley Jackson", "url": "https://www.goodreads.com/author/show/13388.Shirley_Jackson" }, { "id": 10, "author": "H.P. Lovecraft", "url": "https://www.goodreads.com/author/show/9494.H_P__Lovecraft" }, { "id": 11, "author": "John D. MacDonald", "url": "https://www.goodreads.com/author/show/24690.John_D__MacDonald" }, { "id": 12, "author": "Richard Matheson", "url": "https://www.goodreads.com/author/show/8726.Richard_Matheson" }, { "id": 13, "author": "J.R.R. Tolkien", "url": "https://www.goodreads.com/author/show/656983.J_R_R__Tolkien" } ], "birthDate": "", "deathDate": "", "desc": "Stephen Edwin King was born the second son of Donald and Nellie Ruth Pillsbury King. After his father left them when Stephen was two, he and his older brother, David, were raised by his mother. Parts of his childhood were spent in Fort Wayne, Indiana, where his father's family was at the time, and in Stratford, Connecticut. When Stephen was eleven, his mother brought her children back to Durham, Maine, for good. Her parents, Guy and Nellie Pillsbury, had become incapacitated with old age, and Ruth King was persuaded by her sisters to take over the physical care of them. Other family members provided a small house in Durham and financial support. After Stephen's grandparents passed away, Mrs. King found work in the kitchens of Pineland, a ne", "books": [ { "id": 1, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1353277730i/11588._SY75_.jpg", "title": "The Shining (The Shining, #1)", "url": "/book/show/11588.The_Shining", "rating": " 4.28 avg rating From 1744,672 ratings", "publishDate": "\n 4.28 avg rating — 1,744,672 ratings\n —\n published\n 1977\n —\n 542 editions\n " }, { "id": 2, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1334416842i/830502._SY75_.jpg", "title": "It", "url": "/book/show/830502.It", "rating": " 4.24 avg rating From 1300,261 ratings", "publishDate": "\n 4.24 avg rating — 1,300,261 ratings\n —\n published\n 1986\n —\n 20 editions\n " }, { "id": 3, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1674820514i/87591651._SX50_.jpg", "title": "The Stand", "url": "/book/show/87591651-the-stand", "rating": " 4.35 avg rating From 852483 ratings", "publishDate": "\n 4.35 avg rating — 852,483 ratings\n —\n published\n 1978\n —\n 22 editions\n " }, { "id": 4, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1746142586i/10614._SY75_.jpg", "title": "Misery", "url": "/book/show/10614.Misery", "rating": " 4.22 avg rating From 842550 ratings", "publishDate": "\n 4.22 avg rating — 842,550 ratings\n —\n published\n 1987\n —\n 291 editions\n " }, { "id": 5, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1771367607i/10592._SY75_.jpg", "title": "Carrie", "url": "/book/show/10592.Carrie", "rating": " 3.99 avg rating From 868507 ratings", "publishDate": "\n 3.99 avg rating — 868,507 ratings\n —\n published\n 1974\n " }, { "id": 6, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1327876792i/10644930._SY75_.jpg", "title": "11/22/63", "url": "/book/show/10644930-11-22-63", "rating": " 4.35 avg rating From 687334 ratings", "publishDate": "\n 4.35 avg rating — 687,334 ratings\n —\n published\n 2011\n —\n 14 editions\n " }, { "id": 7, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1480069533i/33124137._SY75_.jpg", "title": "Pet Sematary", "url": "/book/show/33124137-pet-sematary", "rating": " 4.09 avg rating From 719345 ratings", "publishDate": "\n 4.09 avg rating — 719,345 ratings\n —\n published\n 1983\n —\n 457 editions\n " }, { "id": 8, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1738025067i/11590._SY75_.jpg", "title": "’Salem’s Lot", "url": "/book/show/11590._Salem_s_Lot", "rating": " 4.10 avg rating From 675041 ratings", "publishDate": "\n 4.10 avg rating — 675,041 ratings\n —\n published\n 1975\n —\n 42 editions\n " }, { "id": 9, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1770544533i/247642509._SY75_.jpg", "title": "The Gunslinger (Dark Tower, #1)", "url": "/book/show/247642509-the-gunslinger", "rating": " 3.91 avg rating From 674579 ratings", "publishDate": "\n 3.91 avg rating — 674,579 ratings\n —\n published\n 1982\n —\n 7 editions\n " }, { "id": 10, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1373903563i/11566._SY75_.jpg", "title": "The Green Mile", "url": "/book/show/11566.The_Green_Mile", "rating": " 4.49 avg rating From 372752 ratings", "publishDate": "\n 4.49 avg rating — 372,752 ratings\n —\n published\n 1996\n —\n 294 editions\n " } ], "series": [ { "id": 1, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1770544533l/247642509._SY75_.jpg", "title": "The Dark Tower", "seriesURL": "/series/40750-the-dark-tower", "author": "Stephen King", "authorURL": "/author/show/3389.Stephen_King", "rating": " 4.12 avg rating — 2,180,350 ratings" }, { "id": 2, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1353277730l/11588._SY75_.jpg", "title": "The Shining", "seriesURL": "/series/117014-the-shining", "author": "Stephen King", "authorURL": "/author/show/3389.Stephen_King", "rating": " 4.26 avg rating — 2,049,348 ratings" }, { "id": 3, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1524596540l/36124936._SY75_.jpg", "title": "Holly Gibney", "seriesURL": "/series/318697-holly-gibney", "author": "Stephen King", "authorURL": "/author/show/3389.Stephen_King", "rating": " 4.03 avg rating — 1,538,249 ratings" }, { "id": 4, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1468705326l/18775247._SY75_.jpg", "title": "Bill Hodges", "seriesURL": "/series/137422-bill-hodges", "author": "Stephen King", "authorURL": "/author/show/3389.Stephen_King", "rating": " 4.06 avg rating — 742,932 ratings" }, { "id": 5, "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1228499552l/92227._SY75_.jpg", "title": "The Green Mile", "seriesURL": "/series/69946-the-green-mile", "author": "Stephen King", "authorURL": "/author/show/3389.Stephen_King", "rating": " 4.50 avg rating — 504,080 ratings" } ], "lastScraped": "2026-06-15T00:43:18Z" } ``` **SDK Code** ```python import requests url = "https://biblioreads.eu.org/api/author/info" payload = { "queryURL": "https://www.goodreads.com/author/show/3389.Stephen_King" } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://biblioreads.eu.org/api/author/info'; const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"queryURL":"https://www.goodreads.com/author/show/3389.Stephen_King"}' }; 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/author/info" payload := strings.NewReader("{\n \"queryURL\": \"https://www.goodreads.com/author/show/3389.Stephen_King\"\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/author/info") 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/author/show/3389.Stephen_King\"\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/author/info") .header("Content-Type", "application/json") .body("{\n \"queryURL\": \"https://www.goodreads.com/author/show/3389.Stephen_King\"\n}") .asString(); ``` ```php request('POST', 'https://biblioreads.eu.org/api/author/info', [ 'body' => '{ "queryURL": "https://www.goodreads.com/author/show/3389.Stephen_King" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://biblioreads.eu.org/api/author/info"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"queryURL\": \"https://www.goodreads.com/author/show/3389.Stephen_King\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = ["queryURL": "https://www.goodreads.com/author/show/3389.Stephen_King"] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://biblioreads.eu.org/api/author/info")! 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() ```