An item is a social media post managed through the Publisher API. An item can be a published post, a scheduled post, or a draft, as indicated by its status, and it targets a single connected social channel such as Instagram, Facebook, or TikTok.
Social channel the item is published to, and the account within that channel.
Identifies what created the item.
Specify consumerInfo.name when you create or publish an item, using one stable name for whatever is
making the call, whether that's an app, an AI agent, or a service of your own. An item created without
it is stored with an empty name, and the name can't be added later, because Update Item doesn't change
it. See
Identifying what created an item.
Facebook post content.
Facebook reel content.
Facebook story content.
Google Business Profile post content.
Instagram post content.
Instagram story content.
LinkedIn post content.
Pinterest post content.
TikTok photo content.
TikTok video content.
Deprecated: No longer functional as of July 31, 2026. X (Twitter) post content.
YouTube short content.
YouTube video content.
Creation and update dates, returned for draft items.
Whether the item is a post created natively on the social channel rather than published through Wix.
Item ID.
Summary of the post's performance on the social channel, such as impressions and interactions.
ID of the item this item was derived from, when publishing produced several items
from one. Currently set only by PublishMultiStoryDraft, which splits a multi-media
story draft into one published item per frame: every resulting item carries the
originating draft's ID here. Lets a consumer re-correlate the new items with whatever
it had recorded against the original draft, which no longer exists after the split.
Set by the publisher, never by the caller.
Details of why the item failed to publish. Returned only when status is FAILED.
Date and time the item was published. Returned only after the item is published.
Caller-defined reference that uniquely identifies the item. Can be used to prevent duplicate publishing: an attempt to publish a second item with the same referenceId fails. Can also be used as a UTM campaign ID.
Scheduling info. Set to schedule the item for a future date instead of publishing it immediately.
Aggregated analytics for the site, attributed to traffic from this post.
Reference to the site content the post promotes, such as a product, a blog post, or an event. Set per channel.
Current status of the item in its lifecycle.
Whether the item was generated as an AI suggestion.
Item format. The type and the content set in data must match a combination supported by the item's channel.name:
POST with instagramPost, or STORY with instagramStory.POST with facebookPost, REEL with facebookReel, or STORY with facebookStory.VIDEO with youtubeVideo, or SHORT with youtubeShort.POST with linkedinPost.POST with twitterPost. Deprecated: No longer functional as of July 31, 2026.POST with pinterestPost.POST with gbpPost.POST with tiktokPhoto, or VIDEO with tiktokVideo.