com.siftivo/siftivo

Keyword search over the Siftivo book catalog. Matches titles, authors, and descriptions. Returns works with the ids other Siftivo tools accept.

Full detail for one book: synopsis, authors, series position, genres, and its page on siftivo.com. Accepts a work id, an edition id, or a slug.

Given one book, what to read after it: the next books in its series, more by the same author, and books that read like it. This is the same set the book page on siftivo.com shows.

An author, their biography, and the works Siftivo holds for them. Accepts an author id or slug.

A series and its works in reading order. Accepts a series id or slug.

The weekly Siftivo Reading Index: the fiction and nonfiction books moving most in cultural circulation this week, ranked.

Describe what someone is in the mood for, in their own words, and get books that match. Use this for a theme, subject or feeling ("books about grief", "cozy mysteries set in Cornwall"). Use search_books instead when you already know the title or author.

Give Siftivo a few books someone liked, by title, and get books like them. Titles are resolved against the catalog first; anything that does not resolve is reported back rather than guessed at.

The signed-in reader's own Siftivo library: what they want to read, are reading, finished, or set down, with their ratings.

Put a book on one of the signed-in reader's shelves, move it to a different shelf, rate it, or record how far through it they are. Pass a workId from search_books, get_book, or recommend_from_titles. "Finished it, four stars" is one call with readingStatus FINISHED and rating 4.

Whether the signed-in reader has this book on a shelf, and if so which shelf, their rating and how far through they are. Answers "have I read this?" without pulling the whole library.

Take a book off the signed-in reader's shelves entirely, discarding their rating and progress for it. To move it to a different shelf instead, call add_to_library with a new readingStatus.