Skip to navigation

quotes-slug

View as Markdown

Scrapes quotes from a Goodreads quotes tag or slug page using a direct tag URL. Returns a collection of quotes associated with the specified tag or topic.


Request

Method: POST
URL: {{Instance Domain}}/api/quotes/slug

Headers

KeyValueDescription
Content-Typeapplication/jsonIndicates the request body is JSON

Body

FieldTypeRequiredDescription
queryURLstringYesThe full Goodreads quotes tag page URL to scrape (e.g. https://www.goodreads.com/quotes/tag/love)

Example Body:

{
"queryURL": "https://www.goodreads.com/quotes/tag/love"
}

Response

200 Success

Returns a JSON object containing quotes scraped from the specified tag page.

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

Response Field Descriptions

FieldTypeDescription
statusstringHuman-readable status message
statusCodenumberHTTP status code of the response
tagstringThe tag or slug used to filter quotes
quotesarrayList of quotes from the tag page, each with quote text, author, and like count

Request

This endpoint expects an object.
queryURLstringRequiredformat: "uri"

Response

OK
statusstring
sourcestringformat: "uri"
scrapeURLstringformat: "uri"
namestring
quoteslist of objects
popularTagslist of objects
lastScrapeddatetime