Saltar para o conteúdo principal
GET
/
public
/
v1
/
catalog-search-service
/
catalogs
/
products
/
{product-id}
Get Product
curl --request GET \
  --url https://api.topsort.com/public/v1/catalog-search-service/catalogs/products/{product-id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "vendors": [
    "<string>"
  ],
  "categories": [
    "<string>"
  ],
  "description": "Named as \"Best Beer in the World\" in 2008 at the World Beer Championships in Chicago, Illinois.",
  "brand": {
    "id": "<string>",
    "name": "<string>"
  },
  "imageURL": "https://cdn.example.com/products/eyGqR4YQgBJa.jpg",
  "price": 18.99,
  "active": true,
  "ean": "4003994155486",
  "quality_score": 0.5,
  "metadata": {},
  "globalId": "PROD-12345"
}

Autorizações

​
Authorization
string
header
obrigatório

A valid API key generated in Topsort's UI.

Parâmetros de caminho

​
product-id
string
obrigatório

The ID of the product to retrieve.

Minimum string length: 1

Resposta

Successful Response

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

​
id
string
obrigatório

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

Minimum string length: 1
Exemplos:

"eyGqR4YQgBJa"

"PROD-548"

"52c8c83c-2f4f-4873-87a0-1ccd88273b27"

​
name
string
obrigatório

Name of the product. Shown in Topsort UI.

Minimum string length: 1
Exemplo:

"Delirium Tremens Beer Bottle 330cc x6"

​
vendors
string[]
obrigatório

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

Exemplo:
["9SiwYqqL8vdG", "BRAND-48795"]
​
categories
string[]
obrigatório

IDs of the categories this product belongs to.

Exemplos:
["ahEDqV5uhjj8"]
["CAT-343", "CAT-456"]
["52c8c83c-2f4f-4873-87a0-1ccd88273b27"]
​
description
string | null

Description of the product.

Minimum string length: 1
Exemplo:

"Named as \"Best Beer in the World\" in 2008 at the World Beer Championships in Chicago, Illinois."

​
brand
Brand · object

Brand information of the product.

​
imageURL
string<uri>

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 string length: 1
Exemplo:

"https://cdn.example.com/products/eyGqR4YQgBJa.jpg"

​
price
number | null

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

Intervalo necessário: x > 0
Exemplo:

18.99

​
active
boolean
padrão: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.

​
ean
string | null

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

Required string length: 13
Exemplo:

"4003994155486"

​
quality_score
number | null

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.

Intervalo necessário: 0 < x <= 1
​
metadata
Metadata · object

Additional metadata for the product.

​
globalId
string | null

Global ID of the product. This is an optional field that can be used to link the product to other marketplaces

Exemplo:

"PROD-12345"