Create a batch of items for a given campaign

Create a batch of items for a given campaign (using a single API request).

See also: Bulk create items across campaigns

Example

POST /backstage/api/1.0/demo-advertiser/campaigns/1234/items/mass
{
    "collection": [{
            "url": "https://www.demo-advertiser.com/wedding-rings",
            "thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-1.jpg",
            "title": "The perfect wedding ring"
        },
        {
            "url": "https://www.demo-advertiser.com/proposal-rings",
            "thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
            "title": "Amazing proposal rings"
        },
        {
            "url": "https://www.demo-advertiser.com/medalions",
            "thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
            "title": "Beautiful medallions"
        }
    ]
}
{
    "results": [{
            "id": "317",
            "campaign_id": "1234",
            "type": "ITEM",
            "url": "https://www.demo-advertiser.com/wedding-rings",
            "thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-1.jpg",
            "title": "The perfect wedding ring",
            "approval_state": "PENDING",
            "is_active": true,
            "status": "PENDING_APPROVAL",
            "policy_review": {
                "reject_reason": null
            }
        },
        {
            "id": "318",
            "campaign_id": "1234",
            "type": "ITEM",
            "url": "https://www.demo-advertiser.com/proposal-rings",
            "thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-2.jpg",
            "title": "Amazing proposal rings",
            "approval_state": "PENDING",
            "is_active": true,
            "status": "PENDING_APPROVAL",
            "policy_review": {
                "reject_reason": null
            }
        },
        {
            "id": "319",
            "campaign_id": "1234",
            "type": "ITEM",
            "url": "https://www.demo-advertiser.com/medalions",
            "thumbnail_url": "https://cdn.demo-advertiser.com/thumbnails/thumbnail-3.jpg",
            "title": "Beautiful medallions",
            "approval_state": "PENDING",
            "is_active": true,
            "status": "PENDING_APPROVAL",
            "policy_review": {
                "reject_reason": null
            }
        }
    ],
    "metadata": {
        "total": null,
        "count": null,
        "static_fields": [],
        "static_total_fields": []
    }
}

πŸ“˜

Request Object

  • collection: a collection of items to create.

πŸ“˜

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. Use the items/mass endpoint, with a Campaign ID path param.
  2. The items/mass endpoint is applicable for regular items only - not video items.
  3. The new Items are created with a status of PENDING. Once approved, their status is updated to APPROVED.

πŸ“˜

See also: Bulk create items across campaigns (below).

Language