Endpoint Playground
Searches Goodreads for books by title or author using `q`, returning up to `limit` results (default 10, max 50). Each result has its id, title, author and author id, average rating, ratings count, page count, a truncated description, cover image URL and Goodreads URL. Only books are returned, not authors or lists.
14 Oct 2026: 5 results; 10 fields had a value in every checked item.
Sample value profiles: average_rating: 4 to 4.49, median 4.36; image_url: i.gr-assets.com; description: median 178 characters.
curl 'https://api.crawlora.net/api/v1/goodreads/search?q=hunger+games' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | Yes | hunger games | Search query |
| limit | integer | No | Max results, default 10, max 50 |
{
"code": 200,
"msg": "OK",
"data": {
"query": "hunger games",
"results": [
{
"id": "2767052",
"title": "The Hunger Games",
"author": "Suzanne Collins",
"author_id": "153394",
"average_rating": 4.35,
"ratings_count": 10177818,
"pages": 374,
"description": "Winning means fame and fortune. Losing means certain death. The Hunger Games have begun...",
"image_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1586722975i/2767052._SX50_.jpg",
"uri": "https://www.goodreads.com/book/show/2767052-the-hunger-games"
}
],
"source_url": "https://www.goodreads.com/book/auto_complete?format=json&q=hunger+games"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.