Add products to selection
curl --request POST \
--url https://api.apostra.com/api/v2/buyer/discovery/{discoveryId}/products \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"products": [
{
"productId": "product_123",
"storefrontId": "<string>",
"inventorySourceId": "<string>",
"selectionId": "product_123::a1b2c3",
"salesAgentId": "agent_456",
"groupId": "ctx_123-group-0",
"groupName": "Publisher Name",
"channelGroupId": "<string>",
"bidPrice": 12.5,
"budget": 5000,
"pricingOptionId": "po_abc123",
"targetingOverlay": {
"geo_countries": [
"<string>"
],
"geo_countries_exclude": [
"<string>"
],
"geo_regions": [
"<string>"
],
"geo_regions_exclude": [
"<string>"
],
"geo_metros": [
{
"values": [
"<string>"
]
}
],
"geo_metros_exclude": [
{
"values": [
"<string>"
]
}
],
"geo_postal_areas": [
{
"country": "US",
"values": [
"<string>"
]
}
],
"geo_postal_areas_exclude": [
{
"country": "US",
"values": [
"<string>"
]
}
],
"daypart_targets": [
{
"days": [],
"start_hour": 11,
"end_hour": 12,
"start_time": "<string>",
"end_time": "<string>",
"timezone": "inventory_local",
"label": "<string>"
}
],
"axe_include_segment": "<string>",
"axe_exclude_segment": "<string>",
"audience_include": [
"<string>"
],
"audience_exclude": [
"<string>"
],
"signal_targeting": [
"<unknown>"
],
"demographics": {
"age": {
"min": 75,
"include_unknown": true,
"max": 75,
"accepted_bases": [],
"accepted_verification_methods": []
}
},
"frequency_cap": {
"suppress": {
"interval": 4503599627370496
},
"suppress_minutes": 1,
"max_impressions": 4503599627370496
},
"collection_lists": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"collection_lists_exclude": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"placement_selection": {},
"collection_selection": {},
"device_platform": [],
"device_platform_exclude": [],
"device_type": [],
"device_type_exclude": [],
"browser": [],
"browser_exclude": [],
"store_catchments": [
{
"catalog_id": "<string>",
"store_ids": [
"<string>"
],
"catchment_ids": [
"<string>"
]
}
],
"geo_proximity": [
{
"lat": 0,
"lng": 0,
"label": "<string>",
"ext": {}
}
],
"language": [
"<string>"
],
"keyword_targets": [
{
"keyword": "<string>",
"bid_price": 1
}
],
"negative_keywords": [
{
"keyword": "<string>"
}
],
"product_codes": [
"<string>"
]
},
"performanceStandards": [
{
"threshold": 0.5
}
],
"pageId": "1147910135081908",
"pixelId": "123456789012345",
"instagramActorId": "17841400000000000",
"welcomeMessageFlowId": "1122334455667788",
"leadFormId": "987654321098765",
"appId": "1827364556677889",
"optimizationGoals": [
{
"kind": "metric",
"metric": "clicks",
"standard": "mrc",
"reach_unit": "individuals",
"view_duration_seconds": 1,
"target": {
"kind": "cost_per",
"value": 1
},
"priority": 4503599627370496
}
]
}
]
}
'import requests
url = "https://api.apostra.com/api/v2/buyer/discovery/{discoveryId}/products"
payload = { "products": [
{
"productId": "product_123",
"storefrontId": "<string>",
"inventorySourceId": "<string>",
"selectionId": "product_123::a1b2c3",
"salesAgentId": "agent_456",
"groupId": "ctx_123-group-0",
"groupName": "Publisher Name",
"channelGroupId": "<string>",
"bidPrice": 12.5,
"budget": 5000,
"pricingOptionId": "po_abc123",
"targetingOverlay": {
"geo_countries": ["<string>"],
"geo_countries_exclude": ["<string>"],
"geo_regions": ["<string>"],
"geo_regions_exclude": ["<string>"],
"geo_metros": [{ "values": ["<string>"] }],
"geo_metros_exclude": [{ "values": ["<string>"] }],
"geo_postal_areas": [
{
"country": "US",
"values": ["<string>"]
}
],
"geo_postal_areas_exclude": [
{
"country": "US",
"values": ["<string>"]
}
],
"daypart_targets": [
{
"days": [],
"start_hour": 11,
"end_hour": 12,
"start_time": "<string>",
"end_time": "<string>",
"timezone": "inventory_local",
"label": "<string>"
}
],
"axe_include_segment": "<string>",
"axe_exclude_segment": "<string>",
"audience_include": ["<string>"],
"audience_exclude": ["<string>"],
"signal_targeting": ["<unknown>"],
"demographics": { "age": {
"min": 75,
"include_unknown": True,
"max": 75,
"accepted_bases": [],
"accepted_verification_methods": []
} },
"frequency_cap": {
"suppress": { "interval": 4503599627370496 },
"suppress_minutes": 1,
"max_impressions": 4503599627370496
},
"collection_lists": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"collection_lists_exclude": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"placement_selection": {},
"collection_selection": {},
"device_platform": [],
"device_platform_exclude": [],
"device_type": [],
"device_type_exclude": [],
"browser": [],
"browser_exclude": [],
"store_catchments": [
{
"catalog_id": "<string>",
"store_ids": ["<string>"],
"catchment_ids": ["<string>"]
}
],
"geo_proximity": [
{
"lat": 0,
"lng": 0,
"label": "<string>",
"ext": {}
}
],
"language": ["<string>"],
"keyword_targets": [
{
"keyword": "<string>",
"bid_price": 1
}
],
"negative_keywords": [{ "keyword": "<string>" }],
"product_codes": ["<string>"]
},
"performanceStandards": [{ "threshold": 0.5 }],
"pageId": "1147910135081908",
"pixelId": "123456789012345",
"instagramActorId": "17841400000000000",
"welcomeMessageFlowId": "1122334455667788",
"leadFormId": "987654321098765",
"appId": "1827364556677889",
"optimizationGoals": [
{
"kind": "metric",
"metric": "clicks",
"standard": "mrc",
"reach_unit": "individuals",
"view_duration_seconds": 1,
"target": {
"kind": "cost_per",
"value": 1
},
"priority": 4503599627370496
}
]
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
products: [
{
productId: 'product_123',
storefrontId: '<string>',
inventorySourceId: '<string>',
selectionId: 'product_123::a1b2c3',
salesAgentId: 'agent_456',
groupId: 'ctx_123-group-0',
groupName: 'Publisher Name',
channelGroupId: '<string>',
bidPrice: 12.5,
budget: 5000,
pricingOptionId: 'po_abc123',
targetingOverlay: {
geo_countries: ['<string>'],
geo_countries_exclude: ['<string>'],
geo_regions: ['<string>'],
geo_regions_exclude: ['<string>'],
geo_metros: [{values: ['<string>']}],
geo_metros_exclude: [{values: ['<string>']}],
geo_postal_areas: [{country: 'US', values: ['<string>']}],
geo_postal_areas_exclude: [{country: 'US', values: ['<string>']}],
daypart_targets: [
{
days: [],
start_hour: 11,
end_hour: 12,
start_time: '<string>',
end_time: '<string>',
timezone: 'inventory_local',
label: '<string>'
}
],
axe_include_segment: '<string>',
axe_exclude_segment: '<string>',
audience_include: ['<string>'],
audience_exclude: ['<string>'],
signal_targeting: ['<unknown>'],
demographics: {
age: {
min: 75,
include_unknown: true,
max: 75,
accepted_bases: [],
accepted_verification_methods: []
}
},
frequency_cap: {
suppress: {interval: 4503599627370496},
suppress_minutes: 1,
max_impressions: 4503599627370496
},
collection_lists: [{agent_url: '<string>', list_id: '<string>', auth_token: '<string>'}],
collection_lists_exclude: [{agent_url: '<string>', list_id: '<string>', auth_token: '<string>'}],
placement_selection: {},
collection_selection: {},
device_platform: [],
device_platform_exclude: [],
device_type: [],
device_type_exclude: [],
browser: [],
browser_exclude: [],
store_catchments: [{catalog_id: '<string>', store_ids: ['<string>'], catchment_ids: ['<string>']}],
geo_proximity: [{lat: 0, lng: 0, label: '<string>', ext: {}}],
language: ['<string>'],
keyword_targets: [{keyword: '<string>', bid_price: 1}],
negative_keywords: [{keyword: '<string>'}],
product_codes: ['<string>']
},
performanceStandards: [{threshold: 0.5}],
pageId: '1147910135081908',
pixelId: '123456789012345',
instagramActorId: '17841400000000000',
welcomeMessageFlowId: '1122334455667788',
leadFormId: '987654321098765',
appId: '1827364556677889',
optimizationGoals: [
{
kind: 'metric',
metric: 'clicks',
standard: 'mrc',
reach_unit: 'individuals',
view_duration_seconds: 1,
target: {kind: 'cost_per', value: 1},
priority: 4503599627370496
}
]
}
]
})
};
fetch('https://api.apostra.com/api/v2/buyer/discovery/{discoveryId}/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"discoveryId": "<string>",
"products": [
{
"productId": "<string>",
"salesAgentId": "<string>",
"selectedAt": "<string>",
"groupId": "<string>",
"groupName": "<string>",
"storefrontId": "<string>",
"inventorySourceId": "<string>",
"selectionId": "<string>",
"bidPrice": 123,
"budget": 123,
"targetingOverlay": {
"geo_countries": [
"<string>"
],
"geo_countries_exclude": [
"<string>"
],
"geo_regions": [
"<string>"
],
"geo_regions_exclude": [
"<string>"
],
"geo_metros": [
{
"system": "nielsen_dma",
"values": [
"<string>"
]
}
],
"geo_metros_exclude": [
{
"system": "nielsen_dma",
"values": [
"<string>"
]
}
],
"geo_postal_areas": [
{
"country": "US",
"system": "zip",
"values": [
"<string>"
]
}
],
"geo_postal_areas_exclude": [
{
"country": "US",
"system": "zip",
"values": [
"<string>"
]
}
],
"daypart_targets": [
{
"days": [
"monday"
],
"timezone": "inventory_local",
"start_hour": 11,
"end_hour": 12,
"start_time": "<string>",
"end_time": "<string>",
"label": "<string>"
}
],
"axe_include_segment": "<string>",
"axe_exclude_segment": "<string>",
"audience_include": [
"<string>"
],
"audience_exclude": [
"<string>"
],
"signal_targeting_groups": {
"operator": "all",
"groups": [
{
"operator": "any",
"signals": [
{
"pricing_option_id": "<string>",
"signal_agent_segment_id": "<string>",
"activation_key": {}
}
]
}
]
},
"signal_targeting": [
"<unknown>"
],
"demographics": {
"age": {
"min": 75,
"include_unknown": true,
"max": 75,
"accepted_bases": [
"verified"
],
"accepted_verification_methods": [
"facial_age_estimation"
]
},
"gender": {
"values": [
"female"
],
"include_unknown": true
}
},
"frequency_cap": {
"suppress": {
"interval": 4503599627370496,
"unit": "seconds"
},
"suppress_minutes": 1,
"max_impressions": 4503599627370496,
"per": "individuals",
"window": {
"interval": 4503599627370496,
"unit": "seconds"
}
},
"property_list": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"property_list_exclude": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"collection_list": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"collection_list_exclude": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"collection_lists": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"collection_lists_exclude": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"placement_selection": {},
"collection_selection": {},
"age_restriction": {
"min": 56,
"verification_required": false,
"accepted_methods": [
"facial_age_estimation"
]
},
"device_platform": [
"ios"
],
"device_platform_exclude": [
"ios"
],
"device_type": [
"desktop"
],
"device_type_exclude": [
"desktop"
],
"browser": [
"chrome"
],
"browser_exclude": [
"chrome"
],
"store_catchments": [
{
"catalog_id": "<string>",
"store_ids": [
"<string>"
],
"catchment_ids": [
"<string>"
]
}
],
"geo_proximity": [
{
"lat": 0,
"lng": 0,
"label": "<string>",
"travel_time": {
"value": 2,
"unit": "min"
},
"transport_mode": "walking",
"radius": {
"value": 1,
"unit": "km"
},
"geometry": {
"type": "Polygon",
"coordinates": [
"<unknown>"
]
},
"ext": {}
}
],
"language": [
"<string>"
],
"keyword_targets": [
{
"keyword": "<string>",
"match_type": "broad",
"bid_price": 1
}
],
"negative_keywords": [
{
"keyword": "<string>",
"match_type": "broad"
}
],
"product_codes": [
"<string>"
]
},
"channelGroupId": "<string>"
}
],
"totalProducts": 0,
"selectionSummary": "<string>",
"budgetContext": {
"sessionBudget": 123,
"allocatedBudget": 123,
"remainingBudget": 123,
"budgetWarning": "<string>"
},
"campaignBound": true,
"campaignWarning": "<string>",
"warnings": [
"<string>"
]
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Product Discovery
Add products to selection
Add products to the selection. Products must have been discovered via GET /discovery//discover-products first.
POST
/
discovery
/
{discoveryId}
/
products
Add products to selection
curl --request POST \
--url https://api.apostra.com/api/v2/buyer/discovery/{discoveryId}/products \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"products": [
{
"productId": "product_123",
"storefrontId": "<string>",
"inventorySourceId": "<string>",
"selectionId": "product_123::a1b2c3",
"salesAgentId": "agent_456",
"groupId": "ctx_123-group-0",
"groupName": "Publisher Name",
"channelGroupId": "<string>",
"bidPrice": 12.5,
"budget": 5000,
"pricingOptionId": "po_abc123",
"targetingOverlay": {
"geo_countries": [
"<string>"
],
"geo_countries_exclude": [
"<string>"
],
"geo_regions": [
"<string>"
],
"geo_regions_exclude": [
"<string>"
],
"geo_metros": [
{
"values": [
"<string>"
]
}
],
"geo_metros_exclude": [
{
"values": [
"<string>"
]
}
],
"geo_postal_areas": [
{
"country": "US",
"values": [
"<string>"
]
}
],
"geo_postal_areas_exclude": [
{
"country": "US",
"values": [
"<string>"
]
}
],
"daypart_targets": [
{
"days": [],
"start_hour": 11,
"end_hour": 12,
"start_time": "<string>",
"end_time": "<string>",
"timezone": "inventory_local",
"label": "<string>"
}
],
"axe_include_segment": "<string>",
"axe_exclude_segment": "<string>",
"audience_include": [
"<string>"
],
"audience_exclude": [
"<string>"
],
"signal_targeting": [
"<unknown>"
],
"demographics": {
"age": {
"min": 75,
"include_unknown": true,
"max": 75,
"accepted_bases": [],
"accepted_verification_methods": []
}
},
"frequency_cap": {
"suppress": {
"interval": 4503599627370496
},
"suppress_minutes": 1,
"max_impressions": 4503599627370496
},
"collection_lists": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"collection_lists_exclude": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"placement_selection": {},
"collection_selection": {},
"device_platform": [],
"device_platform_exclude": [],
"device_type": [],
"device_type_exclude": [],
"browser": [],
"browser_exclude": [],
"store_catchments": [
{
"catalog_id": "<string>",
"store_ids": [
"<string>"
],
"catchment_ids": [
"<string>"
]
}
],
"geo_proximity": [
{
"lat": 0,
"lng": 0,
"label": "<string>",
"ext": {}
}
],
"language": [
"<string>"
],
"keyword_targets": [
{
"keyword": "<string>",
"bid_price": 1
}
],
"negative_keywords": [
{
"keyword": "<string>"
}
],
"product_codes": [
"<string>"
]
},
"performanceStandards": [
{
"threshold": 0.5
}
],
"pageId": "1147910135081908",
"pixelId": "123456789012345",
"instagramActorId": "17841400000000000",
"welcomeMessageFlowId": "1122334455667788",
"leadFormId": "987654321098765",
"appId": "1827364556677889",
"optimizationGoals": [
{
"kind": "metric",
"metric": "clicks",
"standard": "mrc",
"reach_unit": "individuals",
"view_duration_seconds": 1,
"target": {
"kind": "cost_per",
"value": 1
},
"priority": 4503599627370496
}
]
}
]
}
'import requests
url = "https://api.apostra.com/api/v2/buyer/discovery/{discoveryId}/products"
payload = { "products": [
{
"productId": "product_123",
"storefrontId": "<string>",
"inventorySourceId": "<string>",
"selectionId": "product_123::a1b2c3",
"salesAgentId": "agent_456",
"groupId": "ctx_123-group-0",
"groupName": "Publisher Name",
"channelGroupId": "<string>",
"bidPrice": 12.5,
"budget": 5000,
"pricingOptionId": "po_abc123",
"targetingOverlay": {
"geo_countries": ["<string>"],
"geo_countries_exclude": ["<string>"],
"geo_regions": ["<string>"],
"geo_regions_exclude": ["<string>"],
"geo_metros": [{ "values": ["<string>"] }],
"geo_metros_exclude": [{ "values": ["<string>"] }],
"geo_postal_areas": [
{
"country": "US",
"values": ["<string>"]
}
],
"geo_postal_areas_exclude": [
{
"country": "US",
"values": ["<string>"]
}
],
"daypart_targets": [
{
"days": [],
"start_hour": 11,
"end_hour": 12,
"start_time": "<string>",
"end_time": "<string>",
"timezone": "inventory_local",
"label": "<string>"
}
],
"axe_include_segment": "<string>",
"axe_exclude_segment": "<string>",
"audience_include": ["<string>"],
"audience_exclude": ["<string>"],
"signal_targeting": ["<unknown>"],
"demographics": { "age": {
"min": 75,
"include_unknown": True,
"max": 75,
"accepted_bases": [],
"accepted_verification_methods": []
} },
"frequency_cap": {
"suppress": { "interval": 4503599627370496 },
"suppress_minutes": 1,
"max_impressions": 4503599627370496
},
"collection_lists": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"collection_lists_exclude": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"placement_selection": {},
"collection_selection": {},
"device_platform": [],
"device_platform_exclude": [],
"device_type": [],
"device_type_exclude": [],
"browser": [],
"browser_exclude": [],
"store_catchments": [
{
"catalog_id": "<string>",
"store_ids": ["<string>"],
"catchment_ids": ["<string>"]
}
],
"geo_proximity": [
{
"lat": 0,
"lng": 0,
"label": "<string>",
"ext": {}
}
],
"language": ["<string>"],
"keyword_targets": [
{
"keyword": "<string>",
"bid_price": 1
}
],
"negative_keywords": [{ "keyword": "<string>" }],
"product_codes": ["<string>"]
},
"performanceStandards": [{ "threshold": 0.5 }],
"pageId": "1147910135081908",
"pixelId": "123456789012345",
"instagramActorId": "17841400000000000",
"welcomeMessageFlowId": "1122334455667788",
"leadFormId": "987654321098765",
"appId": "1827364556677889",
"optimizationGoals": [
{
"kind": "metric",
"metric": "clicks",
"standard": "mrc",
"reach_unit": "individuals",
"view_duration_seconds": 1,
"target": {
"kind": "cost_per",
"value": 1
},
"priority": 4503599627370496
}
]
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
products: [
{
productId: 'product_123',
storefrontId: '<string>',
inventorySourceId: '<string>',
selectionId: 'product_123::a1b2c3',
salesAgentId: 'agent_456',
groupId: 'ctx_123-group-0',
groupName: 'Publisher Name',
channelGroupId: '<string>',
bidPrice: 12.5,
budget: 5000,
pricingOptionId: 'po_abc123',
targetingOverlay: {
geo_countries: ['<string>'],
geo_countries_exclude: ['<string>'],
geo_regions: ['<string>'],
geo_regions_exclude: ['<string>'],
geo_metros: [{values: ['<string>']}],
geo_metros_exclude: [{values: ['<string>']}],
geo_postal_areas: [{country: 'US', values: ['<string>']}],
geo_postal_areas_exclude: [{country: 'US', values: ['<string>']}],
daypart_targets: [
{
days: [],
start_hour: 11,
end_hour: 12,
start_time: '<string>',
end_time: '<string>',
timezone: 'inventory_local',
label: '<string>'
}
],
axe_include_segment: '<string>',
axe_exclude_segment: '<string>',
audience_include: ['<string>'],
audience_exclude: ['<string>'],
signal_targeting: ['<unknown>'],
demographics: {
age: {
min: 75,
include_unknown: true,
max: 75,
accepted_bases: [],
accepted_verification_methods: []
}
},
frequency_cap: {
suppress: {interval: 4503599627370496},
suppress_minutes: 1,
max_impressions: 4503599627370496
},
collection_lists: [{agent_url: '<string>', list_id: '<string>', auth_token: '<string>'}],
collection_lists_exclude: [{agent_url: '<string>', list_id: '<string>', auth_token: '<string>'}],
placement_selection: {},
collection_selection: {},
device_platform: [],
device_platform_exclude: [],
device_type: [],
device_type_exclude: [],
browser: [],
browser_exclude: [],
store_catchments: [{catalog_id: '<string>', store_ids: ['<string>'], catchment_ids: ['<string>']}],
geo_proximity: [{lat: 0, lng: 0, label: '<string>', ext: {}}],
language: ['<string>'],
keyword_targets: [{keyword: '<string>', bid_price: 1}],
negative_keywords: [{keyword: '<string>'}],
product_codes: ['<string>']
},
performanceStandards: [{threshold: 0.5}],
pageId: '1147910135081908',
pixelId: '123456789012345',
instagramActorId: '17841400000000000',
welcomeMessageFlowId: '1122334455667788',
leadFormId: '987654321098765',
appId: '1827364556677889',
optimizationGoals: [
{
kind: 'metric',
metric: 'clicks',
standard: 'mrc',
reach_unit: 'individuals',
view_duration_seconds: 1,
target: {kind: 'cost_per', value: 1},
priority: 4503599627370496
}
]
}
]
})
};
fetch('https://api.apostra.com/api/v2/buyer/discovery/{discoveryId}/products', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"discoveryId": "<string>",
"products": [
{
"productId": "<string>",
"salesAgentId": "<string>",
"selectedAt": "<string>",
"groupId": "<string>",
"groupName": "<string>",
"storefrontId": "<string>",
"inventorySourceId": "<string>",
"selectionId": "<string>",
"bidPrice": 123,
"budget": 123,
"targetingOverlay": {
"geo_countries": [
"<string>"
],
"geo_countries_exclude": [
"<string>"
],
"geo_regions": [
"<string>"
],
"geo_regions_exclude": [
"<string>"
],
"geo_metros": [
{
"system": "nielsen_dma",
"values": [
"<string>"
]
}
],
"geo_metros_exclude": [
{
"system": "nielsen_dma",
"values": [
"<string>"
]
}
],
"geo_postal_areas": [
{
"country": "US",
"system": "zip",
"values": [
"<string>"
]
}
],
"geo_postal_areas_exclude": [
{
"country": "US",
"system": "zip",
"values": [
"<string>"
]
}
],
"daypart_targets": [
{
"days": [
"monday"
],
"timezone": "inventory_local",
"start_hour": 11,
"end_hour": 12,
"start_time": "<string>",
"end_time": "<string>",
"label": "<string>"
}
],
"axe_include_segment": "<string>",
"axe_exclude_segment": "<string>",
"audience_include": [
"<string>"
],
"audience_exclude": [
"<string>"
],
"signal_targeting_groups": {
"operator": "all",
"groups": [
{
"operator": "any",
"signals": [
{
"pricing_option_id": "<string>",
"signal_agent_segment_id": "<string>",
"activation_key": {}
}
]
}
]
},
"signal_targeting": [
"<unknown>"
],
"demographics": {
"age": {
"min": 75,
"include_unknown": true,
"max": 75,
"accepted_bases": [
"verified"
],
"accepted_verification_methods": [
"facial_age_estimation"
]
},
"gender": {
"values": [
"female"
],
"include_unknown": true
}
},
"frequency_cap": {
"suppress": {
"interval": 4503599627370496,
"unit": "seconds"
},
"suppress_minutes": 1,
"max_impressions": 4503599627370496,
"per": "individuals",
"window": {
"interval": 4503599627370496,
"unit": "seconds"
}
},
"property_list": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"property_list_exclude": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"collection_list": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"collection_list_exclude": {
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
},
"collection_lists": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"collection_lists_exclude": [
{
"agent_url": "<string>",
"list_id": "<string>",
"auth_token": "<string>"
}
],
"placement_selection": {},
"collection_selection": {},
"age_restriction": {
"min": 56,
"verification_required": false,
"accepted_methods": [
"facial_age_estimation"
]
},
"device_platform": [
"ios"
],
"device_platform_exclude": [
"ios"
],
"device_type": [
"desktop"
],
"device_type_exclude": [
"desktop"
],
"browser": [
"chrome"
],
"browser_exclude": [
"chrome"
],
"store_catchments": [
{
"catalog_id": "<string>",
"store_ids": [
"<string>"
],
"catchment_ids": [
"<string>"
]
}
],
"geo_proximity": [
{
"lat": 0,
"lng": 0,
"label": "<string>",
"travel_time": {
"value": 2,
"unit": "min"
},
"transport_mode": "walking",
"radius": {
"value": 1,
"unit": "km"
},
"geometry": {
"type": "Polygon",
"coordinates": [
"<unknown>"
]
},
"ext": {}
}
],
"language": [
"<string>"
],
"keyword_targets": [
{
"keyword": "<string>",
"match_type": "broad",
"bid_price": 1
}
],
"negative_keywords": [
{
"keyword": "<string>",
"match_type": "broad"
}
],
"product_codes": [
"<string>"
]
},
"channelGroupId": "<string>"
}
],
"totalProducts": 0,
"selectionSummary": "<string>",
"budgetContext": {
"sessionBudget": 123,
"allocatedBudget": 123,
"remainingBudget": 123,
"budgetWarning": "<string>"
},
"campaignBound": true,
"campaignWarning": "<string>",
"warnings": [
"<string>"
]
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Path Parameters
Discovery ID
Minimum string length:
1Example:
"abc123-def456-ghi789"
Body
application/json
Request to add products to a discovery session
Products to add to the selection
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
When true, replaces all existing products instead of merging
Optional campaign association check. When provided, the server verifies this discovery session is attached to the campaign before reporting success.
Example:
"campaign_ea5e33dd-d65b-44c7-a3e8-8e1db1d137b4"
Response
Add products to selection
Response containing the selected-products cart. It does not return discovery results.
Discovery ID
Selected products in the discovery session
Show child attributes
Show child attributes
Total number of products in the selected-products cart. A value of 0 means no product has been selected yet; it is not the number of products discovery returned.
Required range:
-9007199254740991 <= x <= 9007199254740991Plain-language explanation that this response is the selected-products cart, not the discovery result set.
Budget allocation context
Show child attributes
Show child attributes
Whether this discovery session is attached to an active campaign. When false, the products are saved to the session but no active campaign reflects them yet.
Guidance shown only when campaignBound is false: either the session is not attached to any campaign, or the campaign it was attached to has been archived. Pass campaignId for an active campaign (or restore the archived one) so the campaign reflects the products.
Non-blocking notices about this submission, e.g. two submitted selections shared the same identity (no selectionId, or a repeated selectionId) and were merged into a single package.