Shopify Search Suggestions API
The autocomplete results a store shows while a shopper types.
GET /v1/shopify/search/suggest1 credit Failed requests are free
About this endpoint
GET /v1/shopify/search/suggest?store=…&query=shi returns data.products, collections, pages, articles and queries. Product suggestions include prices and any matching variants, and query suggestions carry text, styledText and url. Prices carry the store's currency, and product and collection links are the store's clean URLs without search tracking parameters.
limit is capped at 10. A store with nothing to suggest returns found with empty lists.
Shopify Search Suggestions API FAQ
How many suggestions can I request?
limit is 1 to 10. The store's own suggestion route also caps what it returns.
What are query suggestions?
The suggested search phrases the store offers, with the text and the URL that would run that search.
Why are variants included?
Product suggestions can include the matching variants and their prices so an autocomplete can show a price beside the product. Prices carry the store's currency.
How do I name the store?
The store is the domain, for example allbirds.com, www.allbirds.com or weareallbirds.myshopify.com. A full URL is reduced to its host.
How is it billed?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
What does lookupStatus mean?
found means the lookup succeeded. not_found means the store or entity does not exist or is not a Shopify store. private means the storefront is password-protected. restricted means it is paused or frozen. HTTP 200 only means the request finished, so branch on lookupStatus.