Get Goodreads list
Get a Goodreads Listopia list with its ranked books, scores and votes.
Headers
Get your API keyAPI key (`sfk_...`)
Goodreads list id: the number in the page URL, e.g. `1`. A slug such as `1.Best_Books_Ever` or the full URL also works.
≥ 1 · ≤ 2147483647
Page number, starting at 1. Pass `page.nextPage` from the previous response to get the next page. Default 1, at most 1000.
≥ 1 · ≤ 1000
Endpoint-specific response payload.
`not_found` when no list has this id.
one of: found, not_found
The list when found; otherwise null.
List id.
List title.
List page URL.
Description as plain text.
Books on the list.
People who voted.
Likes.
Tags on the list.
Books on this page in rank order, 100 a page.
Book id (the number in `/book/show/{id}`).
Work id shared by every edition, when shown.
Title as the site shows it, with the series.
Book page URL.
Cover image URL. Link only; not hosted by Social Fetch.
Authors named on the row.
Author id.
Author name.
Author page URL.
Average rating, 0 to 5.
Number of ratings.
Year first published, when shown.
Number of editions, when shown.
Place in the list.
List score.
People who voted for it.
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/1" \
-H "x-api-key: YOUR_API_KEY"Responses
Goodreads Listopia list.