StoryGraph Book Scraper — Ratings, Moods, Pace & Monitor

📚 StoryGraph Book Scraper — Ratings, Moods & Pace + New-Release Monitor

Scrape StoryGraph books by search term or URL — title, author, page count, description, cover — plus the data StoryGraph is famous for and Goodreads doesn't have: the community average rating, review count, MOODS (% dark / tense / emotional / adventurous…) and PACE (% fast / medium / slow). Then run it on a schedule to monitor new releases and get a Slack / email / webhook ping the moment a matching book appears.

No login, no browser automation — every field comes straight from StoryGraph's server-rendered pages.

---

What does StoryGraph Book Scraper do?

It turns StoryGraph book pages into clean, structured rows you can export to JSON, CSV, Excel, or push to your app via API. For each book it pulls the catalog details and the community-reviews panel — the mood and pace breakdowns that make StoryGraph the reader's-choice alternative to Goodreads.

• 🔎 Search by keyword — title, author, or series ("project hail mary", "fourth wing", "brandon sanderson"). Server-side.
• 🔗 Or pass exact book URLs / IDs — scrape a specific reading list.
• ⭐ Community rating + review count — the real average and how many readers it's based on.
• 🎭 Moods — the % of readers who tagged it dark, tense, emotional, adventurous, funny, hopeful, reflective, mysterious…
• ⚡ Pace — the % who found it fast, medium, or slow.
• 📖 Catalog — pages, format, first-published year, edition count, full description, cover.
• 🔔 New-release monitor — schedule it and get Slack / email / webhook alerts when a new book matches your search (e.g. a favourite author's next title).

---

What data does it extract?

For every book:

• 🆔 book_id, 🔗 book_url, 🏷️ title
• ✍️ author, author_url, series
• 📝 description (the full blurb), 🖼️ cover
• 📄 pages, format, 📅 first_published, editions
• 🏷️ isbn, language, publisher, edition_pub_date, tags (genre, mood and pace tags)
• ⭐ average_rating, 🗳️ reviews_count
• 🎭 moods (object: { "dark": 77, "tense": 62, … } — values are %)
• ⚡ pace (object: { "fast": 30, "medium": 62, "slow": 6 })
• 🧭 reader_questions (object: plot- or character-driven, strong character development, loveable characters, diverse cast, flawed characters a main focus — each answer in %)
• ✨ is_new (monitor mode), 🕒 scraped_at

---

Who is it for?

• 📊 Book-data & recommendation builders who want mood/pace signals, not just a star average.
• 📱 BookTok / Bookstagram creators & newsletters tracking what's trending and how it feels to read.
• 🏪 Authors & publishers monitoring a title's community rating, review velocity, and mood profile.
• 🤖 App / ML developers enriching a catalog with reader-sentiment features.

---

Two ways to use it

1. Bulk scrape — search a term (or paste a list of book URLs) and pull every match into one clean dataset with ratings, moods, and pace.
2. New-release monitor (the recurring play) — set monitorMode: true, attach an Apify Schedule, and the actor outputs/alerts only newly-appearing books for your search. Perfect for watching an author or a genre/mood browse.

---

How to use it (step by step)

1. Click Try for free.
2. Enter a search term (e.g. project hail mary) — or paste Book URLs.
3. (Optional) keep Fetch community ratings, moods & pace on (the differentiator).
4. (Optional) set a Min average rating or Max books.
5. Click Start, then open the Dataset tab to view/export.
6. (Optional) set monitorMode + a Schedule + an alert channel to get pinged on new releases.

Quick start

{ "searchTerm": "fourth wing", "maxBooks": 25 }

New-release monitor example

{
  "searchTerm": "rebecca yarros",
  "monitorMode": true,
  "alertOnNewBook": true,
  "slackWebhookUrl": "https://hooks.slack.com/services/…"
}

---

Input

Field	What it does
searchTerm	server-side browse search over title / author / series
bookUrls	explicit /books/{uuid} URLs or bare UUIDs to scrape
fetchReviews	also pull average rating, review count, moods, and pace (one extra request/book)
minRating	client-side filter: keep books rated at/above this
maxBooks	how many books to read per run: the first N listed (0 = unlimited); with minRating fewer may pass
sortBy	default · rating_desc · rating_asc · reviews_desc · title
monitorMode, alertOnNewBook	recurring new-release watcher + alerts
webhookUrl, slackWebhookUrl, emailRecipients	alert channels
proxyConfiguration, requestConcurrency	proxy + parallelism

---

Output

Each book is one dataset record (fields above). Export to JSON, CSV, Excel, HTML, or RSS, or fetch via the Apify API. moods and pace are objects whose values are percentages of community readers. Books nobody has reviewed yet come without rating, moods and pace.

Every run ends with a status message: how many books were delivered, and if none, why (nothing matches the search, no new books since the last monitor run, no book above minRating, an invalid book URL) and what to change.

---

How much does it cost?

Pay-per-event — you pay for what you pull, no subscription. The events:

Event	What it covers
lot-scraped	each book returned
lot-detail-enriched	each community-reviews fetch (ratings/moods/pace)
monitor-run-completed	each scheduled watch run
new-lot-detected	each newly-appearing book
alert-delivered	each Slack/email/webhook push

The price of each event is shown on the actor's Pricing tab.

---

FAQ

What is StoryGraph? TheStoryGraph is a popular Goodreads alternative that lets readers track books and adds community mood and pace breakdowns alongside the star rating.

Do I need an account or login? No. The actor reads public book pages directly.

What makes this different from a Goodreads scraper? The moods and pace fields — StoryGraph's signature reader-sentiment data — plus the community average rating and review count, all in one row.

Can I monitor an author's new releases? Yes. Search the author's name, set monitorMode, attach an Apify Schedule, and add a Slack/webhook/email channel — each run alerts only books new since the last run.

How do I export the data? JSON, CSV, Excel, HTML, or RSS from the Dataset tab, or via the Apify API.

---

Feedback

Found a missing field or want a new filter (content warnings, genre tags, series order)? Open an issue on the actor — fast fixes and feature requests welcome.