Calling the Personalized Searc...
Personalized Category Page Queries

Just as Personalized Site Search allows you to return customized, personalized search results from your entire product catalog, Personalized Category Pages allows you to present customers with customized, personalized product category pages based on the product categories defined in your product catalog.
A Personalized Category Page request to the Pesonalized Search API is similar to a Personalized Site Search request. Change the value of the typeOfRequest parameter to "CATNAV", and then add a categoryPath parameter to the query object.
The response is also similar to a Personalized Site Search response, but it also includes the monetate_category parameter that indicates the product category.
All functions available in Personalized Site Search queries—such as pagination﻿ and facets﻿ —are available to use in Personalized Category Page queries.
Refer to Omnichannel Personalized Search Action Request﻿ for the information you must provide in an Engine API request for a Personalized Category Pages experience configured with a Personalized Search action.
POST
Request
Response
Body Parameters
recordQueries
required
Object
The set of parameters that define a Personalized Category Pages request.
Example Personalized Category Page Request
{
  "searchToken": "Monetate-67899982122813608004"
  "recordQueries": [    
    {
      "id": "categoryProducts",
      "typeOfRequest": "CATNAV",
      "settings": {
        "query": {
          "categoryPath": "Sporting Goods;Outdoor Recreation;Camping & Hiking"
        },
        "searchPrefs": [
          "enableScores"
        ],
        "limit": 5
      }
    }
  ]
}
{
  "searchToken": "Monetate-67899982122813608004"
  "recordQueries": [    
    {
      "id": "categoryProducts",
      "typeOfRequest": "CATNAV",
      "settings": {
        "query": {
          "categoryPath": "Sporting Goods;Outdoor Recreation;Camping & Hiking"
        },
        "searchPrefs": [
          "enableScores"
        ],
        "limit": 5
      }
    }
  ]
}
Responses
200
{
  "queryResults": [    
    {
      "id": "categoryProducts",
      "meta": {
        "qTime": 9,
        "noOfResults": 5,
        "totalResultsFound": 68,
        "typeOfSearch": "AND",
        "offset": 0,
        "debuggingInformation": {},
        "notificationCode": 1,
        "searchedTerm": "*",
        "isPersonalised": false
      },
      "records": [        
        {
          "color": "orange",
          "discount": "",
          "hideGroupPrices": "",
          "itemGroupId": "8054252208375",
          "capacity": "2",
          "score": "0.057294395",
          "freeShipping": "",
          "storeBaseCurrency": "USD",
          "price": "1300",
          "toPrice": "",
          "imageUrl": "",
          "currency": "USD",
          "inStock": "yes",
          "id": "tent_006",
          "imageHover": "",
          "sku": "",
          "brand": "Summitate",
          "basePrice": "1300.0",
          "startPrice": "",
          "image": "",
          "deliveryInfo": "",
          "quantity": "23",
          "hideAddToCart": "",
          "salePrice": "1300.0",
          "swatchesInfo": "",
          "weight": "",
          "totalVariants": 0,
          "handle": "tent_006",
          "groupPrices": "",
          "isCustomOptionsAvailable": "",
          "url": "",
          "name": "Stormking tent",
          "shortDesc": "Tents",
          "category": "Tents",
          "monetate_product_boosting": "1.011",
          "monetate_category": "MONETATE_PRODUCT;;Sporting Goods;Outdoor Recreation;Camping & Hiking;Tents  @ku@kuCategory@ku@",
          "monetate_manual_boosting": "0.9",
          "searchClickToken": "Monetate-NiIsICI2LjE2NjIxMTE3NDAuMTcyNzE3MjExOTIyNCJd"
        },
        {
          ... Additional records ...
        }
      ],
      "filters": []
    }
  ]
}
{
  "queryResults": [    
    {
      "id": "categoryProducts",
      "meta": {
        "qTime": 9,
        "noOfResults": 5,
        "totalResultsFound": 68,
        "typeOfSearch": "AND",
        "offset": 0,
        "debuggingInformation": {},
        "notificationCode": 1,
        "searchedTerm": "*",
        "isPersonalised": false
      },
      "records": [        
        {
          "color": "orange",
          "discount": "",
          "hideGroupPrices": "",
          "itemGroupId": "8054252208375",
          "capacity": "2",
          "score": "0.057294395",
          "freeShipping": "",
          "storeBaseCurrency": "USD",
          "price": "1300",
          "toPrice": "",
          "imageUrl": "",
          "currency": "USD",
          "inStock": "yes",
          "id": "tent_006",
          "imageHover": "",
          "sku": "",
          "brand": "Summitate",
          "basePrice": "1300.0",
          "startPrice": "",
          "image": "",
          "deliveryInfo": "",
          "quantity": "23",
          "hideAddToCart": "",
          "salePrice": "1300.0",
          "swatchesInfo": "",
          "weight": "",
          "totalVariants": 0,
          "handle": "tent_006",
          "groupPrices": "",
          "isCustomOptionsAvailable": "",
          "url": "",
          "name": "Stormking tent",
          "shortDesc": "Tents",
          "category": "Tents",
          "monetate_product_boosting": "1.011",
          "monetate_category": "MONETATE_PRODUCT;;Sporting Goods;Outdoor Recreation;Camping & Hiking;Tents  @ku@kuCategory@ku@",
          "monetate_manual_boosting": "0.9",
          "searchClickToken": "Monetate-NiIsICI2LjE2NjIxMTE3NDAuMTcyNzE3MjExOTIyNCJd"
        },
        {
          ... Additional records ...
        }
      ],
      "filters": []
    }
  ]
}
﻿
﻿
Updated 17 Jan 2025
Personalized Site Search Queries
Retrieve and Apply Facets