Adding Products (Adverts)
For sellers new to the Marketplacer Seller API, it’s helpful to first create a product manually in the Seller Portal. This provides a clear view of the required fields and how products (adverts) are structured in Marketplacer. For detailed instructions on manually creating products in Seller portal, refer to this article.
Product Details
When adding a product, sellers must ensure the product information matches the fields and configurations defined in your marketplace. At minimum, each product must include:
- Title
- Description
- Category (known as a Taxon in the API)
- Brand
- Price (Base, Sale, From, etc.)
- Availability
Marketplacer’s product model has a structured hierarchy that defines how products, variants, and features interact. Understanding this structure is essential for accurately building or uploading products via the API.
Product Structure
In Marketplacer, each product is defined by several key elements that determine how it is displayed and managed across your marketplace:
| Element | Description | Examples |
|---|---|---|
| Category | The main grouping a product belongs to. Subcategories may also exist. | Headphones > Gaming, Headphones > Kids, Dinnerware, Apparel |
| Prototype | A predefined combination of variants and features that defines the structure of a product type. | T-shirt Prototype = Size + Color + Material |
| Variant | A specific product attribute that distinguishes one version of a product from another. | Size, Color, Flavor, Alcohol Content |
| Variant Option Types | The available options for each variant. | Color > Blue, Black, Red |
| Feature | A general characteristic that applies to the product as a whole. | Portable, Delivery Type, Battery Powered |
| Feature Option Types | The available options for each feature. | Delivery Type > Courier, Pickup |
Related articles