Books
Goodreads logo

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 / call

    Fetch 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 / call

    Fetch 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 / call

    Get 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 / call

    Search 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.

More Books APIs

All Books sites