Search Goodreads books dataset
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).
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/datasets/goodreads-books/search
- Auth: API key in header x-api-key
Query parameters
Full-text query over title, author and description, max 256 characters
Exact genre filter (e.g. Fantasy, Romance, Nonfiction), max 128 characters
Exact format filter (e.g. Hardcover, Paperback, Kindle Edition), max 128 characters
Exact language filter (e.g. English, Spanish), max 128 characters
Exact publisher filter, max 128 characters
Exact author name filter (matches any credited contributor), max 128 characters
Exact Goodreads author id filter, max 128 characters
Exact series name filter, max 128 characters
Exact ISBN-10 filter, max 128 characters
Exact ISBN-13 filter, max 128 characters
Exact crawl run-id filter, max 128 characters
Minimum average rating, 0 through 5
Minimum number of ratings
Minimum page count
Maximum page count
Minimum publication year
Maximum publication year
Sort enum: relevance, rating_desc, reviews_desc, publication_desc, publication_asc, pages_desc, pages_asc, title_asc
Page number, defaults to 1
Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000
Headers
API key required
Response
OK
Example response
{
"code": 200,
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.