Get Catalog Search
LLM-shape full-text search across the merchant’s active catalog.
Same engine as /api/storefront/search (tsvector ranked by
ts_rank_cd); per-product output is AgentCatalogProduct with
summary_for_llm baked in so the agent doesn’t need a follow-up
call to render candidate cards.
Tenant scope is enforced by SearchService.full filtering on the
caller’s resolved merchant_id. The caller’s scope set must
include catalog:read (gate via require_agent_scopes).
Query Parameters
1 - 256x >= 11 <= x <= 50Response
Successful Response
Response shape for GET /api/agent/catalog/search.
Mirrors StorefrontSearchResponse for paginator semantics so any
Phase 7 SDK can share the underlying client; the per-product
shape is the LLM-friendly AgentCatalogProduct.