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.
- 11 routes
- Books + reviews
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
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.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
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.
What Goodreads data can you get?
11 endpoints, one API key. Every response comes back as live JSON in the same envelope.
- +2 more books endpoints
Books
Authors
Lists
Browse all 11 Goodreads endpoints
Books
Authors
Lists
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.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with Goodreads data
Monitoring, enrichment, research and content workflows on Goodreads data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
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.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- 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.”
“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. 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. Pick the route and id
Use
GET /v1/goodreads/books/2767052for a book,GET /v1/goodreads/books/2767052/reviews?sort=newestfor its latest reviews, orGET /v1/goodreads/search?query=duneto find an id. Sendx-api-keyon every request.3. Branch, page and bill
Check
data.lookupStatusbefore writing a row. Followpage.nextCursororpage.nextPagewhilepage.hasMoreis true. Bill frommeta.creditsChargedand logmeta.requestIdfor 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
lookupStatuson 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
