API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

Mass create 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": "875",
            "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",
            "description": null,
            "approval_state": "PENDING",
            "is_active": true,
            "status": "PENDING_APPROVAL",
            "policy_review": {
                "reject_reason": null,
                "reject_reason_description": null,
                "status_reason": null,
                "reviewer_notes": null
            },
            "cta": null,
            "creative_focus": {
                "type": "AUTOMATIC",
                "coordinates": null
            },
            "verification_pixel": null,
            "viewability_tag": null,
            "app_install": null,
            "rating": null,
            "logo": null,
            "disclaimer": null,
            "creative_crop": null,
            "external_metadata": null
        },
        {
            "id": "876",
            "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",
            "description": null,
            "approval_state": "PENDING",
            "is_active": true,
            "status": "PENDING_APPROVAL",
            "policy_review": {
                "reject_reason": null,
                "reject_reason_description": null,
                "status_reason": null,
                "reviewer_notes": null
            },
            "cta": null,
            "creative_focus": {
                "type": "AUTOMATIC",
                "coordinates": null
            },
            "verification_pixel": null,
            "viewability_tag": null,
            "app_install": null,
            "rating": null,
            "logo": null,
            "disclaimer": null,
            "creative_crop": null,
            "external_metadata": null
        },
        {
            "id": "877",
            "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",
            "description": null,
            "approval_state": "PENDING",
            "is_active": true,
            "status": "PENDING_APPROVAL",
            "policy_review": {
                "reject_reason": null,
                "reject_reason_description": null,
                "status_reason": null,
                "reviewer_notes": null
            },
            "cta": null,
            "creative_focus": {
                "type": "AUTOMATIC",
                "coordinates": null
            },
            "verification_pixel": null,
            "viewability_tag": null,
            "app_install": null,
            "rating": null,
            "logo": null,
            "disclaimer": null,
            "creative_crop": null,
            "external_metadata": null
        }
    ],
    "metadata": {
        "total": 0,
        "count": 0,
        "static_fields": [],
        "static_total_fields": [],
        "dynamic_fields": null,
        "start_date": null,
        "end_date": null
    }
}

📘

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. cta
  3. creative_focus

🚧

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
Authorization
OAuth2