--- title: "Get post" method: GET path: "/posts/{postId}" tags: ["Posts"] --- # Get post `GET /posts/{postId}` ## Request - Base URL: `https://api.woopsocial.com/v1` - URL: `https://api.woopsocial.com/v1/posts/{postId}` - Auth: HTTP bearer Returns one post with its social account posts inline. ## Path parameters - `postId` string, required ## Response `200` Post found. - Post - `autoDeleteMediaAfterPublish` boolean, required: Whether media auto-delete-after-publish is enabled for this post. - `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 post was created. - `id` string, required: Post identifier. - `projectId` string, required: Project identifier that the selected social accounts belong to. - `retryPolicy` PostRetryPolicy: Automatically creates a scheduled retry post for each failed target. Successful targets are never copied. Known failures requiring user intervention, such as insufficient credits or disconnected accounts, are not automatically retried. If the platform published a post but its response was lost, retrying may produce a duplicate. - `delaySeconds` integer, required: Minimum wait after each failure before the retry is published. - `maxRetries` integer, required: Maximum automatic retries per target, excluding the original attempt. - `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 - `socialAccountPosts` SocialAccountPost[], required: Platform-specific post instances. - 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. - `updatedAt` string, date-time, required: UTC time when the post was last updated. ## Other responses - `404`: Post not found. - `429`: Too many requests are already in progress for this API key. - `500`: Internal server error. --- [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)