---
title: "Get Post Analytics"
method: GET
path: "/api/v1/analytics/post"
tags: ["analytics"]
---

# Get Post Analytics

`GET /api/v1/analytics/post`

## Query parameters

- `postId` string, nullable
- `platformType` 'TIKTOK' | 'YOUTUBE' | 'INSTAGRAM' | 'FACEBOOK' | 'THREADS' | 'REDDIT' | 'PINTEREST' | 'MASTODON' | 'LINKEDIN' | 'BLUESKY' | 'GOOGLE_BUSINESS' | 'SNAPCHAT', nullable
- `importedPostId` string, nullable

## Response `200`

200

- object
  - `post` object, nullable, required
    - `id` string, required
    - `teamId` string, required
    - `organizationId` string, nullable
    - `title` string, required
    - `referenceKey` string, nullable
    - `postDate` string, date-time, nullable, required
    - `postedDate` string, date-time, nullable
    - `status` 'DRAFT' | 'SCHEDULED' | 'POSTED' | 'ERROR' | 'DELETED' | 'PROCESSING' | 'REVIEW' | 'RETRYING', required
    - `data` object, required
      - `TWITTER` object, nullable
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `replySettings` 'EVERYONE' | 'FOLLOWING' | 'MENTIONED_USERS' | 'SUBSCRIBERS' | 'VERIFIED', nullable
      - `PINTEREST` object, nullable
        - `text` string, nullable
        - `description` string, nullable
        - `boardName` string, required
        - `uploadIds` string[], nullable
        - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
        - `link` string, nullable — The URL to which the Pin will link to.
        - `altText` string, nullable — The alt text for the image. This is used by screen readers and when the image can't be loaded.
        - `note` string, nullable — A note about the Pin. This is not visible to the public.
        - `dominantColor` string, nullable — The dominant color of the image. This is used to display the image before it's loaded.
      - `FACEBOOK` object, nullable
        - `type` 'POST' | 'REEL' | 'STORY'
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `mediaItems` object[], nullable
          - `uploadId` string, required
          - `altText` string, nullable
        - `link` string, nullable — The URL to which the post will link to. Only available for type POST.
        - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
        - `mediaTitle` string, nullable — Title for video posts (type POST with video only, not REEL or STORY). This is displayed as the video title on Facebook.
        - `nativeScheduleTime` string, date-time, nullable — If passed, instead of publishing immediately, the post will be scheduled for the given date/time directly in Meta scheduler. Local date/time as ISO 8601 string max 30 days in the future.
      - `INSTAGRAM` object, nullable
        - `type` 'POST' | 'REEL' | 'STORY'
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `altText` string, nullable — Alternative text for a single image post.
        - `thumbnailOffset` number, nullable — Choose a frame of the published video as the cover photo in ms
        - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
        - `shareToFeed` boolean, nullable — For Reels only.When true, indicates that the reel can appear in both the Feed and Reels tabs.When false, indicates the reel can only appear in the Reels tab.
        - `collaborators` string[], nullable
        - `autoFitImage` boolean, nullable
        - `autoCropImage` boolean, nullable
        - `tagged` object[], nullable
          - `username` string, required
          - `x` number
          - `y` number
        - `carouselItems` object[], nullable
          - `uploadId` string, required
          - `altText` string, nullable
          - `tagged` object[], nullable
            - `username` string, required
            - `x` number, required
            - `y` number, required
        - `locationId` string, nullable
        - `trialParams` object, nullable — For Reels only. Trial reels are only shared to non-followers.
          - `graduationStrategy` 'MANUAL' | 'SS_PERFORMANCE', required
        - `musicSoundInfo` object, nullable — Information about the Instagram audio asset used for Reels publishing.
          - `musicSoundId` string, required — Use audio_id from Instagram Audio API search endpoint.
          - `musicSoundVolume` integer, nullable — Audio volume (0-100).
          - `videoOriginalSoundVolume` integer, nullable — Background volume of the original video sound (0-100).
      - `THREADS` object, nullable
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `mediaItems` object[], nullable
          - `uploadId` string, required
          - `altText` string, nullable
      - `TIKTOK` object, nullable
        - `type` 'VIDEO' | 'IMAGE'
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
        - `privacy` 'SELF_ONLY' | 'PUBLIC_TO_EVERYONE' | 'MUTUAL_FOLLOW_FRIENDS' | 'FOLLOWER_OF_CREATOR', nullable
        - `photoCoverIndex` integer, nullable
        - `isBrandContent` boolean, nullable — Set to true if the video is a paid partnership to promote a third-party business.
        - `isOrganicBrandContent` boolean, nullable — Set to true if this video is promoting the creator's own business.
        - `disableComments` boolean, nullable — If set to true, other TikTok users will not be allowed to make comments on this post.
        - `disableDuet` boolean, nullable — If set to true, other TikTok users will not be allowed to make Stitches using this post.
        - `disableStitch` boolean, nullable — If set to true, other TikTok users will not be allowed to make Duets using this post.
        - `thumbnailOffset` number, nullable — Choose a frame of the published video as the cover photo in ms
        - `isAiGenerated` boolean, nullable — Set to true if this video is AI generated.
        - `autoAddMusic` boolean, nullable — If set to true, TikTok will automatically add music to the photos.
        - `autoScale` boolean, nullable
        - `uploadToDraft` boolean, nullable — If set to true, upload post as draft.
        - `musicSoundInfo` object, nullable — Information about the commercial sound (track) used for TikTok publishing.
          - `musicSoundId` string, required — Use song_clip_id from CML trending list (full_duration_song_clip or trending_song_clip).
          - `musicSoundVolume` integer, nullable — Commercial sound volume (0-100).
          - `musicSoundStart` integer, nullable — Starting point of the commercial sound in milliseconds.
          - `musicSoundEnd` integer, nullable — Ending point of the commercial sound in milliseconds.
          - `videoOriginalSoundVolume` integer, nullable — Background volume of the original video sound (0-100).
      - `LINKEDIN` object, nullable
        - `text` string, required
        - `uploadIds` string[], nullable
        - `link` string, nullable — Optional URL for LinkedIn article preview post.
        - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
        - `mediaTitle` string, nullable — Title for video or document posts. If not provided for videos, LinkedIn displays the posting date under the video.
        - `privacy` 'CONNECTIONS' | 'PUBLIC' | 'LOGGED_IN' | 'CONTAINER', nullable
        - `hideFromFeed` boolean, nullable — Set to true if the post shouldn't be displayed in the main feed.
        - `disableReshare` boolean, nullable — Set to true if the post is not allowed to be reshared.
      - `YOUTUBE` object, nullable
        - `type` 'VIDEO' | 'SHORT'
        - `uploadIds` string[], nullable
        - `text` string, nullable
        - `description` string, nullable
        - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
        - `privacy` 'PRIVATE' | 'PUBLIC' | 'UNLISTED', nullable
        - `defaultLanguage` string, nullable — BCP-47 language code for the video's title and description, e.g. "en" or "pl".
        - `defaultAudioLanguage` string, nullable — BCP-47 language code for the video's default audio track, e.g. "en" or "pl".
        - `madeForKids` boolean, nullable — Set to true if the video is made for kids.
        - `containsSyntheticMedia` boolean, nullable — Set to true if video contains AI generated content
        - `hasPaidProductPlacement` boolean, nullable — Set to true if video has paid product placement
      - `REDDIT` object, nullable
        - `sr` string, required — Subreddit name. Example: r/subredditName or u/username
        - `text` string, required
        - `description` string, nullable
        - `uploadIds` string[], nullable
        - `link` string, nullable — The URL to which the post will link to.
        - `nsfw` boolean, nullable — Set to true if the post is NSFW.
        - `flairId` string, nullable — Flair ID for the post. Required if the subreddit requires flair selection.
      - `DISCORD` object, nullable
        - `channelId` string, required
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `username` string, nullable — The username to display as the author of the message.
        - `avatarUrl` string, nullable — Avatar url to display as the author of the message.
      - `SLACK` object, nullable
        - `channelId` string, required
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `username` string, nullable — The username to display as the author of the message.
        - `avatarUrl` string, nullable — Avatar url to display as the author of the message.
      - `MASTODON` object, nullable
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `thumbnail` string, nullable — The URL to image uploaded on bundle.social.
        - `privacy` 'PUBLIC' | 'UNLISTED' | 'PRIVATE' | 'DIRECT', nullable
        - `spoiler` string, nullable
      - `BLUESKY` object, nullable
        - `text` string, nullable
        - `uploadIds` string[], nullable
        - `tags` string[], nullable — Extra hashtags (without #), up to 8.
        - `labels` string[], nullable — Self-labels (content warnings) applied to the post.
        - `quoteUri` string — AT-URI of the post to quote (e.g. at://did.../app.bsky.feed.post/<rkey>).
        - `externalUrl` string, uri, nullable — Target URL for the external link card
        - `externalTitle` string, nullable — Card title for the external link card
        - `externalDescription` string, nullable — Card description for the external link card
        - `thumbnail` string, uri, nullable — This should be URL to publicly available image uploaded to bundle.social account.
        - `videoAlt` string, nullable — Alt text for the video embed.
      - `GOOGLE_BUSINESS` object, nullable
        - `text` string, nullable
        - `uploadIds` string[], nullable — IDs of images/videos uploaded to bundle.social.
        - `topicType` 'STANDARD' | 'EVENT' | 'OFFER' | 'ALERT', nullable
        - `languageCode` string, nullable — Language tag like 'en' or 'en-US'.
        - `callToActionType` 'BOOK' | 'ORDER' | 'SHOP' | 'LEARN_MORE' | 'SIGN_UP' | 'CALL', nullable
        - `callToActionUrl` string, nullable
        - `eventTitle` string, nullable
        - `eventStartDate` string, date-time, nullable
        - `eventEndDate` string, date-time, nullable
        - `offerCouponCode` string, nullable
        - `offerRedeemOnlineUrl` string, nullable
        - `offerTermsConditions` string, nullable
        - `alertType` 'COVID_19', nullable — Alert type for ALERT posts.
      - `SNAPCHAT` object, nullable
        - `type` 'STORY' | 'SPOTLIGHT'
        - `uploadIds` string[], nullable
        - `text` string, nullable
        - `description` string, nullable
        - `locale` string, nullable
        - `skipSaveToProfile` boolean, nullable
    - `error` string, nullable
    - `errors` object, nullable
      - `TWITTER` string, nullable
      - `PINTEREST` string, nullable
      - `FACEBOOK` string, nullable
      - `INSTAGRAM` string, nullable
      - `TIKTOK` string, nullable
      - `LINKEDIN` string, nullable
      - `REDDIT` string, nullable
      - `DISCORD` string, nullable
      - `SLACK` string, nullable
      - `YOUTUBE` string, nullable
      - `MASTODON` string, nullable
      - `THREADS` string, nullable
      - `BLUESKY` string, nullable
      - `GOOGLE_BUSINESS` string, nullable
      - `SNAPCHAT` string, nullable
    - `errorsVerbose` object, nullable
      - `TWITTER` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `PINTEREST` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `FACEBOOK` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `INSTAGRAM` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `TIKTOK` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `LINKEDIN` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `REDDIT` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `DISCORD` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `SLACK` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `YOUTUBE` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `MASTODON` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `THREADS` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `BLUESKY` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `GOOGLE_BUSINESS` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
      - `SNAPCHAT` object, nullable
        - `code` string, nullable
        - `errorMessage` string, nullable
        - `isTransient` boolean, nullable
        - `retryability` 'retryable' | 'non_retryable' | 'unknown', nullable
        - `httpStatus` number, nullable
        - `meta` unknown
        - `userFacingMessage` string, nullable
    - `externalData` object, nullable
      - `TWITTER` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
      - `PINTEREST` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
        - `thumbnail` string, nullable
      - `FACEBOOK` object, nullable
        - `id` string, nullable
        - `postId` string, nullable
        - `videoId` string, nullable
        - `permalink` string, nullable
        - `thumbnail` string, nullable
      - `INSTAGRAM` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
        - `thumbnail` string, nullable
      - `TIKTOK` object, nullable
        - `id` string, nullable
        - `shareId` string, nullable
        - `requestId` string, nullable
        - `permalink` string, nullable
        - `status` string, nullable
      - `LINKEDIN` object, nullable
        - `id` string, nullable
        - `activity` string, nullable
        - `permalink` string, nullable
        - `thumbnail` string, nullable
      - `REDDIT` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
        - `subreddit_name` string, nullable
      - `DISCORD` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
        - `channelId` string, nullable
      - `SLACK` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
        - `channelId` string, nullable
      - `YOUTUBE` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
        - `thumbnail` string, nullable
        - `sessionUri` string, nullable — YouTube resumable upload session URI for retry handling
      - `MASTODON` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
        - `thumbnail` string, nullable
      - `THREADS` object, nullable
        - `id` string, nullable
        - `permalink` string, nullable
      - `BLUESKY` object, nullable
        - `id` string, nullable
        - `uri` string, nullable
        - `cid` string, nullable — Content ID of the created record
        - `permalink` string, nullable
        - `did` string, nullable — Author DID (owner of the record)
      - `GOOGLE_BUSINESS` object, nullable
        - `id` string, nullable — Resource name of the Local Post, e.g. 'accounts/{accountId}/locations/{locationId}/localPosts/{postId}'.
        - `permalink` string, nullable — Public link to the post (searchUrl) when available.
      - `SNAPCHAT` object, nullable
        - `id` string, nullable
        - `mediaId` string, nullable
        - `type` 'STORY' | 'SPOTLIGHT', nullable
        - `profileId` string, nullable
        - `sourceUploadId` string, nullable
        - `permalink` string, nullable
        - `status` 'MEDIA_UPLOADED' | 'MEDIA_PROCESSING' | 'PUBLISHED', nullable
    - `retryCount` number, required
    - `createdAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, nullable, required
    - `deletedAt` string, date-time, nullable
  - `profilePost` object
    - `id` string, required
    - `socialAccountId` string, required
    - `postId` string, nullable
    - `externalId` string, nullable
    - `title` string, nullable
    - `description` string, nullable
    - `smallThumbnail` string, nullable
    - `thumbnail` string, nullable
    - `permalink` string, nullable
    - `extraData` unknown
    - `subreddit` string, nullable
    - `publishedAt` string, date-time, nullable
    - `type` 'POST' | 'REEL' | 'STORY' | 'VIDEO' | 'IMAGE', required
    - `internal` boolean, required
    - `importedAt` string, date-time, nullable
    - `externallyDeletedAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, nullable, required
    - `deletedAt` string, date-time, nullable
  - `items` object[], required
    - `id` string, required
    - `profilePostId` string, required
    - `impressions` number, required
    - `impressionsUnique` number, required
    - `views` number, required
    - `viewsUnique` number, required
    - `likes` number, required
    - `dislikes` number, required
    - `comments` number, required
    - `shares` number, required
    - `saves` number, required
    - `raw` unknown
    - `forced` boolean, required
    - `createdAt` string, date-time, nullable, required
    - `updatedAt` string, date-time, nullable, required
    - `deletedAt` string, date-time, nullable

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `429` — 429
- `500` — 500

---

[API](https://skmtc.dev/bundle/apis/bundle-social-api.md) · [All operations](https://skmtc.dev/bundle/apis/bundle-social-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bundle/bundle-social-api/revisions/b773556c2f09/schema)