--- title: "List social account posts" method: GET path: "/social-account-posts" tags: ["Posts"] --- # List social account posts `GET /social-account-posts` ## Request - Base URL: `https://api.woopsocial.com/v1` - URL: `https://api.woopsocial.com/v1/social-account-posts` - Auth: HTTP bearer Returns standalone social account posts for the API key's organization. Each item includes the content, schedule, delivery status and latest stored analytics for a given social account target. ## Query parameters - `projectId` string[] - `socialAccountId` string[] - `postId` string[] - `platform` SocialPlatform[] - `deliveryStatus` DeliveryStatus[] - `limit` integer - `cursor` string ## Response `200` Social account posts. - ListSocialAccountPostsResponse - `nextCursor` string: Opaque cursor for the next page of results. Omitted when there are no more results. - `socialAccountPosts` SocialAccountPost[], required - union - PinterestPost - `platform` 'PINTEREST', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `link` string: Destination URL to attach to the Pin. - `pinterestBoardId` string, required: Identifier of the board to pin to. - `title` string - InstagramPost - `platform` 'INSTAGRAM', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `cover` PostContentMediaInput - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media). - `type` 'MEDIA_LIBRARY', required - `postType` 'POST' | 'REEL' | 'STORY', required - `trialParams` InstagramTrialParams - `graduationStrategy` 'MANUAL' | 'SS_PERFORMANCE', required: Controls how a Trial Reel graduates to followers. `MANUAL` leaves graduation to the user in Instagram. `SS_PERFORMANCE` lets Instagram graduate the Reel automatically based on its performance. - FacebookPost - `platform` 'FACEBOOK', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `link` string - `locationId` string: Facebook place ID to attach to the post. - `postType` 'TEXT_ONLY' | 'IMAGE' | 'VIDEO' | 'REEL' | 'STORY', required - ThreadsPost - `platform` 'THREADS', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - TikTokPost - `platform` 'TIKTOK', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `allowComment` boolean, required: Whether comments should be allowed for this TikTok post. - `allowDuet` boolean, required: Whether duets should be allowed for this TikTok post. This field applies to `postType=VIDEO`. When `postType=PHOTO`, this field is required by the API contract but is not used by TikTok. - `allowStitch` boolean, required: Whether stitches should be allowed for this TikTok post. This field applies to `postType=VIDEO`. When `postType=PHOTO`, this field is required by the API contract but is not used by TikTok. - `autoAddMusic` boolean, required: Whether TikTok should automatically add music to this post. This field applies to `postType=PHOTO`. When `postType=VIDEO`, this field is required by the API contract but is not used by TikTok. - `cover` PostContentMediaInput - `mediaId` string, required: Media identifier create by calling [`POST /media/upload-sessions`](/api-reference/media/start-media-upload-session) or [`POST /media`](/api-reference/media/upload-media). - `type` 'MEDIA_LIBRARY', required - `isAiGeneratedContent` boolean: Whether the TikTok post contains AI-generated content. This field applies to video posts. - `isBrandedContent` boolean, required: Whether the post should be disclosed as branded content on TikTok. - `isYourBrand` boolean, required: Whether the post should be disclosed as "Your brand" content on TikTok. - `postMode` 'DIRECT_POST' | 'MEDIA_UPLOAD' - `postType` 'VIDEO' | 'PHOTO', required - `privacyLevel` 'PUBLIC_TO_EVERYONE' | 'SELF_ONLY' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR' - YouTubePost - `platform` 'YOUTUBE', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `category` string - `madeForKids` boolean - `privacy` 'public' | 'private' | 'unlisted', required - `tags` string[] - `title` string, required - XPost - `platform` 'X', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - LinkedInPost - `platform` 'LINKEDIN', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `link` string: URL to publish as a LinkedIn link preview card. - LinkedInPagesPost - `platform` 'LINKEDIN_PAGES', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `link` string: URL to publish as a LinkedIn link preview card. - WoopTestPost - `platform` 'WOOPTEST', required: Identifies which social media platform this data structure targets. - `analytics` PostAnalytics, required: Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Unsupported metrics are omitted; unsupported platforms and post types return an empty object. Zero is a recorded value, not missing data. Metrics are collected asynchronously and can have different snapshot dates. Reading posts does not refresh analytics. Arrays allow future snapshot ranges without changing the response shape; date-range queries are not currently supported. - `clicks` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `comments` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `engagementRate` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `impressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `likes` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `reactions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `saves` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `shares` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `uniqueImpressions` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `views` PostAnalyticsSnapshot[] - `collectedAt` string, date-time, required: UTC collection timestamp for this observation. - `date` string, date, required: UTC date of the snapshot, not the day the engagement occurred. - `value` number, double, required: Observed lifetime count, or a ratio for engagementRate. - `content` PostContentItem[], required: Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned. - `media` PostContentMedia[] - `mediaId` string, required: Media identifier from the media library. - `mediaType` 'IMAGE' | 'VIDEO', required - `thumbnailUrl` string, uri, required: Thumbnail or preview URL for the media item. - `type` 'MEDIA_LIBRARY', required - `url` string, uri, required: Canonical media URL. - `text` string: Text content for this thread item. - `createdAt` string, date-time, required: UTC time when the social account post was created. - `deliveryCompletedAt` string, date-time: UTC time when the latest delivery attempt for this social account post completed both for successful (`PUBLISHED`) and unsuccessful (`FAILED`) terminal `deliveryStatus` values. - `deliveryStatus` 'NOT_STARTED' | 'SENDING' | 'PUBLISHED' | 'FAILED', required: Delivery lifecycle status for a post. `NOT_STARTED`: The post exists and is scheduled, but delivery has not started yet. `SENDING`: Delivery is currently in progress. `PUBLISHED`: Delivery completed successfully. `FAILED`: Delivery completed unsuccessfully. - `errorMessage` string - `externalPostId` string - `externalPostUrl` string, uri - `postId` string, required: Parent post identifier. - `projectId` string, required: Project identifier. - `schedule` union, required: When the post should be published. - DraftPostSchedule - `type` 'DRAFT', required - PublishNowPostSchedule - `type` 'PUBLISH_NOW', required - ScheduleForLaterPostSchedule - `scheduledFor` string, date-time, required: UTC time (ISO 8601) when the post should be published. The value must be in the future. - `type` 'SCHEDULE_FOR_LATER', required - `socialAccountId` string, required: Connected social account identifier. - `socialAccountPostId` string, required: Social account post identifier. - `updatedAt` string, date-time, required: UTC time when the social account post was last updated. - `shouldSucceed` boolean: Whether the simulated delivery should succeed or fail. Defaults to `true`. Set to `false` to simulate a delivery failure. ## Other responses - `429`: Too many requests are already in progress for this API key. --- [API](https://skmtc.dev/woopsocial/apis/woopsocial-api.md) · [All operations](https://skmtc.dev/woopsocial/apis/woopsocial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/woopsocial/apis/woopsocial-api/revisions/578a984c20d9?raw)