> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/shopify/search-suggest>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/shopify/search-suggest.mdx>

---

# Shopify Search Suggestions API

The autocomplete results a store shows while a shopper types.

`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.

## Request

- **Endpoint:** `GET /v1/shopify/search/suggest`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by store and query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/shopify/search/suggest/get)
- **Platform page:** [/platforms/shopify](https://www.socialfetch.dev/platforms/shopify)

## 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.