Products

Overview

As a seller, you manage your workspace's product catalog through the Partner API. You can bulk import products from your ERP (JSON or CSV), retrieve recently changed products, and update base prices independently.

Endpoints

Method	Endpoint	Description
GET	/v2/partner/{workspaceID}/products	Get products by date range
POST	/v2/partner/{workspaceID}/product	Bulk create/update products
PUT	/v2/partner/{workspaceID}/products/baseprice	Update base prices in bulk

Retrieving Products

Fetch products created or updated within a date range using from and to query parameters (RFC3339 format). Use this to detect catalog changes since your last sync.

Bulk Product Import

Create or update multiple products in a single request. The endpoint accepts both JSON and CSV formats via the Content-Type header.

Key query parameters:

Parameter	Default	Description
language	en	Product language (en, es, fr, de, it, pt, nl)
type	-	Integration type for custom parsing
csvseparator	,	CSV field separator
decimalseparator	.	Decimal separator for numbers

In the bulk JSON request, numeric fields are sent as strings, and multi-value fields (e.g., sale_units, tags) are comma-separated strings.

The response includes both successfully processed products and error messages for any failures.

Base Price Updates

Update prices without sending full product data. Products are matched by sku or ean_code. Supports JSON and CSV formats.

This is faster than a full product sync when only prices have changed.

Integration Workflow

Initial Import

1. Export products from your ERP
2. POST products in bulk (JSON or CSV)
3. Verify by retrieving products with GET

Ongoing Sync

• Schedule regular syncs to keep the catalog current
• Use GET /products with a date range to retrieve only recently changed products
• Use the base price endpoint for price-only updates

CSV vs JSON

Format	Best For
JSON	Programmatic integrations, full control
CSV	ERP exports, spreadsheet-based workflows