> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnicommerce.ai/llms.txt > Use this file to discover all available pages before exploring further. # Search Within Public Merchant Catalog > Search within a single merchant's public product feed using the same filter model as the cross-merchant search API. ## OpenAPI ````yaml /openapi.json get /api/v1/merchants/{merchantId}/search openapi: 3.1.0 info: title: OmniCommerce API version: 1.0.0 license: name: Proprietary url: https://omnicommerce.sg/terms description: >- OmniCommerce API surface for agents and developer integrations. Includes public endpoints (merchant discovery, product search, compare, catalog, ACO retrieval) and authenticated endpoints (product management via API key Bearer tokens). servers: - url: https://omnicommerce.sg description: Production - url: http://localhost:3000 description: Local development security: [] tags: - name: agentic-checkout description: Merchant-fulfilled agentic checkout x-group: Agentic Checkout - name: agents description: agents x-group: Agents - name: analytics description: Sales performance across marketplaces x-group: Analytics - name: aops description: Agent operating procedures x-group: AOPs - name: campaigns description: Campaign briefs, offer windows, and marketplace runs x-group: Campaigns - name: developer-platform description: Authenticated developer platform APIs x-group: Developer Platform - name: documents description: Knowledge base document uploads x-group: Knowledge Base - name: looks description: AI-styled product looks x-group: Looks - name: oauth description: OAuth token endpoints x-group: OAuth - name: orders description: Workspace and agentic orders x-group: Orders - name: organizations description: Organization management x-group: Organizations - name: price-books description: Marketplace list-price markup rules x-group: Price Books - name: products description: Product CRUD, bulk import, enrichment, publish, and delist x-group: Products - name: promotions description: Central promotions and marketplace sync x-group: Promotions - name: public-agent description: Public agent discovery and catalog APIs x-group: Public Agent - name: returns description: returns x-group: Returns - name: reviews description: Marketplace product reviews and seller replies x-group: Reviews - name: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/merchants/{merchantId}/search: get: tags: - public-agent summary: Search Within Public Merchant Catalog description: >- Search within a single merchant's public product feed using the same filter model as the cross-merchant search API. operationId: get_v1_merchants_by_merchantid_search parameters: - name: merchantId in: path required: true schema: type: string - name: currency in: query required: false description: >- ISO currency code. Required for price ranges and price sorting; no cross-currency ranking or conversion. schema: type: string pattern: ^[A-Z]{3}$ - name: min_rating in: query required: false description: >- Minimum average imported product review rating. Unrated products do not match; not a marketplace-wide lifetime rating. schema: type: number minimum: 1 maximum: 5 - name: min_review_count in: query required: false description: Minimum number of imported rated product reviews. schema: type: integer minimum: 1 maximum: 1000000 - name: added_after in: query required: false description: >- Inclusive catalog creation timestamp with time zone. Does not mean product release date. schema: type: string format: date-time - name: variant_options in: query required: false description: >- JSON array of 1-5 exact, case-insensitive option pairs, e.g. [{"name":"Color","value":"Red"}]. All options must match the same variant. schema: type: string - name: q in: query required: false description: Natural-language search query. schema: type: string maxLength: 300 - name: category in: query required: false description: Optional category-name filter. schema: type: string maxLength: 120 - name: brand in: query required: false description: Optional brand filter. schema: type: string maxLength: 120 - name: min_price in: query required: false description: >- Minimum catalogPrice in the requested currency (inclusive). Requires currency. schema: type: number minimum: 0 - name: max_price in: query required: false description: >- Maximum catalogPrice in the requested currency (inclusive). Requires currency. schema: type: number minimum: 0 - name: in_stock in: query required: false description: Filter by stock availability. schema: type: boolean - name: sort in: query required: false description: >- Sort by relevance, newest catalog addition, catalog price, imported average rating, or review count. Price sorting requires currency; most_reviewed is not best selling. schema: type: string enum: - relevance - newest - price_asc - price_desc - rating_desc - most_reviewed default: relevance - name: platform in: query required: false description: Marketplace platform filter. schema: type: string enum: - shopee - lazada - tiktok - shopify - whatsapp - zalora - amazon - ebay - name: country in: query required: false description: 'Marketplace country hint (example: sg).' schema: type: string - name: language in: query required: false description: Localization language. Defaults to en. schema: type: string enum: - en - th - id - ms - vi - tl default: en - name: include_intent in: query required: false description: Include lightweight parsed query intent metadata. schema: type: boolean - name: limit in: query required: false description: Result limit (1..100). Defaults to 20. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: offset in: query required: false description: Pagination offset (0..10000). Defaults to 0. schema: type: integer minimum: 0 maximum: 10000 default: 0 responses: '200': description: Success content: application/json: schema: type: object properties: ok: type: boolean apiVersion: type: string default: merchant_search_v1 '400': description: Bad Request '401': description: Unauthorized '402': description: Insufficient Credits '403': description: Forbidden '500': description: Internal Server Error security: [] ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.