All platforms11 Goodreads endpoints

Goodreads API. Books and readers as JSON.

Books, reader reviews and their comments, editions, authors, series, quotes and Listopia lists. 11 routes under /v1/goodreads, one credit per request.

No credit card requiredRead the API docs
  • 11 routes
  • Books + reviews
  • 1 credit per request
  • Failed requests aren't charged
99.8% uptime#3 Product of the Day3,200+ developers

Teams running monitoring, research, and enrichment pipelines

Goodreads data as JSON. You build the product.

Live Goodreads data in one response shape, with platform changes handled for you.

Goodreads, plus every other platform

One key and one response envelope for Goodreads and 86 more platforms.

  • API key

    sk_live_••••••••

Pricing you can reason about

One request, one credit. Know how far your balance will go before you run your next batch.

Requests
480
Credits
480

Balance

Live data on every request

Fetch public data when you ask for it.

Just now1h ago

Nothing to maintain

We handle platform changes and breakages.

Built for production jobs

Run concurrent workloads with explicit statuses and request IDs.

req_8f42200
req_a91c200
req_3e07200
req_d5b8200

lookupStatus: found

Regular jobs. Better rates.

Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.

MonthlyLower rate
Pay as you go

Example request

GET /v1/goodreads/books/{bookId}. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON
Use cases

What teams build with Goodreads data

Monitoring, enrichment, research and content workflows on Goodreads data, on the same API as every other platform.

Track books

Follow ratings, review counts and new reviews for the titles you publish or sell.

Research readers

Read what readers say about a book, an author or a genre, across every edition.

How it works

Your first request in three steps.

Use TypeScript or your automation tool of choice.

  1. API key

    sfk_live_••••••••••••

    Free requests100

    Step 1: Create your free account

    Get an API key with 100 requests included.

  2. GET/v2/instagram/profiles/charlidamelio

    1 request · 1 credit

    Step 2: Choose an endpoint

    Pass a username, URL, keyword, or post ID.

  3. 200 OK1.82s

    {

    "handle": "charlidamelio",

    "displayName": "Charli D'Amelio",

    "followers": 48300000,

    "following": 1284

    }

    Step 3: Get clean JSON

    Use the response immediately or send it into your pipeline.

Works with your stack

Code, automate, or connect your AI.

Explore integrations

Pricing

Social data, priced simply.

Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.

Starter

$29.00

18,000credits

  • Top up from $1.61 / 1k if you run out
  • Up to 25 monitors
Most popular

Growth

$79.00

50,000credits

  • Top up from $1.58 / 1k if you run out
  • 5 team seats
  • Up to 100 monitors

Scale

$225.00

150,000credits

  • Top up from $1.50 / 1k if you run out
  • 25 team seats
  • Up to 250 monitors
  • Cancel anytime
  • 30-day money-back guarantee
  • Price locked while you stay

Need 1M+ credits, invoicing, or volume rates? Talk to us

Trust signals

DevHunt

Product Hunt

Uneed

Customers

Teams building on Social Fetch.

“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”

Daniel Reeve · Founder, Social Crow
  • “A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”

    Jade P. · Founder, inko
  • “Live profile data on every request. We never flag accounts from a stale cache.”

    Hannah Webb · Founder, Scam Finder
  • “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”

    Owen Pritchard · Founder, IP Flare

Goodreads API: common questions

Is there a Goodreads API for books and reviews?

Yes. Social Fetch has 11 Goodreads routes under /v1/goodreads: book, book reviews, book editions, review comments, book search, author, author books, quotes, series, list and lists by tag. Authenticate with your Social Fetch API key in x-api-key.

How do I identify a book, author, series or list?

Use the number in the Goodreads URL: 2767052 in goodreads.com/book/show/2767052-the-hunger-games, 153394 for an author, 73758 for a series, 1 for a Listopia list. The slug form (2767052-the-hunger-games) or the full URL is accepted too. Search by title or ISBN when you only have the name.

Can I get every review of a book, not just the first page?

Yes. GET /v1/goodreads/books/{bookId}/reviews pages through all reader reviews of the work, across every edition, up to 100 a page. Pass page.nextCursor back as cursor while page.hasMore is true. sort, rating, language and query filter the list; a cursor only continues the filters it was issued for.

How do I read the comments under a review?

