The Constructor REST API includes an endpoint that allows customers to transfer catalogs to the Constructor product discovery platform for easier and faster integration. The endpoint supports both full transfers (syncs) and updates (deltas) at whatever time intervals are convenient for customers. Full developer documentation is here.

File format

The catalog REST endpoints accept UTF-8 encoded CSV files in the format described in our feed documentation.

• CSV feed format - items (products) - defined within an items.csv file
  Products shown as results on product listing pages (search, browse)
• CSV feed format - variations - optionally defined within a variations.csv file
  Not all product catalogs have variations. Variations refer to child items that can be shown as swatches of top level results on product listing pages
• CSV feed format - item groups (categories) - defined within an item_groups.csv file
  Hierarchy definition of groups for organizing products

Full catalog transfers

Full catalog transfers (or syncs) create or replace an entire product catalog in Constructor's system, and are supported via an HTTP PUT request.

Partial catalog transfers

Partial catalog transfers (or deltas) update specific items within a product catalog, and are supported via an HTTP PATCH request.