recommendations
Fetches related and personalized product suggestions for storefront placements, scoped by product, category, region, and optional user history.
Instructions
Get personalized/related product recommendations for given placements.
Args:
placements: Required list of placement codes identifying where the
recommendations will be shown (e.g. "product_page", "cart").
product_id: Product IDs to base "related to this" recommendations on.
category_id: Category ID to scope recommendations to.
region_id: Region/location ID affecting availability and pricing.
page: Page number, 1-based.
per_page: Results per page.
user_history: Opaque user-history token used to personalize results.
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": {
"placements": "<placements>"
},
"name": "recommendations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| per_page | No | ||
| region_id | No | ||
| placements | Yes | ||
| product_id | No | ||
| category_id | No | ||
| user_history | No |