GET
/
public
/
v1
/
catalog-search-service
/
catalogs
/
products
/
{product-id}

Path Parameters

product-id
string
required

The ID of the product to retrieve.

Minimum length: 1

Response

200 - application/json

A product is the minimum unit that can be sold within a marketplace catalog.

categories
string[]
required

IDs of the categories this product belongs to.

id
string
required

Unique ID of the product. Topsort treats IDs as strings, choose any format as long as it is unique within the catalog.

Minimum length: 1
name
string
required

Name of the product. Shown in Topsort UI.

Minimum length: 1
vendors
string[]
required

IDs of the vendors that can promote this product in campaigns.

active
boolean
default: true

Flag that indicates whether this product is active. Only active products can take part in campaigns and auctions. Set this value to false to deactivate a product. When a product is deactivated it will be removed from active campaigns. We advise to set this flag to false when a product is out of stock. Note: Active products being upserted will be added to existing campaigns created through the Building Blocks service using the Promote My Shop feature.

brand
object

Brand information of the product.

description
string

Description of the product.

Minimum length: 1
ean
string

European Article Number. Formatted as a thirteen digit EAN-13 code.

Required string length: 13
imageURL
string

URL of the product image. This image will be displayed in the Topsort UI. Image dimensions between 250x250 and 600x600 pixels are recommended for the best performance of the Topsort UI.

Minimum length: 1
metadata
object

Additional metadata for the product.

price
number

Price of the product in the currency configured in the marketplace.

Required range: x > 0
quality_score
number

Marketplace's internal quality score for the product. This in an optional advanced use case, for which we can provide some insights. Examples of metrics include the product's rating, conversion rate, click through rate, combination of other metrics, etc.

Required range: 0 < x < 1