Examples

if you haven't gone through the prerequisites and the v2 structure, please have a look at overview docid\ czeodl0skcuv 18ipuplr custom record type in addition to products, categories and cms pages, klevu apiv2 allows you to search for custom entities for example, if you want to display results for recipes, articles or physical stores within your search you can do so by utilising the typeofrecords parameter try it here multiple queries klevu apiv2 allows you to request multiple product, category, cms pages and custom entity queries all at the same time all of these queries are usually fired simultaneously, meaning the total time taken is the duration of the slowest query, rather than the total of all queries in the example to the right, a single http request is returning 3x search suggestions 3x categories 5x products with filters 3x different products without filters 5x cms pages or recipes (a custom entity) 1x store (a custom entity) furthermore, all of the configuration and preferences found within this documentation can be applied to each and evey query separately, making an extremely powerful and fast way to display search results try it here! fallback queries sometimes customers will search for something which yields few or no results in this scenario, you can either present your customer with a 'no results found' message, or you can use the result of another query to show some records which they may be interested in we call this a fallback query any query flagged as isfallbackquery true will not execute unless certain criteria are met with this approach you can present customers with alternative results, without needing to make any additional http requests, and also without the jeopardising performance of the initial query try it here! hand picked products sometimes merchants want to take control over which records are included or excluded, or whether certain records should always take precedence over others this can be done via query time manual merchandising try it here! custom queries deprecated the use of customandquery is being deprecated for better control over custom queries please review and use advanced filtering docid\ rbt4zzdiheip1lcuk8n r you can even write your own custom queries with klevu search, to take more control over your results the example to the right shows how you can build a query to filter results by small or medium records which are not brand "kke " try it here! multiple currencies if your store has multiple currencies and you would like to show different values based on the currency your customer is currently viewing, this can be achieved using the pricefieldsuffix parameter when specifying a value for pricefieldsuffix, the following fields in your response data will be replaced with the value indexed with klevu for the corresponding currency price saleprice currency try it here! customer groups a common b2b requirement is different product visibility and prices based on a customer group with klevu apiv2 you can specify parameters to filter out products which a particular customer should not see, and also show them specific prices if they differ from the base price when specifying a value for pricefieldsuffix, the following fields in your response data will be replaced with the value indexed with klevu for the corresponding currency and group price saleprice currency when specifying a value for visibilitygroupid, any records that do not belong to that group will be excluded from the results in the example to the right, the same product is indexed with data for currencies 'gbp' and 'usd' it's visibility is set to groups 'my group 1' and 'my group 3', but not 'my group 2' try it here