v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-15150454.0 KB
quotes

quotes-slug

Quotes Search

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
post/api/quotes/slug

Request body

queryURLstring uri required

Response

OK

statusstring required
sourcestring uri required
scrapeURLstring uri required
namestring required
lastScrapedstring date-time required