Endpoint Playground
Returns a Goodreads Listopia list (ranked book list) by id, paginated.
14 Oct 2026: 100 books; 6 fields had a value in every checked item.
Sample value profiles: average_rating: 3.68 to 4.62, median 4.16; uri: goodreads.com; ratings_count: 45,852 to 11,866,997, median 1,722,942.
curl 'https://api.crawlora.net/api/v1/goodreads/list/1' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| id (path) | string | Yes | 1 | Goodreads list id |
| page | integer | No | 1-based page number, default 1 |
{
"code": 200,
"msg": "OK",
"data": {
"id": "1",
"title": "Best Books Ever",
"page": 1,
"books": [
{
"id": "2767052",
"title": "The Hunger Games (The Hunger Games, #1)",
"author": "Suzanne Collins",
"average_rating": 4.35,
"ratings_count": 10177818,
"uri": "https://www.goodreads.com/book/show/2767052-the-hunger-games"
},
{
"id": "1885",
"title": "Pride and Prejudice",
"author": "Jane Austen",
"average_rating": 4.3,
"ratings_count": 4953851,
"uri": "https://www.goodreads.com/book/show/1885.Pride_and_Prejudice"
}
],
"source_url": "https://www.goodreads.com/list/show/1?page=1"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.