Skip to main content
POST
Auto-select products

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

id
string
required

Unique identifier for the campaign

Minimum string length: 1
Example:

"cmp_987654321"

Body

application/json

Optional refinement parameters for iterative auto-select product selection. Based on ADCP refine spec.

refine
object[]

Array of refinement directives from a previous auto-select response. Supports request-scoped direction and product-scoped include/omit/more_like_this actions.

Minimum array length: 1

Request-scoped refinement: direction for the overall selection

maxProducts
integer

Maximum number of products to select

Required range: 1 <= x <= 9007199254740991
Example:

5

minBudgetPerProduct
number

Minimum budget to allocate per product

Required range: x > 0
Example:

500

Response

Auto-select products

Response from auto-selecting products for a performance campaign

campaignId
string
required

Campaign ID

discoveryId
string
required

Discovery session ID containing the selected products

selectedProducts
object[]
required

Products selected and added to the discovery session

budgetContext
object
required

Budget allocation summary

productCount
integer
required

Total number of products selected

Required range: 0 <= x <= 9007199254740991
previouslySelectedCount
integer

Number of previously selected products that were replaced by auto-select

Required range: 0 <= x <= 9007199254740991