Managing Sellers

The seller represents the legal person selling products on your platform. The COA API enables you to manage the advertisement of your Sellers.

Adding Sellers

Sellers are not added with the API. Instead, they are automatically added from the Catalog you provided us. In your catalog, you should provide the "sellerName" field on the Sellers' products. Products that don't have these fields provided will not be advertised.

🚧
SellerName is case-sensitive. If your seller has different case, it will be considered as a different Seller.

📘
You can use your internal ID of the seller as SellerName.

The catalog can be updated from the Criteo Product Catalog API or directly from Criteo Management Center.

Removing Sellers

A Seller can be removed by removing its products from the Feed. If you want to stop an advertising a Seller immediately, you can suspend the budgets of its Seller-Campaigns (see "Suspend a budget" section)

Getting Sellers

In order to see the list of sellers that were extracted, you can make the following call:

https://api.criteo.com/legacy/offsite-ads/sellers

[{
   "id" : "1",
   "sellerName": "AHepburn",
},{
   "id" : "2",
   "sellerName": "HBogart"
},{
   "id" : "3",
   "sellerName": "NewTech"
}]

A seller is defined by the following:

sellerName
This corresponds to the sellerId that was specified in the product catalog you provided.

sellerId
This SellerId identifies your seller. It is attributed by our Seller ingestion system.

Filter Parameter	Options	Meaning
`sellerStatus`	Active, Inactive	Return only sellers with a specific status.
`withProducts`	True / False	Return sellers with or without products in the catalog. The default is not to filter on products in the catalog.
`withBudgetStatus`	Archived, Current, Scheduled	Return sellers with any budget having the given state. Default is to not filter on the budget state.
`sellerName`	string	Returns only sellers with the given "sellerName" value.
`advertiserId`	integer	Return sellers for the given advertiser Id. Default is to not filter on advertiser
`campaignId`	integer	Return sellers for the given campaign Id. Default is to not filter on campaign

🚧
There is an enrichment delay of 24 to 48 hours from when a product is placed in the catalog and becomes available.