Get similar books
get_similar_booksRead-onlyIdempotent
List the books in the Shelfclub catalog whose mood, vibe, pace and genre tags overlap most with those of a given book. The tags are machine-generated, and a book that has none has no similar books. Returns up to 10 books, each with its Shelfclub id, authors, description, reader rating, series, tags and shelfclub.app link.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The Shelfclub id of the book, as the other tools return it. | |
| limit | No | How many books to return. |
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. | |
| tagProvenance | No | Where the moods, vibes, pace and genres come from. | |
| retryAfterSeconds | No | With "try_again_later", when known: how long to wait. |