Category Pages

Category Pages drill down into products of a certain type, like a collection or brand. Using Miso’s Search Engine, you can create personalized Category Pages where the products are sorted by relevance to the user.

Example for Category Pages


A prominent feature in almost all e-commerce sites, category pages allow your customers to quickly drill into a specific category - such as a collection or brand - of your product catalog. Since personalization is at the core of Miso’s Search Engine, the products within the category page are rank-sorted in real-time, based on our insights about the customer’s preferences.

For example, suppose you are running an online jewelry store and want to showcase a collection of vintage watches. With Miso’s Recommendation Engine, we will uniquely order the watches to reflect one customer’s preference for vintage chronographs and order it differently based on another customer’s preference for vintage divers.

This is one of Miso’s best performing recipes, resulting in up to a 20% GMV lift in the first 90 days.

Do it with APIs

To return the list of rank-sorted products within a category, we first need to query all the products in the product catalog and then narrow the results down to a specific category. We also need to include the user_id or anonymous_id so that we can tailor the results to a specific user. From the above example, suppose a user selects the “diving” category. The API request would look like the following:

POST /v1/search/search
    "q" : "*", //query all products
    "category": ["Diving Watches"],
        "user_id": "user-123"

Note: The category parameter also supports sub-categories. Using the above example, if we wanted an even narrower category, we could include something like category: [”Dive Watches”, “1950s-1970s”].

The API response might look like the following:

                "product_id":"Rolex Submariner ref 5513",
                "categories": [["Dive Watches"]],
                 ..., // Additional scoring information
                "product_id":"Omega Seamaster Planet Ocean",
                "categories": [["Dive Watches"]],
                ..., // Additional scoring information

(Note: the response has been condensed for illustrative purposes)

Additional Resources

For more information on Miso’s Search API, check out the official API Documentation.

For more recipes like this, visit the Recipes page on our Docs site.

Published Date: April 15th, 2022

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
Icon/Activity Icon/Add Icon/API Icon/Arrow/Down Icon/Arrow/Left Icon/Arrow/Right Icon/Arrow/TopRight Icon/Arrow/Up Icon/Bento Icon/Billing Icon/Bin Icon/Book Icon/Bookmark/Default Icon/Bookmark/Filled Icon/Calendar Icon/Caret/Down Icon/Caret/Up Icon/Chavron/DownIcon/Chavron/LeftIcon/Chavron/RightIcon/Chavron/UpIcon/Checknox/CheckedIcon/Checknox/Unchecked Icon/Checklist Icon/Chip Icon/Clipboard / Copied Icon/Clipboard/Default Icon/Clock/Stopwatch Icon/CMD Icon/Data/Catalog Icon/Data/Engine Icon/Data/Group Icon/Data/Interact Icon/Data/Users Icon/Dive Icon/Docs/Key Icon/Dojo Icon/Email Icon/Env/Development Icon/Env/Playground Icon/Env/Prod Icon/Folder Icon/Fullscreen/Collapse Icon/Fullscreen/Expand Icon/Guides/Multiple Icon/Guides/Single Icon/Hashtag Icon/Heart/Outline Icon/Heart/Solid Icon / Cart z Icon / Click Icon / Clock Icon / Data Icon / Doc Icon / EmptyCart z Icon/Social/Facebook Icon / Genome Incognito Icon / Money Icon/Social/ProductHunt Icon / Search Icon/Social/Twitter Icon / User Icon/Info/Error Icon/Info/Info Icon/Info/Question Icon/Info/Warning Icon/Interact/Download Icon/Interact/Edit Icon/Interact/External v2 Icon/Interact/External Icon/Interact/Filter Icon/Interact/Logout Icon/Interact/Options Icon/Interact/Re-order Icon/Interact/Reload Icon/Interact/Remove Icon/Interact/Replace Icon/Interact/Search Icon/Interact/Shuffle Icon/Interact/Undo Icon/Interact/Upload Icon/Interact/Video Icon/Invoice Icon/Loading Icon/Loading Icon/Lock/Locked Icon/Lock/Unlocked Icon/Lock Icon/Mapping Menu Icon/Notification Icon/Overview Icon/Person/Team Icon/Person/User Icon/Plan/Enterprise Icon/Plan/Growth Icon/Plan/Startup Icon/Plan/Trial Icon/Recipe Icon/Rocket Icon/Settings/App Icon/Settings/User Icon/Settings Icon/Shrine Icon/Sidebar/Close Icon/Sidebar/Open Icon/Slideout Icon/Sort/Ascending Icon/Sort/Default Icon/Sort/Descending Icon/Star/Filled Icon/Star/Outlined Stopwatch Icon/Support Icon/Tag Icon/Interact/Thumb/Dislike Icon/Interact/Thumb/Like Icon/Tick Icon/Trend/New Icon/Trend/Trending Icon/Tutorial Icon/Lock/Unlocked Icon/View/Grid Icon/View/List Icon/Watchlist/Add