Endpoint Playground
Returns up to 50 books on a Goodreads genre/shelf tag page (e.g. fantasy, romance, science-fiction), Goodreads' per-tag "top books" view: title, author, average rating, ratings count, publication year, and how many times the book was shelved under this specific tag. Goodreads' genre/shelf taxonomy is an open, user-generated folksonomy of thousands of tags, not a small fixed list, so there is no directory endpoint — pass any known tag slug, e.g. from a book's genres[] field or a value seen on goodreads.com. There is no pagination beyond the first 50.
14 Oct 2026: 50 books; 9 fields had a value in every checked item.
Sample value profiles: average_rating: 3.68 to 4.66, median 4.36; uri: goodreads.com; ratings_count: 448,540 to 11,867,041, median 1,793,915.
curl 'https://api.crawlora.net/api/v1/goodreads/genre/fantasy' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| name (path) | string | Yes | fantasy | Goodreads genre/shelf tag |
{
"code": 200,
"msg": "OK",
"data": {
"name": "fantasy",
"books": [
{
"id": "42844155",
"title": "Harry Potter and the Philosopher's Stone (Harry Potter, #1)",
"author": "J.K. Rowling",
"author_id": "1077326",
"average_rating": 4.47,
"ratings_count": 11710306,
"publication_year": 1997,
"shelved_count": 89892,
"uri": "https://www.goodreads.com/book/show/42844155-harry-potter-and-the-philosopher-s-stone"
},
{
"id": "5907",
"title": "The Hobbit, or There and Back Again (Paperback)",
"author": "J.R.R. Tolkien",
"author_id": "656983",
"average_rating": 4.3,
"ratings_count": 4585794,
"publication_year": 1937,
"shelved_count": 73195,
"uri": "https://www.goodreads.com/book/show/5907.The_Hobbit"
}
]
},
"source_url": "https://www.goodreads.com/shelf/show/fantasy"
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.