Find books by mood
find_books_by_moodRead-onlyIdempotent
Find books in the Shelfclub catalog by mood, vibe, pace and genre tags. At least one tag is needed. Books that carry every requested tag are listed first, most read first; when there are fewer of those than asked for, books that carry some of the tags follow, and matchAll says how many of the books returned carry every tag. Each book is returned with its own tags. Returns up to 10 books, each with its Shelfclub id, authors, description, reader rating, series and shelfclub.app link. The tags are machine-generated.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pace | No | How quickly the story moves. | |
| limit | No | How many books to return. | |
| moods | No | How the book feels to read. | |
| vibes | No | The kind of reading experience. | |
| genres | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| books | No | ||
| status | Yes | "try_again_later": the service was busy and looked nothing up, so the other fields are absent. | |
| hasMore | No | Whether more books carry these tags than were returned. | |
| matchAll | No | How many of `books`, counted from the first, carry every tag asked for. The books after them carry some of the tags. | |
| tagProvenance | No | Where the moods, vibes, pace and genres come from. | |
| retryAfterSeconds | No | With "try_again_later", when known: how long to wait. |