GET
Book Search
/api/goodreads/search
Search public Goodreads books by keyword with pagination
Goodreads API
Goodreads API for Book Search, Book Details, Reviews, and Author Profiles
Scrappa's Goodreads API returns structured JSON from Goodreads, the world's largest book catalog. Search books by keyword with pagination, open any book for its description, ratings, star distribution, genres, series, ISBN and cover, read public reviews with cursor pagination, and fetch author profiles with their works list. Scrappa is an independent service and is not affiliated with or endorsed by Goodreads.
500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
4
Endpoints
2368+
Searchable books
$0.20
Per 1k requests
Try it now
Make one request. Inspect structured JSON.
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
Request preview
Request
curl -X GET "https://scrappa.co/api/goodreads/search?query=the+lord+of+the+rings" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
JSON response
{
"success": true,
"data": {
"page": 1,
"per_page": 20,
"total": 2368,
"has_more": true,
"results": [
{
"position": 1,
"id": "61215351",
"title": "The Fellowship of the Ring (The Lord of the Rings, #1)",
"author": "J.R.R. Tolkien",
"average_rating": 4.41,
"ratings_count": 3246470,
"published_year": 1954,
"cover_url": "https://i.gr-assets.com/images/S/compressed.photo.goodreads.com/books/1654215925i/61215351._SY75_.jpg",
"editions_count": 142
}
]
},
"meta": { "endpoint_family": "search", "billable": true }
}What you can build
Structured data for real applications. Here are some ideas.
Book Discovery
Search the Goodreads catalog by keyword and collect matching books with average ratings, ratings counts, published years and covers.
Book Detail Enrichment
Open any book for its description in HTML and plain text, genres, series, ISBN, format, publisher and the full 5-to-1 star rating distribution.
Review Mining
Page through public reviews with opaque cursors to build sentiment datasets, reviewer profiles and like counts per review.
Author Tracking
Follow author profiles with birth and death dates, bios and full works lists including per-book ratings and edition counts.
Goodreads scraper API
Goodreads API for book search, book details, reviews and author profiles
The Goodreads API is built for book discovery, catalog enrichment and review mining. Each search result includes book id, title, author, average rating, ratings count, published year, cover image, editions count and a 1-based position. Book detail adds the description in HTML and plain text, genres, series, ISBN, format, publisher, the full 5-to-1 star distribution and the work id.
Search the public Goodreads catalog by keyword with 1-based pagination.
Open any book for description in HTML and plain text, genres, series, ISBN, format, publisher and rating stats.
Read public reviews with opaque cursor pagination, ratings, dates, like counts and spoiler flags.
Fetch author profiles with birth and death dates, bio in HTML and plain text, and the works list.
Covers and urls are always absolute https links.
Choose the right Goodreads API endpoint
Use Book Search for catalog coverage
Search by keyword and paginate with the 1-based page parameter. Each result carries book id, title, author, average rating, ratings count, published year, cover and editions count.
Open Goodreads Search API docsUse Book Detail for full book records
Open a book by its legacy id for the description in HTML and plain text, genres, series, ISBN, format, publisher, average rating, ratings count, the 5-to-1 star distribution and the work id.
Open Goodreads Book API docsUse Book Reviews for review mining
Pass a book id to page through public reviews with the opaque after cursor. Each review carries the reviewer, rating, date, like count and spoiler flag.
Open Goodreads Reviews API docsUse Author Detail for author tracking
Pass an author id to read the profile with birth and death dates, bio in HTML and plain text, and the works list with per-book ratings and edition counts.
Open Goodreads Author API docsAvailable endpoints
Everything you need in one API.
GET
Book Detail
/api/goodreads/book
Get the full book record: description, ratings, star distribution, genres, series, ISBN and cover
GET
Book Reviews
/api/goodreads/reviews
Read public reviews for a book with cursor pagination, ratings, dates, like counts and spoiler flags
GET
Author Detail
/api/goodreads/author
Get an author profile with bio and works list including per-book ratings
Related resources
Scrappa vs ScrapingBee / ScraperAPI
See how Scrappa compares to the official API.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| Goodreads data as JSON | Build your own parser | |
| Star rating distribution | Parse it yourself | |
| Reviews with cursor pagination | ||
| Author works lists | Scrape each page | |
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
Goodreads data as JSON
Scrappa:
ScrapingBee / ScraperAPI:
Build your own parser
Star rating distribution
Scrappa:
ScrapingBee / ScraperAPI:
Parse it yourself
Reviews with cursor pagination
Scrappa:
ScrapingBee / ScraperAPI:
Author works lists
Scrappa:
ScrapingBee / ScraperAPI:
Scrape each page
Price per 1k requests
Scrappa:
From $0.20
ScrapingBee / ScraperAPI:
Varies by credits per request
Unified API key
Scrappa:
Yes (80+ APIs)
ScrapingBee / ScraperAPI:
Scraping only
Free tier
Scrappa:
500 credits/month
ScrapingBee / ScraperAPI:
Trial credits
Key features
Book search with 1-based pagination and a total count
Full book details with description in HTML and plain text, genres, series, ISBN and format
Average rating, ratings count and the 5-to-1 star rating distribution
Public reviews with opaque cursor pagination and spoiler flags
Author profiles with birth and death dates, bio and works list
Covers and urls are always absolute https links
Frequently asked questions
No. Scrappa is an independent service and is not affiliated with or endorsed by Goodreads. The Goodreads API returns structured JSON from public Goodreads pages through a Scrappa API key.
Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan. Failed requests are never charged.
Search uses 1-based page numbers with 20 results per page and returns total and has_more. Reviews use opaque cursors: pass the next_cursor value as the after parameter, and has_more is true while a next page token exists. A valid empty result is a successful response.
ISBN and ISBN13 are omitted when Goodreads does not list them for the edition, unrated reviews omit the rating, and author death dates are omitted when the author is alive. A valid book without an ISBN is a successful response, not an error.