Bulk create items across campaigns

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

  1. campaign_ids: a collection of Campaign IDs (each ID passed as a Number).
  2. items: a collection of items to create. (These items will be created for each of the above campaigns.)

📘

Required fields (for each item passed)

  1. url
  2. thumbnail_url
  3. title

📘

Optional fields (for each item passed)

  1. description
  2. creative_focus

The cta field 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

  1. To bulk create items, use the PUT verb.
  2. Limit each request to a maximum of 200 items.
  3. Bulk create is always atomic: if the operation fails for 1 item, then no items will be created.
  4. Bulk create is applicable for regular items only - not video items.
  5. 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/bulk

For more information about the network account see: Network Accounts.

📘

See also

Language