Categories You May Like
Suggesting categories that the user might be interested is a highly effective engagement strategy to help your site visitors find exactly what they're looking for.
Introduction
Most online marketplaces have different categories of products that they want to promote to help people find what they're looking for right away. Category recommendations usually appear in a ribbon on the homepage, often with a call to action like "Shop Collections." You can use Miso to dynamically generate the list of categories that is most likely to interest the individual user, and in the order that they are likely to click.
With Miso, you can generate Categories You May Like recommendations using the User to Categories API. You'll get back a list of the recommended categories for any given user, as well as the top-recommended items within each group for that user. Additional input parameters can be used to tune these recommendations, for example to increase the diversity or boost certain results to the top.
Before You Start
API Call / JSON Response
To fetch your Categories You May Like recommendations, POST to the User to Categories API with the following minimum parameters:
user_idoranonymous_id: The user or anonymous visitor to personalize the recommendations forfield: The attribute you want to make recommendations for
The API will return a list of nested list of products, grouped by the top personalized results for the attribute that you specified.
fq
,
boost_fq
, and
diversification
.
Read more in the deep dive
Example API Call
POST /v1/recommendation/user_to_categories?api_key=<API_KEY> HTTP/1.1
{
"user_id": "user-123",
"rows": 2,
"products_per_category": 3,
"fl": ["title"]
}
Example JSON Response
{
"message": "success",
"data": {
"took": 85,
"miso_id": "7cd6059c-dd54-11eb-8050-a62d401473b5",
"categories": [
{
"category": [
"Air Jordan 1"
],
"total": 351,
"recommended_products": [
{
"product_id": "air-jordan-1-low-og",
"title": "Air Jordan 1 Low OG \\\"Chinese New Year\\\""
},
{
"product_id": "air-jordan-paris-saint",
"title": "Paris Saint Germain x Air Jordan 1"
},
...
]
},
{
"category": [
"Cozy Essential"
],
"total": 221,
"recommended_products": [
{
"product_id": "brain-dead-sweatshirt",
"title": "Brain Dead Logo Head Hooded Sweatshirt"
},
{
"product_id": "rick-owens-pants",
"title": "Rick Owens Wool Track Pants"
},
...
]
}
]
}
}
Before You Launch
API Reference
Need more info on the API? Check out our dedicated API page with all the info you could ever want.
Read API Reference
