Managing Sellers - Criteo Docs

Introduction

The seller represents the legal person selling products on your platform. The MPO 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 Commerce Growth Dashboard.

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

This endpoint returns the list of sellers that was extracted. Sample response

JSON

[{
   "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.

Parameter	Definition	Type	Required?
Return sellers for the given advertiser Id. Default is to not filter on advertiser	No
Return sellers for the given campaign Id. Default is to not filter on campaign	No
No
Active**.	No
Scheduled**	No
Return sellers with or without products in the catalog. The default is not to filter on products in the catalog.	No

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

Get Specific Seller

You can also fetch the details of a single Seller using the following endpoint: Sample response

{
  "id": "123456",
  "sellerName": "HBogart"
}

Get a Collection of Budgets for Selected Seller

The following endpoint retrieves a list of budgets for a specific seller, applying any optional filters provided as a query parameters.
If no filters are given, return all budgets the user can access, excluding those with an endDate in the past.
When multiple filters are used, only budgets that meet all the specified criteria are returned.
For more information, refer to the budgets endpoint documentation. Sample response

[
  {
    "id": "123456",
    "sellerId": "123456",
    "campaignIds": [
      123532
    ],
    "budgetType": "Daily",
    "amount": 12.0000,
    "startDate": "2021-02-25",
    "endDate": "Never",
    "spend": null,
    "status": "Current",
    "isSuspended": false
  }
]

You can apply the following query parameters to the endpoint to specify filters:

Parameter	Definition	Type	Required?
Filters budgets to those owned by the specified seller.	Yes
Filters budgets to those funding the specified campaign.	No
No
No
Scheduled**.	No
Filters budgets by the specified budget type.	No
Returns only budgets that currently have a remaining balance.	No
Returns budgets that have a positive spend amount.	No

Get a Collection of Campaigns for Selected Seller

The following endpoint returns a list of seller campaigns for the specified seller, applying any optional filters provided. If no filters are given, it returns the full collection accessible to the user.
When multiple filters are used, only campaigns meeting all filter criteria are included.
For more information, see the seller campaigns endpoint documentation. Sample response

[
  {
    "id": "10624700.225662",
    "sellerId": "10624700",
    "campaignId": 225662,
    "bid": null,
    "suspendedSince": "2021-03-07T23:06:15.17",
    "suspensionReasons": [
      "NoBudgetDefined"
    ]
  }
]

You can apply the following query parameters to the endpoint to specify filters:

Parameter	Definition	Type	Required?
Limits results to campaigns belonging to the specified seller.	Yes
Scheduled**.	No
Filters campaigns linked to the specified campaign ID.	No
Active**.	No

​Introduction

​Adding Sellers

​Removing Sellers

​Getting Sellers

​Get Specific Seller

​Get a Collection of Budgets for Selected Seller

​Get a Collection of Campaigns for Selected Seller

Introduction

Adding Sellers

Removing Sellers

Getting Sellers

Get Specific Seller

Get a Collection of Budgets for Selected Seller

Get a Collection of Campaigns for Selected Seller