Every review has an id. Pass it as reviewId to GET /v1/goodreads/reviews/comments to get its comments, newest or oldest first, 10 a page, with each commenter's name, profile link and avatar. The site serves 100 comments in each order; a longer thread is marked truncated. A review without comments is found with totalCount 0.

What does a book response include?

On found, book carries id, workId, url, title, fullTitle, originalTitle, description as text and HTML, cover, authors with role, series with position, genres, format, pages, publisher, publishedAt, firstPublishedAt, language, isbn, isbn13, asin, rating with average, count, reviewCount, distribution and reviewsByLanguage, awards, places, characters, quotesCount and questionsCount.

How does search work?

GET /v1/goodreads/search?query= returns the best matching books for a title, author or ISBN, best first, with id, workId, title, author, cover, pages, average rating and ratings count. It returns the top matches, typically 5 to 10, not a paged catalogue.

How much does the Goodreads API cost?

Every Goodreads route charges 1 credit per completed request. New accounts start with 100 free credits. Check meta.creditsCharged on each response for the amount actually billed.

Does HTTP 200 mean the book exists?

No. HTTP 200 means the request finished. Check data.lookupStatus: found means the item was returned, not_found means no item has that id. Persist meta.requestId when you need to debug a miss.

The Goodreads API in detailHow the Goodreads routes work, what they cost, and how they differ from the official API.

Why teams use Social Fetch for Goodreads

Social Fetch exposes 11 routes under /v1/goodreads. Books, authors, series and lists are named by the number in their Goodreads URL (2767052 for The Hunger Games, 153394 for Suzanne Collins); the URL slug or the full URL works too. Every response uses the { data, meta } envelope, and every lookup carries data.lookupStatus: found or not_found. HTTP 200 only means the request finished, so branch on lookupStatus before storing a row.

GET /v1/goodreads/books/{bookId} returns the book as one object: title, fullTitle, description, cover, credited authors with roles, series with positions, genres, the edition's format, pages, publisher, publishedAt, language, isbn, isbn13 and asin, the work's firstPublishedAt, originalTitle, awards, places and characters, and a rating summary with the five-star distribution and review counts per language.

GET /v1/goodreads/books/{bookId}/reviews pages through every reader review of the work, across all editions, with sort (default, newest, oldest), rating, language and query filters, up to 100 a page. Each review has an id you can pass to GET /v1/goodreads/reviews/comments for its comment thread. Editions page 20 at a time with a cursor; author books, quotes, series and lists page by number.

How to call the Goodreads API

  1. 1. Create an API key

    Sign up at Social Fetch and copy a key (sfk_…). New accounts get 100 free credits, enough to try each Goodreads route against real books and authors.

  2. 2. Pick the route and id

    Use GET /v1/goodreads/books/2767052 for a book, GET /v1/goodreads/books/2767052/reviews?sort=newest for its latest reviews, or GET /v1/goodreads/search?query=dune to find an id. Send x-api-key on every request.

  3. 3. Branch, page and bill

    Check data.lookupStatus before writing a row. Follow page.nextCursor or page.nextPage while page.hasMore is true. Bill from meta.creditsCharged and log meta.requestId for support.

What each Goodreads route returns

  • Books with authors and roles, series and positions, genres, edition details, ISBNs, awards, settings, characters and a five-star rating distribution.
  • Every reader review of a book across its editions, newest or oldest first, filtered by star rating, language or text, up to 100 a page.
  • The comments under any review, 10 a page, and every edition of a book with format, publisher, language and ISBNs.
  • Authors with biography, birth and death, influences, followers, ratings, top books and series, plus each author's full book list.
  • Series in reading order, quotes by tag or by author, Listopia lists with ranked books, scores and votes, and the lists for a tag.
  • Book search by title, author or ISBN, typed lookupStatus on every lookup, and all 11 routes at one credit per request.

How much does the Goodreads API cost?

Every Goodreads route charges 1 credit per completed request, a not-found answer included. Credits never expire on pay-as-you-go packs. meta.creditsCharged on every response is the billing source of truth.

Social Fetch vs the official Goodreads API

Goodreads no longer issues developer keys. Social Fetch returns its public books, reviews, authors and lists under one JSON envelope with shared book and author shapes, typed lookupStatus values and absolute links. Covers and photos are linked, never rehosted.

Pull your first Goodreads data.

Run a live Goodreads request in the playground. 100 free credits, no card, JSON back in seconds.

No credit cardSign up in 30 seconds withGoogleGitHub