Endpoint Playground
Test Crawlora's Goodreads Lists API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/goodreads/lists" \
-H "x-api-key: $CRAWLORA_API_KEY"No request parameters
{
"code": 200,
"msg": "OK",
"data": {
"lists": [
{
"id": "1",
"name": "Best Books Ever",
"category": "general"
},
{
"id": "264",
"name": "Books That Everyone Should Read At Least Once",
"category": "general"
},
{
"id": "339",
"name": "Books To Read Before I Die",
"category": "general"
},
{
"id": "3",
"name": "Best Science Fiction & Fantasy Books",
"category": "genre"
},
{
"id": "46",
"name": "Best Feminist Fiction",
"category": "genre"
},
{
"id": "47",
"name": "Best Dystopian and Post-Apocalyptic Fiction",
"category": "genre"
},
{
"id": "50",
"name": "The Best Epic Fantasy (fiction)",
"category": "genre"
},
{
"id": "43",
"name": "Best Young Adult Books",
"category": "young_adult"
},
{
"id": "141",
"name": "Best Young Adult Fiction",
"category": "young_adult"
},
{
"id": "86",
"name": "Best Children's Books",
"category": "children"
},
{
"id": "6",
"name": "Best Books of the 20th Century",
"category": "era"
},
{
"id": "22",
"name": "Best Books of the Decade: 1950s",
"category": "era"
},
{
"id": "17",
"name": "Best Books of the Decade: 1990s",
"category": "era"
},
{
"id": "122",
"name": "Best Books of 1994",
"category": "era"
},
{
"id": "4",
"name": "Best Books of 2008",
"category": "era"
},
{
"id": "499",
"name": "Favorite Christmas Books",
"category": "holiday"
}
]
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
Returns a curated, non-exhaustive catalog of well-known Goodreads Listopia lists (id, name, category) — Goodreads has no directory or search endpoint for the tens of thousands of user-created lists, so this is hand-picked and verified live, not derived from an upstream index. Pass a returned id to GET /goodreads/list/{id} for that list's ranked book contents. Category enum: `general`, `genre`, `era`, `young_adult`, `children`, `holiday`.
{
"code": 200,
"msg": "OK",
"data": {
"lists": [
{
"id": "1",
"name": "Best Books Ever",
"category": "general"
},
{
"id": "264",
"name": "Books That Everyone Should Read At Least Once",
"category": "general"
},
{
"id": "339",
"name": "Books To Read Before I Die",
"category": "general"
},
{
"id": "3",
"name": "Best Science Fiction & Fantasy Books",
"category": "genre"
},
{
"id": "46",
"name": "Best Feminist Fiction",
"category": "genre"
},
{
"id": "47",
"name": "Best Dystopian and Post-Apocalyptic Fiction",
"category": "genre"
},
{
"id": "50",
"name": "The Best Epic Fantasy (fiction)",
"category": "genre"
},
{
"id": "43",
"name": "Best Young Adult Books",
"category": "young_adult"
},
{
"id": "141",
"name": "Best Young Adult Fiction",
"category": "young_adult"
},
{
"id": "86",
"name": "Best Children's Books",
"category": "children"
},
{
"id": "6",
"name": "Best Books of the 20th Century",
"category": "era"
},
{
"id": "22",
"name": "Best Books of the Decade: 1950s",
"category": "era"
},
{
"id": "17",
"name": "Best Books of the Decade: 1990s",
"category": "era"
},
{
"id": "122",
"name": "Best Books of 1994",
"category": "era"
},
{
"id": "4",
"name": "Best Books of 2008",
"category": "era"
},
{
"id": "499",
"name": "Favorite Christmas Books",
"category": "holiday"
}
]
}
}curl "https://api.crawlora.net/api/v1/goodreads/lists" \
-H "x-api-key: $CRAWLORA_API_KEY"