Item Object


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.

Properties
channelChannel

Social channel the item is published to, and the account within that channel.


One Of

facebookPostFacebookPost

Facebook post content.


facebookReelFacebookReel

Facebook reel content.


facebookStoryFacebookStory

Facebook story content.


gbpPostGbpPost

Google Business Profile post content.


instagramPostInstagramPost

Instagram post content.


instagramStoryInstagramStory

Instagram story content.


linkedinPostLinkedinPost

LinkedIn post content.


pinterestPostPinterestPost

Pinterest post content.


tiktokPhotoTikTokPhoto

TikTok photo content.


tiktokVideoTikTokVideo

TikTok video content.


twitterPostTwitterPost

X (Twitter) post content.


youtubeShortYouTubeShort

YouTube short content.


youtubeVideoYouTubeVideo

YouTube video content.


draftInfoDraftInfo

Creation and update dates, returned for draft items.


externalboolean

Whether the item is a post created natively on the social channel rather than published through Wix.


idstringRead-onlyformat GUID

Item ID.


insightsSummaryInsightsSummary

Summary of the post's performance on the social channel, such as impressions and interactions.


publicationErrorPublicationErrorDetailsRead-only

Details of why the item failed to publish. Returned only when status is FAILED.


publishedDatestringRead-onlyformat date-time

Date and time the item was published. Returned only after the item is published.


referenceIdstring

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.


schedulingInfoSchedulingInfo

Scheduling info. Set to schedule the item for a future date instead of publishing it immediately.


siteAnalyticsSiteAnalytics

Aggregated analytics for the site, attributed to traffic from this post.


statusstringRead-only

suggestedboolean

Whether the item was generated as an AI suggestion.


typestring
Did this help?