The StoryGraph API

Does The StoryGraph have a public API?

No. The StoryGraph publishes no public API. A request titled "An API" sits on the platform's public roadmap, and the team's reply is that there is no ETA and it is not a priority for a one-developer team. Readers can export their library as a CSV from Manage Account, and that is the only official route out. Integuru's StoryGraph integration provides verified actions over direct HTTP requests, authenticated with your own StoryGraph login, so a reading app gets live shelves and stats rather than a snapshot.

| | The StoryGraph today | Integuru for The StoryGraph | |---|---|---| | Access | CSV export from Manage Account | Your own StoryGraph login | | Covers | A one-off snapshot of your library | Live shelves, stats, reviews and book data on demand | | Best for | Moving a library once | Keeping a reading app in sync |

What you can do with the StoryGraph API

Find and inspect a book. search_storygraph_books takes a title, author or keyword as query and returns book uuids. With a book_id, get_storygraph_book returns the record, get_storygraph_book_stats returns the community mood and pace stats the site is known for, list_storygraph_book_editions pages the editions, list_storygraph_content_warnings returns the reader-submitted warnings, and list_storygraph_book_reviews pages reviews with written_only to skip rating-only entries and sort (omit for newest first). list_storygraph_similar_books returns similar titles, personalised to your account unless personalized is false. get_storygraph_author takes an author uuid and get_storygraph_series a numeric series id such as 188. list_storygraph_giveaways returns the current giveaways.

Your reading. get_storygraph_profile, get_storygraph_reading_stats, list_storygraph_reader_books, list_storygraph_shelf and list_storygraph_user_reviews all default to the signed-in account and accept a username for a profile your account can view. get_storygraph_reading_stats takes a four-digit year or all-time, the default. list_storygraph_reader_books takes a list and list_storygraph_shelf a shelf, both paged with page.

Marking a book read, updating progress and writing a review are built on request through the Managed Service.

Who uses this

Reading apps that support both trackers connect this page and Goodreads through one auth model, so a reader who keeps a StoryGraph account and an older Goodreads shelf sees one library. Assistants built on the AI agents pattern read get_storygraph_reading_stats and list_storygraph_shelf to learn a reader's pace and moods, then call list_storygraph_similar_books and list_storygraph_content_warnings before recommending, so the answer respects the warnings the reader cares about. Book clubs pull list_storygraph_book_reviews with written_only for the discussion thread.

Setup notes

Integuru authenticates against app.thestorygraph.com with the reader's own credentials and returns that account's shelves, stats and reviews, plus book and author pages any signed-in reader can view. Book and author ids are uuids returned by search_storygraph_books and get_storygraph_book; series ids are numeric. Omit username to read your own account.

Get started

Install the CLI and connect your StoryGraph login:

npm install -g integuru

Or sign in at app.integuru.com and add The StoryGraph. To add shelving or progress writes, the Managed Service scopes and builds those actions against your account. The integrations catalogue lists every live platform.