Goodreads API
goodreads.com
Goodreads — search books by title/author/ISBN, fetch book details with ratings and genres, get author profiles, browse curated book lists.
- Actions
- 4
- Category
- Books
- Login
- Not required
- Output
- JSON
Call the Goodreads API
Submit a task, then poll the job until it settles. This example runs gr_author_details.
curl -X POST https://api.anakin.io/v1/wire/task \
-H "X-API-Key: $ANAKIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action_id": "gr_author_details",
"params": {
"author_id": "<author_id>"
}
}'4 actions on goodreads.com
Read
Goodreads Author Details
gr_author_detailsread1 credit / callFetch author profile — name, image, genres, and their books with ratings, rating counts, published year, editions.
- author_id
- string · required
Goodreads Book Details
gr_book_detailsread1 credit / callFetch full book details — rating, review count, genres, description, author, pages, format, awards, publication info.
- book_id
- string · required
Goodreads List Books
gr_list_booksread1 credit / callGet books from a Goodreads curated list with scores, votes, author, and ratings. 100 books per page.
- list_id
- string · required
- page
- integer
Search Goodreads Books
gr_search_booksread1 credit / callSearch books by title, author, or ISBN. Returns book listings with ratings, rating counts, published year, and editions.
- query
- string · required
- page
- integer
Goodreads API questions
- Is there an API for Goodreads?
- Goodreads does not offer a public data API for this, but Anakin Wire provides 4 maintained endpoints for goodreads.com. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
- How do I scrape Goodreads data?
- POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when goodreads.com changes its markup, Anakin updates the action.
- Do I need a Goodreads account?
- No. Every Goodreads action listed here runs anonymously — no account and no credentials required.
- What does the Goodreads API cost?
- Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.