Metrics Reference

This page lists every metric field that can appear in an analytics snapshot returned by List Top Performing Posts and Get Post Analytics.

Metrics live inside a snapshot's metrics object:

{
  "fetchedAt": "2026-06-11T12:00:00.000Z",
  "metrics": {
    "viewsCount": "18400",
    "likesCount": "920",
    "twitterRetweetsCount": "45"
  }
}

How to read this reference

• Every field is optional. A metric only appears when the platform reports it for that specific post, so most snapshots contain a small subset of the fields below.

• Counts are strings. Count metrics are returned as strings (e.g. "18400") to preserve large integers without precision loss.

• Rates and percentages are numbers. Ratios (0–1) and percentages (0–100) are returned as JSON numbers.

• Breakdown metrics are objects. A breakdown maps each bucket to a count string, e.g. { "like": "13", "haha": "2" }. On the Published page these render as a bar chart with one bar per bucket.

• Per-media metrics are arrays. A few Twitter video metrics are arrays indexed by media position in the post (upload order across the whole thread). Entries are null for media items that are not videos.

Analytics are currently collected for Twitter/X, Instagram, Facebook, Threads, and Bluesky. The LinkedIn, Pinterest, YouTube, and TikTok fields below are part of the API schema but are not populated yet.

---

Common metrics

Reported across platforms whenever the platform exposes them.

Field	Type	Description
viewsCount	string	Views.
impressionsCount	string	Impressions.
reachCount	string	Unique accounts reached.
likesCount	string	Likes.
commentsCount	string	Comments.
repliesCount	string	Replies.
sharesCount	string	Shares.
savesCount	string	Saves / bookmarks.
clicksCount	string	Link or content clicks.
followsCount	string	Follows gained from the post.
playsCount	string	Video / audio plays.
profileVisitsCount	string	Profile visits driven by the post.
profileActivityCount	string	Profile actions driven by the post.
navigationsCount	string	In-post navigation actions (e.g. carousel swipes).
interactionsSum	string	Total interactions.
viewTimeMsSum	string	Total watch time, milliseconds.
watchTimeMsAvg	string	Average watch time, milliseconds.

---

Twitter / X

Post-level metrics.

Field	Type	Description
twitterRetweetsCount	string	Retweets.
twitterQuotesCount	string	Quote tweets.

Per-media video metrics. Each is an array indexed by media position in the post; null entries mark non-video media.

Field	Type	Description
twitterPerMediaVideoViewsCount	(string | null)[]	Video views per media item.
twitterPerMediaVideoPlaybackStartCount	(string | null)[]	Playbacks started per media item.
twitterPerMediaVideoPlayback25Count	(string | null)[]	Playbacks reaching 25% per media item.
twitterPerMediaVideoPlayback50Count	(string | null)[]	Playbacks reaching 50% per media item.
twitterPerMediaVideoPlayback75Count	(string | null)[]	Playbacks reaching 75% per media item.
twitterPerMediaVideoPlaybackCompleteCount	(string | null)[]	Playbacks completed per media item.

---

Bluesky

Post-level metrics.

Field	Type	Description
blueskyRepostsCount	string	Reposts.
blueskyQuotesCount	string	Quote posts.

---

Threads

Post-level metrics.

Field	Type	Description
threadsRepostsCount	string	Reposts.
threadsQuotesCount	string	Quote posts.

---

Facebook

Post-level metrics.

Field	Type	Description
facebookPostMediaViewsCount	string	Media views on the post.
facebookPostMediaViewsUniqueCount	string	Unique media views on the post.
facebookPostReactionsByType	object	Reactions broken down by type (e.g. like, love, haha).

Video and Reels metrics.

