News Media
Goodreads logo

Goodreads API

goodreads.com

Book catalog - titles, ratings, genres, author profiles, and curated lists.

Actions
4
Category
News Media
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": "7327369"
    }
  }'

4 actions on goodreads.com

Read

  • Author Details

    gr_author_detailsread3 credits / call

    Returns an author profile with name, image, genres, and their books with ratings.

    author_id
    string · required
  • Book Details

    gr_book_detailsread2 credits / call

    Returns full book details including rating, genres, description, author, pages, and awards.

    book_id
    string · required
  • Book List

    gr_list_booksread2 credits / call

    Returns books from a curated list with scores, votes, author, and ratings.

    list_id
    string · required
    page
    integer
  • Book Search

    gr_search_booksread1 credit / call

    Returns books matching a title, author, or ISBN with ratings, 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 News Media APIs

All News Media sites