About the Marketplace Products API

Use the Marketplace Products API to offer products in the Wix Marketplace as dropshipping, wholesale, or both. This API enables approved business partners to publish products to the Marketplace, where Wix users can discover and add them to their stores.

With the Marketplace Products API, you can:

  • Create and manage products with rich media, pricing, and inventory information.
  • Support both dropshipping and wholesale business models with flexible pricing tiers.
  • Organize products using category assignment and tagging.
  • Perform bulk operations for efficient catalog management.
  • Search and query products with full-text search or real-time accuracy.

Applying for partnership

This API is available only to approved Wix business partners and requires a signed business agreement with Wix. To apply for partnership, contact jills@wix.com with a short description of your product and integration goals.

Access to this API is limited to ensure that integrations meet Wix's product quality, data security, and user experience standards. Each request is reviewed individually based on the partner's product characteristics, technical capabilities, and alignment with Wix's ecosystem.

If your application does not meet the criteria for partnership, consider publishing your integration via the Wix App Market, which provides a public route for developers to make their products available to Wix users.

How it works

As a business partner, you create a provider app that manages products on behalf of one or more suppliers. Here's how the components work together:

  1. Your Provider App: Integrates with the Marketplace Products API to create and manage product catalogs.
  2. Suppliers: The actual businesses that own and fulfill the products. Each product can optionally be associated with a supplier to display supplier information like name, rating, and verification status in the Marketplace.
  3. Products: The items you publish to the Marketplace. Each product must include core information like name, media, pricing, and business model type for either dropshipping, wholesale, or both.
  4. Wix Store Owners: Browse the Marketplace, discover your products, and add them to their stores.

Your provider app serves as the connection point between your suppliers' product catalogs and the Wix Marketplace. You maintain synchronization by linking each Marketplace product to its source using providerInfo.productId.

Business models

The Marketplace supports 2 business models, and products can support one or both:

Dropshipping: Store owners add your products to their stores without holding inventory. When a customer places an order, the supplier ships directly to the customer. Dropshipping products require minimumPrice and shipping information.

Wholesale: Store owners purchase products in bulk at volume-based pricing tiers. Wholesale products require wholesaleOptions with:

  • Price tiers: Quantity-based pricing that must be continuous, with no gaps between tiers. For example, tier 1 for quantities 1-100, tier 2 for 101+.
  • Minimum order quantity: The smallest quantity a store owner can purchase.

Products can support both models simultaneously by setting types to both DROPSHIPPING and WHOLESALE. This allows store owners to choose their preferred business model for each product.

Before you begin

It's important to note the following points before starting to code:

  • Business partner agreement required: Access to this API requires a signed business agreement and implementation plan with Wix.
  • Bulk operation limits: Maximum 100 products per bulk request and 100 products per query request. For operations on more than 100 products, split them into multiple batches.
  • Product media: Limited to 15 images per product. The first image becomes the main image.
  • Categories: Limited to 100 categories per product. Category namespaces must match the product's type, either dropshipping or wholesale.
  • Immutable fields: You can't change providerInfo.productId and providerInfo.productCreatedDate after creating a product. These fields link to your external system and prevent duplicates.
  • Product options: Options are currently informational only and don't create separate inventory items. Variant inventory tracking is planned for a future release.
  • Search vs Query: Use Query Products for real-time accuracy in operational tasks. Use Search Products for product discovery and browsing with eventual consistency.
  • Supplier association: Associating a product with a supplier is optional. When you provide supplierInfo.id, the system automatically retrieves the supplier's name, rating, and verification status.

Use cases

Terminology

  • Marketplace: The platform where suppliers publish products and Wix store owners discover them.
  • Provider: A business partner app that manages products on behalf of suppliers. One provider can manage products for multiple suppliers.
  • Supplier: The actual business entity that owns and fulfills the products.
  • Dropshipping: A business model where suppliers fulfill orders directly to customers without Wix store owners handling inventory.
  • Wholesale: A business model where Wix store owners purchase products in bulk at tiered pricing.
  • Direct categories: Categories explicitly assigned to a product.
  • All categories: All categories a product belongs to, including parent and ancestor categories.
  • Price tier: Quantity-based pricing levels for wholesale products. Tiers must be continuous with no gaps.
  • Verified supplier: A supplier that has completed the Marketplace verification process.
Did this help?