Documentation
Feedback
Guides
API Reference

Guides
Search
Consult product search information

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
}

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
}

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
}

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
1
Photo of the contributor
+ 1 contributors
On this page