put https://backstage.taboola.com/backstage/api/1.0//items/bulk
Bulk create items across multiple campaigns. The same items will be created for each campaign.
You can also use a network account to bulk create new items across the network.
(This endpoint is applicable for regular items only - not video items.)
See also:
Example
PUT /backstage/api/1.0/demo-advertiser/items/bulk
{
"campaign_ids": [
33,
270,
163
],
"items": [
{
"url": "http://www.demo-advertiser.com/wedding-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thmbnail-1.jpg",
"title": "The perfect wedding ring"
},
{
"url": "http://www.demo-advertiser.com/proposal-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
"title": "Amazing proposal rings"
},
{
"url": "http://www.demo-advertiser.com/medalions",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
"title": "Beautiful medallions"
}
]
}
{
"results": [{
"id": "444",
"campaign_id": "33",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/wedding-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thmbnail-1.jpg",
"title": "The perfect wedding ring",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "445",
"campaign_id": "33",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/proposal-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
"title": "Amazing proposal rings",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "446",
"campaign_id": "33",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/medalions",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
"title": "Beautiful medallions",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "447",
"campaign_id": "270",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/wedding-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thmbnail-1.jpg",
"title": "The perfect wedding ring",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "448",
"campaign_id": "270",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/proposal-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
"title": "Amazing proposal rings",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "449",
"campaign_id": "270",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/medalions",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
"title": "Beautiful medallions",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "450",
"campaign_id": "163",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/wedding-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thmbnail-1.jpg",
"title": "The perfect wedding ring",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "451",
"campaign_id": "163",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/proposal-rings",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
"title": "Amazing proposal rings",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
},
{
"id": "452",
"campaign_id": "163",
"type": "ITEM",
"url": "http://www.demo-advertiser.com/medalions",
"thumbnail_url": "http://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
"title": "Beautiful medallions",
"description": null,
"approval_state": "PENDING",
"is_active": true,
"status": "PENDING_APPROVAL",
"policy_review": {
"reject_reason": null,
"status_reason": null
},
"cta": null,
"creative_focus": {
"type": "AUTOMATIC",
"coordinates": null
}
}
],
"metadata": {
...
}
}
Request Object
campaign_ids: a collection of Campaign IDs (each ID passed as a Number).items: a collection of items to create. (These items will be created for each of the above campaigns.)
Required fields (for each item passed)
Optional fields (for each item passed)
The
ctafield is not supported. If passed, the endpoint will return 400.
URL is not crawled
The endpoint saves the above values without crawling the URL. Make sure that the values passed are acceptable to Taboola.
Guidelines
- To bulk create items, use the PUT verb.
- Limit each request to a maximum of 200 items.
- Bulk create is always atomic: if the operation fails for 1 item, then no items will be created.
- Bulk create is applicable for regular items only - not video items.
- The new Items are created with a status of PENDING. Once approved, their status is updated to APPROVED.
The network account
You can use a network account to create items across the network:
PUT backstage/api/1.0/{network-account}/items/bulkFor more information about the network account see: Network Accounts.
See also