Storefront API
Search
Typo-tolerant product search over the store’s indexed catalog, tuned for search-as-you-type boxes. Hits are lightweight cards — follow productId to the detail endpoint for variants.
GET/storefront/v1/searchrate tier: public-read
| Query | Type | Description |
|---|---|---|
| qreq | string | The search phrase. |
▸ GET /storefront/v1/search?q=tee▸ X-Publishable-Key: pk_live_9f2…◂ 200 OK{ "hits": [ { "productId": "ad9b7bd4-…", "title": "Classic Cotton Tee", "image": "https://cdn…/tee.webp", "priceAmount": 79900, "currency": "INR" } ]}
Indexing is asynchronous: a product created a moment ago can lag the catalog endpoints by a few seconds. Treat search as a discovery surface, and the catalog endpoints as the source of truth.