Skip to main content

Search

The Storefront API provides product search with full-text matching across product names, descriptions, SKUs, and attribute values.

Search Products​

GET /api/storefront/products/search?q=t-shirt&page=1&pageSize=20
X-Store-Code: us-store
X-Language-Code: en
X-Currency-Code: USD

Response: Same paginated format as the category product listing:

{
  "products": [...],
  "page": 1,
  "pageSize": 20,
  "totalCount": 5,
  "totalPages": 1
}

Rate Limiting​

Search endpoints have a stricter rate limit (60 requests/minute by default) compared to the global limit (100 requests/minute). This protects against abuse while allowing normal usage.

If rate limited, you'll receive:

HTTP/1.1 429 Too Many Requests
Retry-After: 60

Search Tips​

  • Search is case-insensitive
  • Results are filtered by the current store context (store mappings apply)
  • Only active products are returned
  • Prices are pre-resolved for the requested currency
  • Results are cached for 2 minutes per unique query + store/language/currency combination

If Qdrant is configured, the API can provide semantic/vector-based search for more intelligent results (e.g., searching "summer outfit" returns relevant products even if those exact words aren't in the product title). This is an optional enhancement — standard text search works without Qdrant.