API Reference
Use Crawlora's Goodreads API endpoints to extract supported public Goodreads data as structured JSON. This documentation covers 10 active endpoints including Get a Goodreads author, List a Goodreads author's books, List a Goodreads author's attributed quotes, Get a Goodreads book, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as id, name, q, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/goodreads/search?q=coffee&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/goodreads/author/{id}apiKey2 credits/requestReturns a normalized Goodreads author profile: bio, birth/death dates, website, genres, photo, and aggregate rating stats. Credential-free public Goodreads data.
Required params: id:path
/goodreads/author/{id}/booksapiKey2 credits/requestReturns an author's paginated works list (title, author, average rating, ratings count). Credential-free public Goodreads data.
Required params: id:path
/goodreads/author/{id}/quotesapiKey2 credits/requestReturns an author's paginated attributed-quotes list (quote text, tags, like count, and — when the quote is credited to a specific book — that book's title, id, and work id). Credential-free public Goodreads data.
Required params: id:path
/goodreads/book/{id}apiKey3 credits/requestReturns a normalized Goodreads book: description, authors, series, genres, format, pages, publisher, publication date, ISBNs, and aggregate rating with the full 1-5 star distribution. Credential-free public Goodreads data (goodreads.com), parsed from the book page's embedded GraphQL cache.
Required params: id:path
/goodreads/book/{id}/editionsapiKey3 credits/requestReturns a work's paginated edition list (per-edition book id, format, page count, publication date, publisher, ISBN/ISBN13/ASIN, language, and rating) — every other translation, printing, and format of the requested book id. Goodreads keys editions by a separate "work id", not the book id in the path, so this makes one extra internal request to resolve it; requests against a book with no editions data return an upstream error.
Required params: id:path
/goodreads/book/{id}/reviewsapiKey2 credits/requestReturns a book's featured reviews (reviewer, rating, text, date, like/comment counts, spoiler flag), sorted by like count. Credential-free public Goodreads data.
Required params: id:path
/goodreads/genre/{name}apiKey2 credits/requestReturns up to 50 books on a Goodreads genre/shelf tag page (e.g. fantasy, romance, science-fiction), Goodreads' credential-free 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.
Required params: name:path
/goodreads/list/{id}apiKey2 credits/requestReturns a Goodreads Listopia list (ranked book list) by id, paginated. Credential-free public Goodreads data; page 1 of well-known lists may be served from a faster live source, with the public list page itself as fallback for every other case.
Required params: id:path
/goodreads/listsapiKey1 credit/requestReturns a 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 served from a live popular-lists source when available, falling back to a curated, hand-picked catalog otherwise. 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`.
Required params: None
/goodreads/searchapiKey1 credit/requestSearches Goodreads books by title/author. Credential-free public Goodreads data via the autocomplete endpoint (book results only).
Required params: q:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get a Goodreads author | /goodreads/author/{id} | GET | 2 credits/request | id:path | View docs | Try endpoint |
| List a Goodreads author's books | /goodreads/author/{id}/books | GET | 2 credits/request | id:path | View docs | Try endpoint |
| List a Goodreads author's attributed quotes | /goodreads/author/{id}/quotes | GET | 2 credits/request | id:path | View docs | Try endpoint |
| Get a Goodreads book | /goodreads/book/{id} | GET | 3 credits/request | id:path | View docs | Try endpoint |
| List a Goodreads book's editions | /goodreads/book/{id}/editions | GET | 3 credits/request | id:path | View docs | Try endpoint |
| Get a Goodreads book's featured reviews | /goodreads/book/{id}/reviews | GET | 2 credits/request | id:path | View docs | Try endpoint |
| Get a Goodreads genre shelf | /goodreads/genre/{name} | GET | 2 credits/request | name:path | View docs | Try endpoint |
| Get a Goodreads Listopia list | /goodreads/list/{id} | GET | 2 credits/request | id:path | View docs | Try endpoint |
| List curated Goodreads Listopia lists | /goodreads/lists | GET | 1 credit/request | None | View docs | Try endpoint |
| Search Goodreads books | /goodreads/search | GET | 1 credit/request | q:query | View docs | Try endpoint |