---
title: "Recommend books from a description"
method: GET
path: "/api/agent/recommend_from_description"
tags: ["catalog"]
---

# Recommend books from a description

`GET /api/agent/recommend_from_description`

## Request

- Base URL: `https://api.siftivo.com`
- URL: `https://api.siftivo.com/api/agent/recommend_from_description`
- Auth: none required

Book recommendations from a mood, theme or subject in the reader's own words: "cozy fantasy with found family", "a good book about grief", "something light for the beach". Matches on meaning rather than on a title or an author name. For a reader who has linked their Siftivo account, the results leave out books already in their library and books they hid, avoided or recently passed on, and a result that fits their taste says why.

## Query parameters

- `description` string, required: What the reader is after, in plain language
- `limit` integer
- `isFiction` boolean

## Response `200`

Success

- object

## Other responses

- `404`: No such entity

---

[API](https://skmtc.dev/siftivo/apis/siftivo-agent-api.md) · [All operations](https://skmtc.dev/siftivo/apis/siftivo-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/siftivo/apis/siftivo-agent-api/revisions/2b85acb5f7c8?raw)