Endpoint Playground
Searches the crawled public Goodreads book catalog stored in a search index. Discovered from curated Listopia "best of" lists, a search-term sweep, and author bibliography expansion — not a full catalog. Sort enum: `relevance`, `rating_desc`, `reviews_desc`, `publication_desc`, `publication_asc`, `pages_desc`, `pages_asc`, `title_asc`. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100). Dataset Playground requests query indexed data and do not apply proxy routing.
14 Oct 2026: 1 items; 34 fields had a value in every checked item.
Sample value profiles: publication_date: 2008-10-14; image_url: m.media-amazon.com; description: median 843 characters.
curl 'https://api.crawlora.net/api/v1/datasets/goodreads-books/search?sort=relevance' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Full-text query over title, author and description, max 256 characters | |
| genre | string | No | Exact genre filter (e.g. Fantasy, Romance, Nonfiction), max 128 characters | |
| format | string | No | Exact format filter (e.g. Hardcover, Paperback, Kindle Edition), max 128 characters | |
| language | string | No | Exact language filter (e.g. English, Spanish), max 128 characters | |
| publisher | string | No | Exact publisher filter, max 128 characters | |
| author | string | No | Exact author name filter (matches any credited contributor), max 128 characters | |
| author_id | string | No | Exact Goodreads author id filter, max 128 characters | |
| series | string | No | Exact series name filter, max 128 characters | |
| isbn | string | No | Exact ISBN-10 filter, max 128 characters | |
| isbn13 | string | No | Exact ISBN-13 filter, max 128 characters | |
| run_id | string | No | Exact crawl run-id filter, max 128 characters | |
| min_rating | number | No | Minimum average rating, 0 through 5 | |
| min_ratings_count | integer | No | Minimum number of ratings | |
| min_pages | integer | No | Minimum page count | |
| max_pages | integer | No | Maximum page count | |
| min_publication_year | integer | No | Minimum publication year | |
| max_publication_year | integer | No | Maximum publication year | |
| sort | string | No | relevance | Sort enum: relevance, rating_desc, reviews_desc, publication_desc, publication_asc, pages_desc, pages_asc, title_asc |
| page | integer | No | Page number, defaults to 1 | |
| page_size | integer | No | Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000 |
{
"code": 200,
"msg": "OK",
"data": {
"dataset": "goodreads-books",
"items": [
{
"id": "2767052",
"title": "The Hunger Games",
"authors": [
"Suzanne Collins"
],
"author_ids": [
"153394"
],
"primary_author": "Suzanne Collins",
"primary_author_id": "153394",
"series": "The Hunger Games #1",
"series_name": "The Hunger Games",
"genres": [
"Young Adult",
"Fiction",
"Dystopia"
],
"format": "Hardcover",
"pages": 374,
"publisher": "Scholastic Press",
"publication_date": "2008-10-14",
"publication_year": 2008,
"isbn": "0439023483",
"isbn13": "9780439023481",
"language": "English",
"rating_average": 4.35,
"ratings_count": 10189669,
"reviews_count": 272857
}
],
"page": 1,
"page_size": 20,
"total": 1,
"sort": "reviews_desc"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.