Guide
Smart Category Merchandising
Category Product Search
2 min
if you haven't gone through the prerequisites and the v2 structure, please have a look at overview docid\ czeodl0skcuv 18ipuplr tab examples url https hostname cs v2 search name category search method post request pathparameters queryparameters headerparameters bodydataparameters kind required name typeofrequest type string description this parameter defines the type of request it is which should be catnav for category merchandising queries there are other values available detailed elsewhere in the documentation kind required name categorypath type string description specify the name of the category to retrieve results from in the same case and format as it is indexed with klevu n nfor nested categories use the ; character to separate the hierarchy for example for mens shoes trainers and sneakers you would specify mens;shoes;trainers and sneakers name merchandisingversion kind optional type integer description this is related to klevu category merchandising webhook nhttps help klevu com support solutions articles 5000892289 klevu webhook integration guide nwhen a webhook for category merchandising is received this field will be included in the request payload pass this field when some merchandising rule is being updated and search cache bypass is needed this is related to klevu category merchandising webhook nhttps help klevu com support solutions articles 5000892289 klevu webhook integration guide nwhen a webhook for category merchandising is received this field will be included in the request payload pass this field when some merchandising rule is being updated and search cache bypass is needed formdataparameters results languages id 3xlvmt855lgkjoht0npxg code n meta n qtime 7 n responsecode 200 n n queryresults n n id categoryproducts n meta n qtime 5 n noofresults 12 n totalresultsfound 73 n typeofsearch wildcard and n offset 0 n debugginginformation n notificationcode 1 n searchedterm n apikey klevu 156925593843210765 n ispersonalised false n n records n n discount n hidegroupprices n type hoodies sweatshirts n itemgroupid 4384033833022 n freeshipping n storebasecurrency gbp n price 75 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products wj01 red main c9193846 bc80 4537 b810 4f6ad82dd6fe medium jpg?v 1575478019 n currency gbp n instock yes n id 31366456541246 n imagehover n sku wj01 s red n brand ksd n startprice n image https cdn shopify com s files 1 0116 9457 1582 products wj01 red main c9193846 bc80 4537 b810 4f6ad82dd6fe medium jpg?v 1575478019 n deliveryinfo n hideaddtocart n saleprice 75 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets;;hoodies sweatshirts ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products stellar solar jacket s red n tags cold whether comfortable crewneck grayson hoodie machine sweatshirt winter wool n size small n name stellar solar jacket n shortdesc beat the heat and protect yourself from sunrays with the stellar solar jacket it s loaded with all the engineered features you need for an intense safe outdoor workout 100 uv protection a breathable perforated construction and advanced moist n category jackets;;hoodies sweatshirts n n n discount n hidegroupprices n type jackets n itemgroupid 4384052215870 n freeshipping n storebasecurrency gbp n price 99 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products mj08 blue main bb248254 73cc 4521 8105 fe2277267348 medium jpg?v 1575478286 n currency gbp n instock yes n id 31366487441470 n imagehover n sku mj08 xs blue n brand ksd n startprice n image https cdn shopify com s files 1 0116 9457 1582 products mj08 blue main bb248254 73cc 4521 8105 fe2277267348 medium jpg?v 1575478286 n deliveryinfo n hideaddtocart n saleprice 99 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products lando gym jacket blue n tags blue machine royal zipped n size small n name lando gym jacket n shortdesc the lando gym jacket offers strategic ventilation at perspiration prone areas while moisture wicking technology helps you stay dry side seam pockets house your favorite media device so you re plugged in when working out gray polyester n category jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384033341502 n freeshipping n storebasecurrency gbp n price 84 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products wj04 orange main 098af8fb 1cf2 473f 907a 10922e39beae medium jpg?v 1575478007 n currency gbp n instock yes n id 31366455590974 n imagehover n sku wj04 xs orange n brand mnh n startprice n image https cdn shopify com s files 1 0116 9457 1582 products wj04 orange main 098af8fb 1cf2 473f 907a 10922e39beae medium jpg?v 1575478007 n deliveryinfo n hideaddtocart n saleprice 84 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products ingrid running jacket orange n tags comfort machine royal running zipped n size small n name ingrid running jacket n shortdesc the ingrid running jacket combines sleek design and high performance with slim contoured fit and moisture wicking fabric it features a full zip construction and a collared neck to keep the elements out and body heat in slim fit moi n category jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384031244350 n freeshipping n storebasecurrency gbp n price 77 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products wj06 green main 30b7fa7f a3ce 4513 9307 822bf013a89d medium jpg?v 1575477963 n currency gbp n instock yes n id 31366453067838 n imagehover n sku wj06 xs green n brand ksd n startprice n image https cdn shopify com s files 1 0116 9457 1582 products wj06 green main 30b7fa7f a3ce 4513 9307 822bf013a89d medium jpg?v 1575477963 n deliveryinfo n hideaddtocart n saleprice 77 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products juno jacket green n tags adjustable comfort machine royal running zipped n size large n name juno jacket n shortdesc on colder than comfortable mornings you ll love warming up in the juno all ways performanc jacket designed to compete with wind and chill built in cocona technology aids evaporation while a special zip placket and stand up collar keep your ne n category jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384052084798 n freeshipping n storebasecurrency gbp n price 99 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products mj08 green main 7f692ff8 45b0 4d08 8371 a2044df82752 medium jpg?v 1575478284 n currency gbp n instock yes n id 31366487310398 n imagehover n sku mj08 xs green n brand mnh n startprice n image https cdn shopify com s files 1 0116 9457 1582 products mj08 green main 7f692ff8 45b0 4d08 8371 a2044df82752 medium jpg?v 1575478284 n deliveryinfo n hideaddtocart n saleprice 99 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products lando gym jacket green n tags green machine royal zipped n size medium n name lando gym jacket n shortdesc the lando gym jacket offers strategic ventilation at perspiration prone areas while moisture wicking technology helps you stay dry side seam pockets house your favorite media device so you re plugged in when working out gray polyester n category jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384051527742 n freeshipping n storebasecurrency gbp n price 66 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products mj10 red main 9e1898b9 9d4a 41df 8dc6 7d31cd23c34e medium jpg?v 1575478275 n currency gbp n instock yes n id 31366485966910 n imagehover n sku mj10 xs red n brand mnh n startprice n image https cdn shopify com s files 1 0116 9457 1582 products mj10 red main 9e1898b9 9d4a 41df 8dc6 7d31cd23c34e medium jpg?v 1575478275 n deliveryinfo n hideaddtocart n saleprice 66 0 n swatchesinfo n weight n klevu category klevu product;products;;tops;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products mars heattech trade pullover red n tags machine red royal zipped n size medium n name mars heattech pullover n shortdesc the mars heattech jacket defense against winter climes so you can play offense in the park on the trail or in the deck chair great for the ski lodge or stadium it features a wind and water resistant outer shell with a draw cord hood and deep n category tops;;jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384033603646 n freeshipping n storebasecurrency gbp n price 56 25 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products wj02 blue main 8549c057 4567 4b63 ac2e 2068d345ff28 medium jpg?v 1575478014 n currency gbp n instock yes n id 31366456279102 n imagehover n sku wj02 xs blue n brand ksd n startprice n image https cdn shopify com s files 1 0116 9457 1582 products wj02 blue main 8549c057 4567 4b63 ac2e 2068d345ff28 medium jpg?v 1575478014 n deliveryinfo n hideaddtocart n saleprice 56 25 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products josie yoga jacket blue n tags comfort machine royal running zipped n size small n name josie yoga jacket n shortdesc when your near future includes yoga the cozy comfort of the josie yoga jacket gets your mind and body ready stretchy cooltech fabric with zipper pockets makes this jacket the right gear for studio time or teatime after slate rouched n n category jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384052150334 n freeshipping n storebasecurrency gbp n price 99 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products mj08 gray main 3787cf65 8e0a 4540 8f11 6d188980a6eb medium jpg?v 1575478285 n currency gbp n instock yes n id 31366487375934 n imagehover n sku mj08 xs gray n brand kke n startprice n image https cdn shopify com s files 1 0116 9457 1582 products mj08 gray main 3787cf65 8e0a 4540 8f11 6d188980a6eb medium jpg?v 1575478285 n deliveryinfo n hideaddtocart n saleprice 99 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products lando gym jacket gray n tags gray machine royal zipped n size large n name lando gym jacket n shortdesc the lando gym jacket offers strategic ventilation at perspiration prone areas while moisture wicking technology helps you stay dry side seam pockets house your favorite media device so you re plugged in when working out gray polyester n category jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384033243198 n freeshipping n storebasecurrency gbp n price 84 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products wj04 white main d8fa2b03 08ff 485c afd1 b3761e70e9ce medium jpg?v 1575478004 n currency gbp n instock yes n id 31366455427134 n imagehover n sku wj04 xs white n brand kke n startprice n image https cdn shopify com s files 1 0116 9457 1582 products wj04 white main d8fa2b03 08ff 485c afd1 b3761e70e9ce medium jpg?v 1575478004 n deliveryinfo n hideaddtocart n saleprice 84 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products ingrid running jacket white n tags comfort machine royal running zipped n size medium n name ingrid running jacket n shortdesc the ingrid running jacket combines sleek design and high performance with slim contoured fit and moisture wicking fabric it features a full zip construction and a collared neck to keep the elements out and body heat in slim fit moi n category jackets n n n discount n hidegroupprices n type jackets n itemgroupid 4384033308734 n freeshipping n storebasecurrency gbp n price 84 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products wj04 red main 5c76d8d8 ad1a 414f b6b7 9edccc50b955 medium jpg?v 1575478005 n currency gbp n instock yes n id 31366455525438 n imagehover n sku wj04 xs red n brand ksd n startprice n image https cdn shopify com s files 1 0116 9457 1582 products wj04 red main 5c76d8d8 ad1a 414f b6b7 9edccc50b955 medium jpg?v 1575478005 n deliveryinfo n hideaddtocart n saleprice 84 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products ingrid running jacket red n tags comfort machine royal running zipped n size large n name ingrid running jacket n shortdesc the ingrid running jacket combines sleek design and high performance with slim contoured fit and moisture wicking fabric it features a full zip construction and a collared neck to keep the elements out and body heat in slim fit moi n category jackets n n n discount n hidegroupprices n type hoodies sweatshirts n itemgroupid 4384033964094 n freeshipping n storebasecurrency gbp n price 75 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products wj01 blue main d6ed0a23 7d18 42d4 921c 5669f65a7580 medium jpg?v 1575478022 n currency gbp n instock yes n id 31366456672318 n imagehover n sku wj01 s blue n brand mnh n startprice n image https cdn shopify com s files 1 0116 9457 1582 products wj01 blue main d6ed0a23 7d18 42d4 921c 5669f65a7580 medium jpg?v 1575478022 n deliveryinfo n hideaddtocart n saleprice 75 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets;;hoodies sweatshirts ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products stellar solar jacket s blue n tags cold whether comfortable crewneck grayson hoodie machine sweatshirt winter wool n size small n name stellar solar jacket n shortdesc beat the heat and protect yourself from sunrays with the stellar solar jacket it s loaded with all the engineered features you need for an intense safe outdoor workout 100 uv protection a breathable perforated construction and advanced moist n category jackets;;hoodies sweatshirts n n n discount n hidegroupprices n type jackets n itemgroupid 4384052412478 n freeshipping n storebasecurrency gbp n price 72 00 n toprice n imageurl https cdn shopify com s files 1 0116 9457 1582 products mj07 red main 7fb57683 fddb 44a9 90aa fc03536bbd90 medium jpg?v 1575478289 n currency gbp n instock yes n id 31366487769150 n imagehover n sku mj07 xs red n brand kke n startprice n image https cdn shopify com s files 1 0116 9457 1582 products mj07 red main 7fb57683 fddb 44a9 90aa fc03536bbd90 medium jpg?v 1575478289 n deliveryinfo n hideaddtocart n saleprice 72 0 n swatchesinfo n weight n klevu category klevu product;products;;jackets ku kucategory ku n totalvariants 0 n groupprices n url https jsv2 shopify demo ksearchmisc com products orion two tone fitted jacket red n tags machine red royal zipped n size large n name orion two tone fitted jacket n shortdesc while you re getting fit you need a fitted jacket to match striking color blocking patterns on hood shoulders and arms are hallmarks of the orion two tone fitted jacket they provide eye catching contrast against the rich torso tones of this 1 n category jackets n n n filters n n n language 200 customlabel selectedlanguageid 3xlvmt855lgkjoht0npxg examples languages id jsu7dlyyj euh63ysp682 code n recordqueries n n id categoryproducts n typeofrequest catnav n settings n merchandisingversion 1739999922000 n query n categorypath jackets n n n n n context n apikeys n klevu 156925593843210765 n n n language json customlabel request body json id 8yg33te4jzfowp5yebmjh code ?php n n curl curl init ; n ncurl setopt array curl array n curlopt url https eucs15v2 ksearchnet com cs v2 search n curlopt returntransfer true n curlopt encoding n curlopt maxredirs 10 n curlopt timeout 0 n curlopt followlocation true n curlopt http version curl http version 1 1 n curlopt customrequest post n curlopt postfields n recordqueries n n id categoryproducts n typeofrequest catnav n settings n merchandisingversion 1739999922000 n query n categorypath jackets n n n n n context n apikeys n klevu 156925593843210765 n n n n curlopt httpheader array n content type application json n n ; n n response curl exec curl ; n ncurl close curl ; necho response; language php customlabel id wcdgtssqaxfiwklk2v174 code warning for post requests body is set to null by browsers nvar data json stringify n recordqueries n n id categoryproducts n typeofrequest catnav n settings n merchandisingversion 1739999922000 n query n categorypath jackets n n n n n context n apikeys n klevu 156925593843210765 n n n ; n nvar xhr new xmlhttprequest ; nxhr withcredentials true; n nxhr addeventlistener readystatechange function n if this readystate 4 n console log this responsetext ; n n ; n nxhr open post https eucs15v2 ksearchnet com cs v2 search ; nxhr setrequestheader content type application json ; n nxhr send data ; language javascript customlabel id npw0nije j5r9i5w4bgn0 code okhttpclient client new okhttpclient newbuilder n build ; nmediatype mediatype mediatype parse application json ; nrequestbody body requestbody create mediatype r n recordqueries r n r n id categoryproducts r n typeofrequest catnav r n settings r n merchandisingversion 1739999922000 r n query r n categorypath jackets r n r n r n r n r n context r n apikeys r n klevu 156925593843210765 r n r n r n ; nrequest request new request builder n url https eucs15v2 ksearchnet com cs v2 search n method post body n addheader content type application json n build ; nresponse response client newcall request execute ; language java customlabel id 0ih7niekhhfml7cry51j code var request require request ; nvar options n method post n url https eucs15v2 ksearchnet com cs v2 search n headers n content type application json n n body json stringify n recordqueries n n id categoryproducts n typeofrequest catnav n settings n merchandisingversion 1739999922000 n query n categorypath jackets n n n n n context n apikeys n klevu 156925593843210765 n n n n n ; nrequest options function error response n if error throw new error error ; n console log response body ; n ; language nodejs customlabel selectedlanguageid jsu7dlyyj euh63ysp682 description this is an example how to fetch product from specific category currentnewparameter label body parameter value bodydataparameters try it here!