Goodreads API

Goodreads Scraper API for Books, Reviews, Ratings and Authors

Look up Goodreads books with ratings, genres, series, ISBNs and awards, page through community reviews and search books by title, author or ISBN. Read author profiles and list their books.

Gibran Pulga, CEO of Desys FinanceGibran PulgaCEO, Desys Finance

We use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.

WHAT YOU CAN BUILD / 05 ENDPOINTS

Put Goodreads data to work.

Find your use case, then explore the request and response.

Get a Goodreads book

GET/v1/goodreads/book

Build a book detail card from a Goodreads URL or ID with the title, series, authors, description, cover, genres, average rating, rating distribution, pages, publisher, ISBN and awards.

List Goodreads book reviews

GET/v1/goodreads/book-reviews

Build a review sentiment tracker from star ratings, review text, spoiler flags, dates, likes, comments and reviewer profiles. Continue with the returned nextCursor.

Search Goodreads books

GET/v1/goodreads/search

Build a book matcher that turns a title, author or ISBN into Goodreads book IDs with covers, authors, average ratings, rating counts and publication years. Continue with page while hasMore is true.

Get a Goodreads author

GET/v1/goodreads/author

Build an author directory from names, photos, birth and death dates, websites, genres, influences, biographies, rating totals, work counts and followers.

List a Goodreads author's books

GET/v1/goodreads/author-books

Build an author bibliography from book IDs, titles, covers, average ratings, rating counts, publication years and edition counts. Continue with page while hasMore is true.

HOW IT WORKS

From API key to Goodreads data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 5 Goodreads endpoints and add its input, such as a public URL.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Goodreads data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

LIVE RESULTS

Try a sample request.

Try the Goodreads API right here. This sample uses the Get a Goodreads book endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with https://www.goodreads.com/book/show/2767052-the-hunger-games, or change the url field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Get a Goodreads bookNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "https://www.goodreads.com/book/show/2767052-the-hunger-games";
const url = new URL("/website/demo/goodreads",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/goodreads/book

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

  • Matteo L.Small-Business (50 or fewer emp.)

    “Easy, Affordable Scraping for Product Ideas—More Platforms Needed”

    I use ScrapeAtlas to find product ideas—real ideas that people need. I couldn’t get to people’s ideas on social media platforms without it. I like that it’s easy and capable, and it isn’t expensive. I value the scraping and MCP features. …

    Read on G2
  • Ms H.Sales, Mid-Market (51-1000 emp.)

    “ScrapeAtlas Replaces Multiple Scrapers with One Simple Solution”

    ScrapeAtlas saves me from juggling a different scraper for every platform. … ScrapeAtlas solves the problem of getting reliable public data from many social and e-commerce platforms without building and maintaining my own scrapers.

    Read on G2
  • We use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.

    Gibran PulgaCEO, Desys Finance
  • Stas D.Founder, Marketing and Advertising

    “Reliable parsers and flexible API for audience search”

    I like the convenient documentation and conditions at ScrapeAtlas. The parsers work great: I use keyword data from fresh threads to find target audiences and clients in Threads. I also appreciate the higher quality API responses and more detailed request customization. The initial setup was very easy for me.

    Read on G2

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 credits

Growth

Popular

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 credits

Save 6.3% compared with Starter

Scale

For high-volume data collection.

$249USD / one-time

200,000 credits

$1.25 per 1,000 credits

Save 34.5% compared with Starter

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Goodreads API

Frequently Asked Questions

Explore the API reference

Goodreads API and scraping

How do I get the reviews of a Goodreads book?

Send a Goodreads book URL or ID to List Goodreads book reviews to retrieve 30 reviews per page with the star rating, review text, spoiler flag, creation and update dates, likes, comments, shelf and the reviewer’s public profile. Pass the returned nextCursor as cursor with the same book for the next page; it is null on the last page.

What public Goodreads data can I retrieve with the API?

Look up books with ratings, genres, series, ISBNs and awards, list community reviews, search books by title, author or ISBN, and read author profiles and their books as structured JSON. Each response names its source page and reports coverage warnings when a field could not be mapped.

How do I search Goodreads books by title, author or ISBN?

Send a query to Search Goodreads books to retrieve 20 books per page with the book ID, title, cover, authors, average rating, rating count, first publication year, edition count and work ID. Pass a higher page while hasMore is true, then use the book ID with Get a Goodreads book for full details.

Goodreads: books, reviews and authors

Can I get a book’s Goodreads rating and rating distribution?

Yes. Get a Goodreads book returns the average rating, the number of ratings and text reviews, and the number of one- to five-star ratings, counted across all editions of the work. The same response includes the genres, series, page count, publisher, publication date, ISBN, ASIN and language of the requested edition.

Which genres and series does a Goodreads book belong to?

Get a Goodreads book returns the book’s top genres in Goodreads’ order with each genre’s page link, and every series the book belongs to with its title, link and the book’s position in the series. It also lists the literary awards the work won or was nominated for.

How do I get a Goodreads author’s profile and books?

Send an author URL or ID to Get a Goodreads author for the name, photo, birth and death dates, birthplace, website, genres, influences, biography, rating totals, number of works and followers. List a Goodreads author’s books with the same input returns 30 books per page with ratings, publication years and edition counts.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?