Goodreads

List Goodreads quotes

List Goodreads quotes for a tag or by an author, most liked first.

GET/v1/goodreads/quotes
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
tagstringquery

Quotes with this tag, e.g. `love` or `inspirational`. Give `tag` or `authorId`, not both.

min 1 chars · max 100 chars

authorIdintegerquery

Quotes by this author: the number in the author page URL, e.g. `153394`. Give `tag` or `authorId`, not both.

≥ 1 · ≤ 2147483647

pageintegerquery

Page number, starting at 1. Pass `page.nextPage` from the previous response to get the next page. Default 1, at most 100.

≥ 1 · ≤ 100

Response fields
33

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no author has this id. A tag with no quotes is found with an empty list.

one of: found, not_found

datatag
stringnullable

The tag, for a tag request.

The author, for an author request.

dataauthorid
integernullable

Author id.

dataauthorname
string

Author name.

dataauthorurl
stringnullable

Author page URL.

Quotes on this page, most liked first, 30 a page.

dataquotes[]id
integernullable

Quote id.

dataquotes[]text
string

The quote.

dataquotes[]url
stringnullable

Quote page URL.

Who said or wrote it.

dataquotes[]authorid
integernullable

Author id.

dataquotes[]authorname
string

Author name.

dataquotes[]authorurl
stringnullable

Author page URL.

The book it comes from, when the site names one.

dataquotes[]booktitle
string

Title.

dataquotes[]bookurl
stringnullable

Work or book page URL.

dataquotes[]bookworkId
integernullable

Work id, when linked.

Tags.

dataquotes[]tags[]
stringoptional
dataquotes[]likes
integernullable

Likes.

dataquotes[]image
stringnullable

Author or quote image URL. Link only.

Pagination state for the current page.

datapagepage
integer

Current page number.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number; null on the last page.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/goodreads/quotes?tag=love" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Goodreads quotes.