Search books
search_booksRead-onlyIdempotent
Search the Shelfclub book catalog by title or author name. Returns up to 10 books, each with its Shelfclub id, authors, description, reader rating, series, shelfclub.app link, and machine-generated mood, vibe, pace and genre tags.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many books to return. | |
| query | Yes | A book title, an author name, or both. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| books | No | ||
| total | No | How many books in the catalog match, of which `books` is the first few. | |
| status | Yes | "try_again_later": the service was busy and looked nothing up, so the other fields are absent. | |
| exactMatch | No | False when nothing matched the query as written and `books` holds the closest titles instead. | |
| tagProvenance | No | Where the moods, vibes, pace and genres come from. | |
| retryAfterSeconds | No | With "try_again_later", when known: how long to wait. |