It is essential to understand the products searched in your store to present personalized marketing information to shoppers. You can use the Intelligent Search API, as detailed in the following sections, to gather information about shoppers’ product searches. This way, you can create synonyms or banners that include common searches on your store.
Get a list of suggested terms for a search term
To get a list of suggested terms for a search term, you must use the Get list of suggested terms similar to the search term endpoint. You can filter the endpoint response by defining the term's locale
and query
.
Response body example:
_24{_24 "searches": [_24 {_24 "term": "mountain bike",_24 "count": 66_24 },_24 {_24 "term": "bike helmet",_24 "count": 121_24 },_24 {_24 "term": "electric bike",_24 "count": 78_24 },_24 {_24 "term": "bike rack",_24 "count": 161_24 },_24 {_24 "term": "road bike",_24 "count": 28_24 }_24 ]_24}
Get correction of misspelled words of a search
To get the system corrections for a misspelled search term, you must use the Get attempt of correction of a misspelled term endpoint. You can filter the endpoint response by defining the term's locale
and query
.
Response body example:
_10{_10 "correction": {_10 "correction": true,_10 "misspelled": true,_10 "text": "mountain bike",_10 "highlighted": "mountain <em>bike</em>"_10 }_10}
Get product list for a specific search
To get a product list for a search term, you must use the Get list of products for a query endpoint. You can filter the endpoint response by defining the term's locale
and query
.
Response body example:
_538{_538 "products": [_538 {_538 "cacheId": "sp-2000003",_538 "productId": "2000003",_538 "description": "With this beautiful design piece you will never miss an appointment anymore. Yay.",_538 "productName": "Top Wood Clock",_538 "productReference": "clock120",_538 "linkText": "wood-clock",_538 "brand": "Sony",_538 "brandId": 2000005,_538 "link": "/wood-clock/p",_538 "categories": [_538 "/Home & Decor/"_538 ],_538 "categoryId": "40",_538 "categoriesIds": [_538 "/40/"_538 ],_538 "priceRange": {_538 "sellingPrice": {_538 "highPrice": 197.99,_538 "lowPrice": 197.99_538 },_538 "listPrice": {_538 "highPrice": 197.99,_538 "lowPrice": 197.99_538 }_538 },_538 "specificationGroups": [_538 {_538 "originalName": "allSpecifications",_538 "name": "allSpecifications",_538 "specifications": [_538 {_538 "originalName": "sellerId",_538 "name": "sellerId",_538 "values": [_538 "1"_538 ]_538 }_538 ]_538 }_538 ],_538 "skuSpecifications": [],_538 "productClusters": [_538 {_538 "id": "1970",_538 "name": "Summer"_538 }_538 ],_538 "clusterHighlights": [_538 {_538 "id": "1970",_538 "name": "Summer"_538 }_538 ],_538 "properties": [_538 {_538 "name": "sellerId",_538 "originalName": "sellerId",_538 "values": [_538 "1"_538 ]_538 }_538 ],_538 "items": [_538 {_538 "sellers": [_538 {_538 "sellerId": "1",_538 "sellerName": "VTEX",_538 "addToCartLink": "",_538 "sellerDefault": true,_538 "commertialOffer": {_538 "DeliverySlaSamplesPerRegion": {},_538 "DeliverySlaSamples": [],_538 "AvailableQuantity": 10000,_538 "discountHighlights": [],_538 "Installments": [_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "American Express à vista",_538 "PaymentSystemName": "American Express"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Visa à vista",_538 "PaymentSystemName": "Visa"_538 },_538 {_538 "Value": 98.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 2,_538 "Name": "Visa 2 vezes sem juros",_538 "PaymentSystemName": "Visa"_538 },_538 {_538 "Value": 65.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 3,_538 "Name": "Visa 3 vezes sem juros",_538 "PaymentSystemName": "Visa"_538 },_538 {_538 "Value": 49.49,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 4,_538 "Name": "Visa 4 vezes sem juros",_538 "PaymentSystemName": "Visa"_538 },_538 {_538 "Value": 39.59,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 5,_538 "Name": "Visa 5 vezes sem juros",_538 "PaymentSystemName": "Visa"_538 },_538 {_538 "Value": 32.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 6,_538 "Name": "Visa 6 vezes sem juros",_538 "PaymentSystemName": "Visa"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Diners à vista",_538 "PaymentSystemName": "Diners"_538 },_538 {_538 "Value": 100.48,_538 "InterestRate": 100,_538 "TotalValuePlusInterestRate": 200.96,_538 "NumberOfInstallments": 2,_538 "Name": "Diners 2 vezes com juros",_538 "PaymentSystemName": "Diners"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Mastercard à vista",_538 "PaymentSystemName": "Mastercard"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Boleto Bancário à vista",_538 "PaymentSystemName": "Boleto Bancário"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Vale à vista",_538 "PaymentSystemName": "Vale"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Promissory à vista",_538 "PaymentSystemName": "Promissory"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Customer Credit à vista",_538 "PaymentSystemName": "Customer Credit"_538 },_538 {_538 "Value": 98.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 2,_538 "Name": "Customer Credit 2 vezes sem juros",_538 "PaymentSystemName": "Customer Credit"_538 },_538 {_538 "Value": 67.97,_538 "InterestRate": 100,_538 "TotalValuePlusInterestRate": 203.91,_538 "NumberOfInstallments": 3,_538 "Name": "Customer Credit 3 vezes com juros",_538 "PaymentSystemName": "Customer Credit"_538 },_538 {_538 "Value": 197.99,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 197.99,_538 "NumberOfInstallments": 1,_538 "Name": "Free à vista",_538 "PaymentSystemName": "Free"_538 }_538 ],_538 "Price": 197.99,_538 "ListPrice": 197.99,_538 "spotPrice": 197.99,_538 "taxPercentage": 0,_538 "PriceWithoutDiscount": 197.99,_538 "Tax": 0,_538 "GiftSkuIds": [],_538 "BuyTogether": [],_538 "ItemMetadataAttachment": [],_538 "RewardValue": 0,_538 "PriceValidUntil": "2023-04-01T13:13:20Z",_538 "GetInfoErrorMessage": null,_538 "CacheVersionUsedToCallCheckout": "",_538 "teasers": [_538 {_538 "name": "8% Boleto",_538 "conditions": {_538 "minimumQuantity": 0,_538 "parameters": [_538 {_538 "name": "PaymentMethodId",_538 "value": "6"_538 }_538 ]_538 },_538 "effects": {_538 "parameters": [_538 {_538 "name": "PercentualDiscount",_538 "value": "8.0"_538 }_538 ]_538 }_538 }_538 ]_538 }_538 }_538 ],_538 "images": [_538 {_538 "imageId": "155484",_538 "cacheId": "155484",_538 "imageTag": "",_538 "imageLabel": "",_538 "imageText": "",_538 "imageUrl": "https://storecomponents.vtexassets.com/arquivos/ids/155484/Frame.jpg?v=636793817478300000"_538 },_538 {_538 "imageId": "155485",_538 "cacheId": "155485",_538 "imageTag": "",_538 "imageLabel": "",_538 "imageText": "",_538 "imageUrl": "https://storecomponents.vtexassets.com/arquivos/ids/155485/Frame-1.jpg?v=636793817642000000"_538 },_538 {_538 "imageId": "155486",_538 "cacheId": "155486",_538 "imageTag": "",_538 "imageLabel": "",_538 "imageText": "",_538 "imageUrl": "https://storecomponents.vtexassets.com/arquivos/ids/155486/Frame-2.jpg?v=636793817785530000"_538 }_538 ],_538 "itemId": "2000534",_538 "name": "1",_538 "nameComplete": "Top Wood Clock 1",_538 "complementName": "",_538 "referenceId": [_538 {_538 "Key": "RefId",_538 "Value": "16001"_538 }_538 ],_538 "measurementUnit": "un",_538 "unitMultiplier": 1,_538 "variations": [],_538 "ean": "16001",_538 "modalType": "",_538 "videos": [],_538 "attachments": [],_538 "isKit": false_538 }_538 ],_538 "origin": "intelligent-search"_538 },_538 {_538 "cacheId": "sp-2000214",_538 "productId": "2000214",_538 "description": "",_538 "productName": "kevin1",_538 "linkText": "kevin1-lkn",_538 "brand": "Sony",_538 "brandId": 2000005,_538 "link": "/kevin1-lkn/p",_538 "categories": [_538 "/Home & Decor/"_538 ],_538 "categoryId": "40",_538 "categoriesIds": [_538 "/40/"_538 ],_538 "priceRange": {_538 "sellingPrice": {_538 "highPrice": 10,_538 "lowPrice": 10_538 },_538 "listPrice": {_538 "highPrice": 10,_538 "lowPrice": 10_538 }_538 },_538 "specificationGroups": [_538 {_538 "originalName": "allSpecifications",_538 "name": "allSpecifications",_538 "specifications": [_538 {_538 "originalName": "sellerId",_538 "name": "sellerId",_538 "values": [_538 "1"_538 ]_538 }_538 ]_538 }_538 ],_538 "skuSpecifications": [],_538 "productClusters": [],_538 "clusterHighlights": [],_538 "properties": [_538 {_538 "name": "sellerId",_538 "originalName": "sellerId",_538 "values": [_538 "1"_538 ]_538 }_538 ],_538 "items": [_538 {_538 "sellers": [_538 {_538 "sellerId": "1",_538 "sellerName": "VTEX",_538 "addToCartLink": "",_538 "sellerDefault": true,_538 "commertialOffer": {_538 "DeliverySlaSamplesPerRegion": {},_538 "DeliverySlaSamples": [],_538 "AvailableQuantity": 10000,_538 "discountHighlights": [],_538 "Installments": [_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "American Express à vista",_538 "PaymentSystemName": "American Express"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Visa à vista",_538 "PaymentSystemName": "Visa"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Diners à vista",_538 "PaymentSystemName": "Diners"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Mastercard à vista",_538 "PaymentSystemName": "Mastercard"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Boleto Bancário à vista",_538 "PaymentSystemName": "Boleto Bancário"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Vale à vista",_538 "PaymentSystemName": "Vale"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Promissory à vista",_538 "PaymentSystemName": "Promissory"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Customer Credit à vista",_538 "PaymentSystemName": "Customer Credit"_538 },_538 {_538 "Value": 5,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 2,_538 "Name": "Customer Credit 2 vezes sem juros",_538 "PaymentSystemName": "Customer Credit"_538 },_538 {_538 "Value": 3.43,_538 "InterestRate": 100,_538 "TotalValuePlusInterestRate": 10.29,_538 "NumberOfInstallments": 3,_538 "Name": "Customer Credit 3 vezes com juros",_538 "PaymentSystemName": "Customer Credit"_538 },_538 {_538 "Value": 10,_538 "InterestRate": 0,_538 "TotalValuePlusInterestRate": 10,_538 "NumberOfInstallments": 1,_538 "Name": "Free à vista",_538 "PaymentSystemName": "Free"_538 }_538 ],_538 "Price": 10,_538 "ListPrice": 10,_538 "spotPrice": 10,_538 "taxPercentage": 0,_538 "PriceWithoutDiscount": 10,_538 "Tax": 0,_538 "GiftSkuIds": [],_538 "BuyTogether": [],_538 "ItemMetadataAttachment": [],_538 "RewardValue": 0,_538 "PriceValidUntil": "2023-04-01T13:13:20Z",_538 "GetInfoErrorMessage": null,_538 "CacheVersionUsedToCallCheckout": "",_538 "teasers": [_538 {_538 "name": "8% Boleto",_538 "conditions": {_538 "minimumQuantity": 0,_538 "parameters": [_538 {_538 "name": "PaymentMethodId",_538 "value": "6"_538 }_538 ]_538 },_538 "effects": {_538 "parameters": [_538 {_538 "name": "PercentualDiscount",_538 "value": "8.0"_538 }_538 ]_538 }_538 }_538 ]_538 }_538 }_538 ],_538 "images": [_538 {_538 "imageId": "155675",_538 "cacheId": "155675",_538 "imageTag": "",_538 "imageLabel": "vtex",_538 "imageText": "vtex",_538 "imageUrl": "https://storecomponents.vtexassets.com/arquivos/ids/155675/vtex.jpg?v=637655270451200000"_538 }_538 ],_538 "itemId": "310124211",_538 "name": "kevin1sku",_538 "nameComplete": "kevin1sku",_538 "complementName": "",_538 "referenceId": [_538 {_538 "Key": "RefId",_538 "Value": "2983678w63478"_538 }_538 ],_538 "measurementUnit": "un",_538 "unitMultiplier": 1,_538 "variations": [],_538 "ean": "2398428937489",_538 "modalType": "",_538 "videos": [],_538 "attachments": [],_538 "isKit": false_538 }_538 ],_538 "origin": "intelligent-search"_538 }_538 ],_538 "recordsFiltered": 5,_538 "correction": {_538 "misspelled": false_538 },_538 "fuzzy": "0",_538 "operator": "and",_538 "translated": false_538}