Goodreads

List Goodreads lists

List the Goodreads Listopia lists that carry a tag.

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

API key (`sfk_...`)

Parameters
2
tagstringrequiredquery

Listopia tag, e.g. `fantasy`, `romance` or `best`.

min 1 chars · max 100 chars

pageintegeroptionalquery

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
20

Endpoint-specific response payload.

datatag
string

The tag.

Lists with the tag, 30 a page. Empty when no list has the tag.

datalists[]id
integer

List id.

datalists[]title
string

List title.

datalists[]url
string

List page URL.

datalists[]booksCount
integernullable

Books on the list.

datalists[]voters
integernullable

People who voted.

Covers of the top books. Links only.

datalists[]covers[]
stringoptional

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/lists?tag=fantasy" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Goodreads Listopia lists.