Find similar items
find_similarFind alternatives to one item (by id from an earlier result): pieces close in style, the same product type first. Use it for 'something like this but cheaper' (filters.max_price), 'but in stock' (filters.availability) or a different color. The source item is never included. Returns {anchor, count, results} in the search result shape, each with a 'why' naming the shared style. An unknown id returns an error result; an empty list means no alternative passes the filters. Read-only. Without a key, results are capped at 5 and omit trend data and match reasons; a free key (POST https://vitrine.fashion/v1/keys, sent as 'Authorization: Bearer ') unlocks them. Rate limits: 10 calls a minute anonymous, 60 with a key.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "find_similar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The item to find alternatives for. | |
| agent | No | ||
| limit | No | 1 to 20. Anonymous callers get at most 5. | |
| filters | No | Hard filters. Applied before ranking; an item that fails any of them is never returned. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| count | Yes | ||
| anchor | No | ||
| results | Yes | ||
| query_id | No |