Field	Type	Description
facebookBlueReelsPlaysCount	string	Reel plays.
facebookFbReelsReplaysCount	string	Reel replays.
facebookFbReelsTotalPlaysCount	string	Total reel plays (plays plus replays).
facebookPostVideoWatchTimeMsAvg	string	Average video watch time, milliseconds.
facebookPostVideoFollowersCount	string	Followers gained from the video.
facebookPostVideoLikesByReactionType	object	Video likes broken down by reaction type.
facebookPostVideoSocialActionsByType	object	Video social actions broken down by type.
facebookPostVideoViewTimeMsSum	string	Total video view time, milliseconds.
facebookTotalVideoViewsCount	string	Total video views.
facebookTotalVideoViewsUniqueCount	string	Unique video views.
facebookTotalVideoViewsAutoplayedCount	string	Autoplayed video views.
facebookTotalVideoViewsClickedToPlayCount	string	Click-to-play video views.
facebookTotalVideoViewsSoundOnCount	string	Video views with sound on.
facebookTotalVideoCompleteViewsCount	string	Complete video views.
facebookTotalVideoCompleteViewsUniqueCount	string	Unique complete video views.
facebookTotalVideoCompleteViewsAutoplayedCount	string	Autoplayed complete video views.
facebookTotalVideoCompleteViewsClickedToPlayCount	string	Click-to-play complete video views.
facebookTotalVideoCompleteViewsOrganicCount	string	Organic complete video views.
facebookTotalVideoCompleteViewsOrganicUniqueCount	string	Unique organic complete video views.
facebookTotalVideoCompleteViewsPaidCount	string	Paid complete video views.
facebookTotalVideoCompleteViewsPaidUniqueCount	string	Unique paid complete video views.
facebookTotalVideoViews10sCount	string	Video views of at least 10 seconds.
facebookTotalVideoViews10sUniqueCount	string	Unique 10-second video views.
facebookTotalVideoViews10sAutoplayedCount	string	Autoplayed 10-second video views.
facebookTotalVideoViews10sClickedToPlayCount	string	Click-to-play 10-second video views.
facebookTotalVideoViews10sOrganicCount	string	Organic 10-second video views.
facebookTotalVideoViews10sPaidCount	string	Paid 10-second video views.
facebookTotalVideoViews10sSoundOnCount	string	10-second video views with sound on.
facebookTotalVideoViews15sCount	string	Video views of at least 15 seconds.
facebookTotalVideoViews60sExcludesShorterCount	string	Video views of at least 60 seconds (excludes shorter).
facebookTotalVideoWatchTimeMsAvg	string	Average total video watch time, milliseconds.
facebookTotalVideoViewTimeMsSum	string	Total video view time, milliseconds.
facebookTotalVideoViewTimeOrganicMsSum	string	Organic video view time, milliseconds.
facebookTotalVideoViewTimePaidMsSum	string	Paid video view time, milliseconds.
facebookTotalVideoStoriesByActionType	object	Video stories (shares/comments/etc.) broken down by action type.
facebookTotalVideoReactionsByType	object	Video reactions broken down by type.
facebookTotalVideoViewTimeMsByAgeBucketAndGender	object	Video view time broken down by age bucket and gender.
facebookTotalVideoViewTimeMsByRegionId	object	Video view time broken down by region.
facebookTotalVideoViewsByDistributionType	object	Video views broken down by distribution type.

---

LinkedIn

Post-level metrics.

Field	Type	Description
linkedinFirstLevelCommentsCount	string	First-level comments (excludes replies).
linkedinReactionsByType	object	Reactions broken down by type (e.g. like, praise, empathy).

---

Pinterest

Post-level metrics.

Field	Type	Description
pinterestPinClicksCount	string	Pin clicks.
pinterestReactionsCount	string	Reactions.
pinterestVideoP95ViewsCount	string	Video views reaching 95% of the video.
pinterestVideo10sViewsCount	string	Video views of at least 10 seconds.
pinterestVideoMrcViewsCount	string	MRC-standard video views.
pinterestVideoV50WatchTimeMsSum	string	Watch time for views past 50%, milliseconds.
pinterestSaveRate	number	Saves divided by impressions, a 0–1 ratio.

---

YouTube

Post-level metrics.

Field	Type	Description
youtubeDislikesCount	string	Dislikes.
youtubeSubscribersLostCount	string	Subscribers lost from the video.
youtubeVideosAddedToPlaylistsCount	string	Times the video was added to a playlist.
youtubeVideosRemovedFromPlaylistsCount	string	Times the video was removed from a playlist.
youtubeRedViewsCount	string	YouTube Premium (Red) views.
youtubeRedViewTimeMsSum	string	YouTube Premium (Red) watch time, milliseconds.
youtubeEngagedViewsCount	string	Engaged views.
youtubeAverageViewPercentage	number	Average percentage of the video watched, 0–100.
youtubeCardClicksCount	string	Card clicks.
youtubeCardImpressionsCount	string	Card impressions.
youtubeCardClickRate	number	Card clicks divided by impressions, a 0–1 ratio.
youtubeCardTeaserClicksCount	string	Card teaser clicks.
youtubeCardTeaserImpressionsCount	string	Card teaser impressions.
youtubeCardTeaserClickRate	number	Card teaser clicks divided by impressions, a 0–1 ratio.
youtubeAnnotationClicksCount	string	Annotation clicks.
youtubeAnnotationClickableImpressionsCount	string	Clickable annotation impressions.
youtubeAnnotationClosesCount	string	Annotation closes.
youtubeAnnotationClosableImpressionsCount	string	Closable annotation impressions.
youtubeAnnotationImpressionsCount	string	Annotation impressions.
youtubeAnnotationClickThroughRate	number	Annotation click-through rate, a 0–1 ratio.
youtubeAnnotationCloseRate	number	Annotation close rate, a 0–1 ratio.

---

Related

• Analytics — the two endpoints that return these metrics.

• List Top Performing Posts — GET /v2/analytics

• Get Post Analytics — GET /v2/posts/{id}/analytics