com.siftivo/siftivo

Shelve, rate or update one book for the linked reader: want to read (NOT_STARTED), READING, FINISHED or DNF, with the day it happened, a rating in half stars, or a private note. Suits "add X to my list", "I finished X on Sunday" and "just finished X, four and a half stars" (one call: FINISHED, 4.5). Where they are in a book (a page, or time left on audio) is write_journal. Each field sent replaces the reader's own value, so send only what they asked to change; without readingStatus the book stays on its shelf, and a rating alone on a book not on a shelf saves the rating without shelving it. Notes are private: a public review is write_review. For favorites or a list of books read, save_my_taste. Needs a linked Siftivo account.

Delete one day's entry for one book from the linked reader's journal, note and position together. The book stays on its shelf where it was. Suits "delete what I wrote about X yesterday". To change a day's note, write_journal with replaceNote. Needs a linked Siftivo account.

Take down the linked reader's review of a book, for good. Their star rating and their shelf stay as they are. Suits "delete my review of X". Needs a linked Siftivo account.

An author's biography and their books, with years. Suits "what else has X written" and "tell me about X". Takes a name, an author id or a siftivo.com slug.

One book: synopsis, authors, year, series position, genres and its siftivo.com page. Suits "what is X about" and "is X part of a series". For a linked reader it also answers "would I like X", since a book that fits their taste says why. Takes a workId or a full siftivo.com slug.

A book club by its link. Suits "what's this club link?", "what are we reading?", "when do we meet?" and "what's on the ballot?". Anyone gets the club's public preview, and a linked member also gets the current read, next meeting, open poll and the host's pinned message. It never returns chat messages or other members' names.

Which of up to 25 books the linked reader already has, with shelf, rating, progress and their review for each. Takes titles ("Title by Author" resolves best) or workIds. Suits "have I read X", "what did I write about X", "which of these have I read" and checking suggestions before recommending them. Titles not in the catalog come back under unmatched. Needs a linked Siftivo account.

Every book club the linked reader is in, with what each is reading, when it next meets, and whether a vote, an RSVP or unread messages wait on them. Suits "what's going on with my book club?" and "do I have anything to do for book club?".

The linked reader's reading journal: the books they are reading now, with how each is tracked (pages, or time left for audio), where they got to, their totals, and whether today has an entry. With book, that book's recent days and notes instead. Suits "what am I reading", "where was I in X" and "what did I write about X this week". Needs a linked Siftivo account.

The linked reader's shelves: want to read, reading, finished and did not finish, with ratings, percent read and private notes. Suits "what am I reading", "what's on my to-read list" and "what have I finished". status filters to one shelf. Needs a linked Siftivo account.

The linked reader's taste: the books, authors, series, genres and moods they love, what they avoid or quit, and why each counts, in their own words where they gave them. The basis for "what should I read next", "recommend me a book" and "what kind of books do I like" when no book or mood is named. Returns the strongest 40 entries; limit raises that. Needs a linked Siftivo account.

This week's Siftivo Reading Index: the fiction and nonfiction books moving most in cultural circulation, ranked, with weeks on the chart and new entries. Suits "what's popular right now", "what is everyone reading" and "the big books this week".

A series in reading order: each book's position and year, and whether the series is complete. Suits "what order do the X books go in", "what is book 3 of X" and "is the next X book out". Takes the series name or a series id.

For a club's host or moderator: set or finish the book, open or close a poll, set or cancel the next meeting, or post a pinned message from the host. Suits "set up a vote between these three", "we meet the 14th at Noor's", "we finished it" and "ask the club this question". Say what you're about to post before posting. Every member is notified, and the result says how many. place is a place's name, never a street address. Removing members and closing a club are done in the app.

Book recommendations from a mood, theme or subject in the reader's words: "cozy fantasy with found family", "a good book about grief", "something light for the beach". Matches meaning, not titles. For a linked reader, books they already have, hid or avoided are left out, and a result that fits their taste says why.

Book recommendations from books the reader loved, named by title: "books like Project Hail Mary", "I loved Circe and Piranesi, what else would I like", a book club's favorite pick. Books they disliked go in avoid ("I loved these three but not that one"). Unresolved titles come back under unmatched, never guessed. The named authors' other books are left out. For a linked reader, books they already have, hid or avoided are left out, and a result that fits their taste says why.

Take a book off the linked reader's shelves, discarding its shelf, progress and notes; their rating stays. Suits "remove X from my list". To move a book between shelves, use add_to_library with a new readingStatus. Needs a linked Siftivo account.

The linked reader's own answer in a book club: join it from a link, leave it, vote in its open poll, or RSVP to its next meeting. Suits "join this club", "vote for Piranesi" and "say I'm coming". The optionId comes from get_club. Members see that the reader joined. Votes show only as totals.

Save books the linked reader names into their taste, up to 25 at once: favorites ("I loved Project Hail Mary for its humor"), books they disliked, or a list of books they have read. Loved books become favorites with the reader's reason, disliked ones books to avoid, and loved or read books not yet shelved go on Finished. Never changes a shelf, rating or note they already have; add_to_library does that. Titles not in the catalog come back under unmatched. Needs a linked Siftivo account.

Find a book by title, author or words from its plot, and get the workId the other Siftivo tools take. Suits "what is Babel about", "is Demon Copperhead worth reading", "add Circe to my list" and a half-remembered plot ("the novel about a man alone in an endless house of statues").

Start a book club with the linked reader as host and get back the one link that lets anyone with it join. Suits "start a book club for my Wednesday group". A first book is optional. Nobody is told until the reader shares the link.

Books that fit a club's members as a group, each with how many of them it fits and how many have read it, as totals. Suits "what should my club read next?". Pass the workIds to manage_club's open_poll. Empty, with a reason, when too few members have taste on file.

What to read after one book: the next in its series, more by its author, and books that read like it. Suits "what should I read after X", "is there a sequel to X" and "more like X". For a linked reader, books they already have, hid or avoided are left out, and a book that fits their taste says why. Takes a workId.

Log a day of reading in the linked reader's journal, one entry per book per day, for up to 10 books. Each takes the reader's local date and a note, a position, or both. Position is page for print or ebook, or minutesLeft for audio; a listener's "4 hours in" is totalMinutes minus 240, so it needs the runtime. A Kindle percent goes in the note. A book keeps one unit: a day in the other one comes back unit_differs and logs nothing until switchUnit is true. A note on a day that has one is added under it unless replaceNote is true. A book not on a shelf moves to Reading. Finishing is add_to_library. Notes are private and hold only the reader's words. Needs a linked Siftivo account.

Publish the linked reader's review of a book, under their name on its siftivo.com page and to their followers. Suits "post this as my review of X" and "change my review of X". The text is the reader's own words, or a draft they approved word for word, and is never padded to reach the minimum. It takes 50 to 10,000 characters and a star rating, sent here or already on file. If they already reviewed the book in different words, the result shows that review and changes nothing unless replaceExisting is true. A star rating alone is add_to_library. Needs a linked Siftivo account.