> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt > Use this file to discover all available pages before exploring further. # Recommend Marketplace Product Categories > Suggest best-fit marketplace categories and category attribute values for a persisted product using semantic taxonomy search. Authenticate with an OmniCommerce API key as `Authorization: Bearer omni_sk_...`. ## OpenAPI ````yaml /openapi.json post /api/v1/manage-product-category/recommend 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: commerce description: Root commerce discovery x-group: Commerce - name: developer-platform description: Authenticated developer platform APIs x-group: Developer Platform - 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, and publish 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: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/manage-product-category/recommend: post: tags: - developer-platform summary: Recommend Marketplace Product Categories description: >- Suggest best-fit marketplace categories and category attribute values for a persisted product using semantic taxonomy search. Authenticate with an OmniCommerce API key as `Authorization: Bearer omni_sk_...`. operationId: post_v1_manage_product_category_recommend requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - productId - targets properties: organizationId: type: string description: >- Optional for API-key requests; required for session-authenticated requests across multiple organizations. productId: type: string description: >- OmniCommerce product ID. The API key must belong to the organization that owns this product. targets: type: array description: Marketplace/country targets to recommend categories for. items: type: object additionalProperties: false required: - marketplace properties: marketplace: type: string enum: - shopee - lazada - tiktok - shopify - zalora - amazon country: type: string description: >- Marketplace country code or name, for example singapore, malaysia, sg, or my. query: type: string minLength: 2 maxLength: 4000 description: >- Optional product-context query. When omitted, OmniCommerce derives it from product title, brand, SKU, highlights, tags, and description. limit: type: integer minimum: 1 maximum: 20 default: 5 description: Maximum category candidates per marketplace. includeAttributeAutoValues: type: boolean default: true description: >- When true, uses product context and category attribute metadata to suggest autofill values. model: type: string maxLength: 100 description: Optional model override for attribute autofill suggestions. example: productId: prod_123 targets: - marketplace: lazada country: singapore - marketplace: shopee country: malaysia limit: 5 includeAttributeAutoValues: true responses: '200': description: >- Semantic category recommendations with attribute metadata and suggested attribute values. content: application/json: schema: type: object required: - ok - apiVersion - operationId - status - productId - success - marketplaces properties: ok: type: boolean apiVersion: type: string default: developer_v1 operationId: type: string status: type: string enum: - completed productId: type: string warnings: type: array items: type: string recommendations: type: array items: type: string links: type: object additionalProperties: type: string success: type: boolean marketplaces: type: array items: type: object properties: marketplace: type: string enum: - shopee - lazada - tiktok - shopify - zalora - amazon existsOnProduct: type: boolean categories: type: array items: type: object properties: categoryId: type: string label: type: string marketplace: type: string enum: - shopee - lazada - tiktok - shopify - zalora - amazon country: type: - string - 'null' similarity: type: - number - 'null' attributes: type: array items: type: object additionalProperties: true variantAttributes: type: array items: type: object additionalProperties: true suggestedAttributeValues: type: object additionalProperties: oneOf: - type: string - type: array items: type: string suggestionMeta: type: object additionalProperties: true '400': description: Bad Request '401': description: Unauthorized '403': description: Forbidden '404': description: Product Not Found '422': description: Product has no searchable category text '500': description: Internal Server Error security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows. ````