author-info-scraper

POST

https://biblioreads.eu.org/api/author/info

POST

/api/author/info

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

200Successful

1 {
2   "status": "Received",
3   "source": "https://github.com/nesaku/biblioreads",
4   "scrapeURL": "https://www.goodreads.com/author/show/3389.Stephen_King",
5   "image": "https://images.gr-assets.com/authors/1362814142p5/3389.jpg",
6   "name": "Stephen  King",
7   "website": "http://www.stephenking.com",
8   "genre": [
9     "Horror",
10     "Mystery",
11     "Literature & Fiction"
12   ],
13   "influences": [
14     {
15       "id": 1,
16       "author": "Robert Bloch",
17       "url": "https://www.goodreads.com/author/show/12540.Robert_Bloch"
18     },
19     {
20       "id": 2,
21       "author": "Ray Bradbury",
22       "url": "https://www.goodreads.com/author/show/1630.Ray_Bradbury"
23     },
24     {
25       "id": 3,
26       "author": "Charles Dickens",
27       "url": "https://www.goodreads.com/author/show/239579.Charles_Dickens"
28     },
29     {
30       "id": 4,
31       "author": "Shirley Jackson",
32       "url": "https://www.goodreads.com/author/show/13388.Shirley_Jackson"
33     },
34     {
35       "id": 5,
36       "author": "H.P. Lov",
37       "url": "https://www.goodreads.com/author/show/9494.H_P__Lovecraft"
38     },
39     {
40       "id": 6,
41       "author": "Robert Bloch",
42       "url": "https://www.goodreads.com/author/show/12540.Robert_Bloch"
43     },
44     {
45       "id": 7,
46       "author": "Ray Bradbury",
47       "url": "https://www.goodreads.com/author/show/1630.Ray_Bradbury"
48     },
49     {
50       "id": 8,
51       "author": "Charles Dickens",
52       "url": "https://www.goodreads.com/author/show/239579.Charles_Dickens"
53     },
54     {
55       "id": 9,
56       "author": "Shirley Jackson",
57       "url": "https://www.goodreads.com/author/show/13388.Shirley_Jackson"
58     },
59     {
60       "id": 10,
61       "author": "H.P. Lovecraft",
62       "url": "https://www.goodreads.com/author/show/9494.H_P__Lovecraft"
63     },
64     {
65       "id": 11,
66       "author": "John D. MacDonald",
67       "url": "https://www.goodreads.com/author/show/24690.John_D__MacDonald"
68     },
69     {
70       "id": 12,
71       "author": "Richard Matheson",
72       "url": "https://www.goodreads.com/author/show/8726.Richard_Matheson"
73     },
74     {
75       "id": 13,
76       "author": "J.R.R. Tolkien",
77       "url": "https://www.goodreads.com/author/show/656983.J_R_R__Tolkien"
78     }
79   ],
80   "birthDate": "",
81   "deathDate": "",
82   "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",
83   "books": [
84     {
85       "id": 1,
86       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1353277730i/11588._SY75_.jpg",
87       "title": "The Shining (The Shining, #1)",
88       "url": "/book/show/11588.The_Shining",
89       "rating": " 4.28 avg rating From 1744,672 ratings",
90       "publishDate": "\n                 4.28 avg rating — 1,744,672 ratings\n              —\n                published\n               1977\n              —\n              542 editions\n          "
91     },
92     {
93       "id": 2,
94       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1334416842i/830502._SY75_.jpg",
95       "title": "It",
96       "url": "/book/show/830502.It",
97       "rating": " 4.24 avg rating From 1300,261 ratings",
98       "publishDate": "\n                 4.24 avg rating — 1,300,261 ratings\n              —\n                published\n               1986\n              —\n              20 editions\n          "
99     },
100     {
101       "id": 3,
102       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1674820514i/87591651._SX50_.jpg",
103       "title": "The Stand",
104       "url": "/book/show/87591651-the-stand",
105       "rating": " 4.35 avg rating From 852483 ratings",
106       "publishDate": "\n                 4.35 avg rating — 852,483 ratings\n              —\n                published\n               1978\n              —\n              22 editions\n          "
107     },
108     {
109       "id": 4,
110       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1746142586i/10614._SY75_.jpg",
111       "title": "Misery",
112       "url": "/book/show/10614.Misery",
113       "rating": " 4.22 avg rating From 842550 ratings",
114       "publishDate": "\n                 4.22 avg rating — 842,550 ratings\n              —\n                published\n               1987\n              —\n              291 editions\n          "
115     },
116     {
117       "id": 5,
118       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1771367607i/10592._SY75_.jpg",
119       "title": "Carrie",
120       "url": "/book/show/10592.Carrie",
121       "rating": " 3.99 avg rating From 868507 ratings",
122       "publishDate": "\n                 3.99 avg rating — 868,507 ratings\n              —\n                published\n               1974\n          "
123     },
124     {
125       "id": 6,
126       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1327876792i/10644930._SY75_.jpg",
127       "title": "11/22/63",
128       "url": "/book/show/10644930-11-22-63",
129       "rating": " 4.35 avg rating From 687334 ratings",
130       "publishDate": "\n                 4.35 avg rating — 687,334 ratings\n              —\n                published\n               2011\n              —\n              14 editions\n          "
131     },
132     {
133       "id": 7,
134       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1480069533i/33124137._SY75_.jpg",
135       "title": "Pet Sematary",
136       "url": "/book/show/33124137-pet-sematary",
137       "rating": " 4.09 avg rating From 719345 ratings",
138       "publishDate": "\n                 4.09 avg rating — 719,345 ratings\n              —\n                published\n               1983\n              —\n              457 editions\n          "
139     },
140     {
141       "id": 8,
142       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1738025067i/11590._SY75_.jpg",
143       "title": "’Salem’s Lot",
144       "url": "/book/show/11590._Salem_s_Lot",
145       "rating": " 4.10 avg rating From 675041 ratings",
146       "publishDate": "\n                 4.10 avg rating — 675,041 ratings\n              —\n                published\n               1975\n              —\n              42 editions\n          "
147     },
148     {
149       "id": 9,
150       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1770544533i/247642509._SY75_.jpg",
151       "title": "The Gunslinger (Dark Tower, #1)",
152       "url": "/book/show/247642509-the-gunslinger",
153       "rating": " 3.91 avg rating From 674579 ratings",
154       "publishDate": "\n                 3.91 avg rating — 674,579 ratings\n              —\n                published\n               1982\n              —\n              7 editions\n          "
155     },
156     {
157       "id": 10,
158       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1373903563i/11566._SY75_.jpg",
159       "title": "The Green Mile",
160       "url": "/book/show/11566.The_Green_Mile",
161       "rating": " 4.49 avg rating From 372752 ratings",
162       "publishDate": "\n                 4.49 avg rating — 372,752 ratings\n              —\n                published\n               1996\n              —\n              294 editions\n          "
163     }
164   ],
165   "series": [
166     {
167       "id": 1,
168       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1770544533l/247642509._SY75_.jpg",
169       "title": "The Dark Tower",
170       "seriesURL": "/series/40750-the-dark-tower",
171       "author": "Stephen  King",
172       "authorURL": "/author/show/3389.Stephen_King",
173       "rating": " 4.12 avg rating — 2,180,350 ratings"
174     },
175     {
176       "id": 2,
177       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1353277730l/11588._SY75_.jpg",
178       "title": "The Shining",
179       "seriesURL": "/series/117014-the-shining",
180       "author": "Stephen  King",
181       "authorURL": "/author/show/3389.Stephen_King",
182       "rating": " 4.26 avg rating — 2,049,348 ratings"
183     },
184     {
185       "id": 3,
186       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1524596540l/36124936._SY75_.jpg",
187       "title": "Holly Gibney",
188       "seriesURL": "/series/318697-holly-gibney",
189       "author": "Stephen  King",
190       "authorURL": "/author/show/3389.Stephen_King",
191       "rating": " 4.03 avg rating — 1,538,249 ratings"
192     },
193     {
194       "id": 4,
195       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1468705326l/18775247._SY75_.jpg",
196       "title": "Bill Hodges",
197       "seriesURL": "/series/137422-bill-hodges",
198       "author": "Stephen  King",
199       "authorURL": "/author/show/3389.Stephen_King",
200       "rating": " 4.06 avg rating — 742,932 ratings"
201     },
202     {
203       "id": 5,
204       "cover": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1228499552l/92227._SY75_.jpg",
205       "title": "The Green Mile",
206       "seriesURL": "/series/69946-the-green-mile",
207       "author": "Stephen  King",
208       "authorURL": "/author/show/3389.Stephen_King",
209       "rating": " 4.50 avg rating — 504,080 ratings"
210     }
211   ],
212   "lastScraped": "2026-06-15T00:43:18Z"
213 }

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:

1 {
2   "queryURL": "https://www.goodreads.com/author/show/1077326.J_K_Rowling"
3 }

Response

200 Success

Returns a JSON object containing the scraped author profile information.

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

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

Request

This endpoint expects an object.

queryURLstringRequiredformat: "uri"

Response

statusstring

sourcestringformat: "uri"

scrapeURLstringformat: "uri"

imagestringformat: "uri"

namestring

websitestringformat: "uri"

genrelist of strings

influenceslist of objects

birthDatestring

deathDatestring

descstring

bookslist of objects

serieslist of objects

lastScrapeddatetime

1	{
2	"queryURL": "https://www.goodreads.com/author/show/1077326.J_K_Rowling"
3	}