List Goodreads lists
List the Goodreads Listopia lists that carry a tag.
Headers
Get your API keyAPI key (`sfk_...`)
Listopia tag, e.g. `fantasy`, `romance` or `best`.
min 1 chars · max 100 chars
Page number, starting at 1. Pass `page.nextPage` from the previous response to get the next page. Default 1, at most 100.
≥ 1 · ≤ 100
Endpoint-specific response payload.
The tag.
Lists with the tag, 30 a page. Empty when no list has the tag.
List id.
List title.
List page URL.
Books on the list.
People who voted.
Covers of the top books. Links only.
Pagination state for the current page.
Current page number.
≥ 0
Whether another page is available.
Next page number; null on the last page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
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
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.