Importing Product Catalog Data


This is the data about each product in your catalog, uniquely identified by a product_id. All search queries and product recommendations will be performed against this data set. When imported, Miso will automatically analyze the entire product catalog using pre-trained neural networks to understand each product at a deep semantic level.

Miso supports a comprehensive set of product attributes out of the box, but additional attributes can be added using custom_attributes. In general, the more complete the product information is, the better the personalized search and recommendations become.

Sample Record

Below is a sample product record for a Miso Soup t-shirt, with a custom attribute for the artist:

    "product_id": "123ABC-S-Black",
    "product_group_id": "123ABC",
    "parent_id": "Miso_Shop_123",
    "related_ids": [],
    "type": "clothes",
    "title": "Miso Soup T-Shirt",
    "description": "",
    "language": "en",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "categories": [],
    "tags": [],
    "url": "",
    "cover_image": "",
    "original_price": 20,
    "sale_price": 15,
    "size": "S",
    "color": "Black",
    "material": "Cotton",
    "condition": "NEW",
    "brand": "Miso Corp.",
    "authors": [],
    "publishers": [],
    "collections": [],
    "availability": "IN_STOCK",
    "location": {},
    "rating": 5,
    "html": "string",
    "subtitle": "string",
    "headers": [],
    "paragraphs": [],
    "anchors": [],
    "enable_question_answering": false,
    "custom_attributes": {
        "artist": "luckorchance"

Figure 1 - The list of supported product attributes

Importing Product Catalog Data using APIs

Product catalog data can be imported using the Products API. The basic call pattern looks like below, with each product in the array following the schema shown in Figure 1:

POST /v1/products
    "data": [

Figure 2 - A basic call pattern for the Products API

Here’s what a sample request might look like using JavaScript:

const apiKey = "<your private api key>"
const url = `${apiKey}`
const payload = [
        "product_id": "movie_456",
        "title": "Fight Club",
        "categories": [
        "description": "An insomniac and a soap salesman ...",
        "language": "en",
        "url": "",
        "cover_image": "",
        "custom_attributes": {
            "year": 1999,
            "popularity": 40.424,
            "director": [
                "David Fincher"

fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json"
    body: payload
.then(response => response.json())

Figure 3 - A JavaScript example of an API request to Miso

Importing Product Catalog Data Using an Integration

Miso integrates with many popular e-commerce platforms, such as Shopify, to import product catalog data. Please see the full list of integrations and instructions here.

Importing Product Catalog Data Using Dojo

Dojo provides an intuitive, no-code UI for managing your Miso data sets and engines.

The recommended method for importing product catalog data is either via the Products API or an integration. However, if you are more comfortable using a point-and-click UI, you can upload a JSON file containing a list of products directly through Dojo.

  1. From the left navigation pane of the Dojo Dashboard, under the Data sets category, select Catalog.

    Figure 4 - Dojo navigation pane

  2. Select Import data file and either drag and drop the JSON file, or click in the designated area to upload a file from a file browser.

    Figure 5 - Importing a data file in Dojo

  3. Select Next step.

  4. A progress bar will appear as the catalog data is loaded into Miso. When it’s at 100%, select Next step.

  5. If the data load is successful, you will be taken to a dashboard where you can view the uploaded data.

    Figure 6 - Product catalog data dashboard in Dojo

Next: Importing Interaction Data

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