Skip to navigation

author-info-scraper

View as Markdown

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

KeyValueDescription
Content-Typeapplication/jsonIndicates the request body is JSON

Body

FieldTypeRequiredDescription
queryURLstringYesThe full Goodreads author page URL to scrape (e.g. https://www.goodreads.com/author/show/1077326.J_K_Rowling)

Example Body:

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

Response

200 Success

Returns a JSON object containing the scraped author profile information.

{
"status": "Received",
"statusCode": 200,
...
}

Response Field Descriptions

FieldTypeDescription
statusstringHuman-readable status message
statusCodenumberHTTP status code of the response
namestringFull name of the author
biostringAuthor biography as listed on Goodreads
genresarrayList of genres the author is known for
imagestringURL of the author’s profile image

Request

This endpoint expects an object.
queryURLstringRequiredformat: "uri"

Response

OK
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