# Shopify search suggestions: `POST /v1/retail/shopify/search/suggestions`

Cost: 2 credits (2 (an empty result and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/shopify-search-suggestions

The store's suggest feed for a query. A result keeps at most 100
variants and 25 images per product. `variants_omitted` and
`images_omitted` count what was left off. An empty result is not billed.

Request body (JSON):

- `store` (string; required; min length 1, max length 300): Public store address, a domain or an https URL (allbirds.com).
- `market` (string | null; optional): Market code echoed on the answer. It does not change the currency the store publishes.
- `locale` (string | null; optional): Locale path prefix the store publishes, such as en or en-ca.
- `q` (string; required; min length 1, max length 200): Search words.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)