rizamodocs

Analytics

What each number means, which network and format gives it, when Rizamo reads it and how far back.

Rizamo reads the numbers of every post on the accounts you connect, made in Rizamo or anywhere else, and each account's own numbers day by day. Read them with GET /v1/analytics/overview (get_analytics in MCP), GET /v1/analytics/posts, GET /v1/network-posts and GET /v1/analytics/audience.

Post metrics

A post's metrics hold its latest lifetime totals, by the same names on every network.

MetricMeaningAdds up as
reachPeople who saw it, each once. Summed across posts, one person counts once per post. On Facebook, Meta's Viewers: people the post was played or shown to, paid and organic together, which Business Suite shows as Viewers. On Instagram, Meta's estimated reach, which Business Suite no longer shows: its Viewers are counted another way and can differ.Sum
engagementsInteractions with it: Instagram's own total, or the likes, comments and other interactions its network gives, added up.Sum
likesLikes; on Facebook, every reaction.Sum
commentsComments and replies.Sum
sharesShares and sends.Sum
savesTimes people saved it.Sum
clicksClicks on the post, its link or its media.Sum
viewsTimes it was played or shown, replays included. On TikTok, paid views included: TikTok counts organic and paid activity together, Spark Ads too. On YouTube, every start counts, autoplay and hovering included: Shorts' since 31 March 2025, every video's since 24 August 2026.Sum
engaged_viewsYouTube's engaged views: plays past the first frame, or a click or tap to play, the way YouTube counted views before it began counting every start, autoplay and hovering included (Shorts since 31 March 2025, every video since 24 August 2026).Sum
repliesStories: messages sent in reply. On Instagram, 0 for stories made in Europe or Japan: Meta withholds them there.Sum
repostsTimes other profiles reposted it. On Instagram, less the reposts deleted since.Sum
quotesTimes other profiles quoted it in a post of their own.Sum
navigationStories: taps forward, taps back, exits and swipes to the next account.Sum
taps_forwardStories: taps to the next story.Sum
taps_backStories: taps back to the story before.Sum
exitsStories: taps that left the stories.Sum
swipes_forwardStories: swipes on to the next account's stories.Sum
followsAccounts that followed from it. On Facebook, a reel's, as Meta's API counts them, which Business Suite can show differently. On YouTube, subscribers a video brought from its watch page.Sum
profile_visitsVisits to the profile from it.Sum
avg_watch_timeHow long a play of the video lasted, on average. On YouTube, per engaged view, YouTube's own average, not per view.Average, in milliseconds
watch_timeHow long the video was watched, all plays together. On TikTok, TikTok's answers so far come in whole seconds, rounded down, so a post watched under a second in total reads 0. On YouTube, YouTube reports it in whole minutes, 2 to 3 days late, so a video watched under a minute in total reads 0.Sum, in milliseconds

By network and format

The formats of each network that give a metric, and the permission it needs where the login must allow more than analytics.

MetricInstagramFacebookTikTokThreadsYouTube
reachallfeed, reel (read_insights, reel where Meta gives it)allnono
engagementsallfeed, reelallall (threads_manage_insights)no
likesfeed, carousel, reelfeed, reelallall (threads_manage_insights)all
commentsfeed, carousel, reelfeed, reelallall (threads_manage_insights)all
sharesallfeed, reel (reel where Meta gives it)allall (threads_manage_insights)all
savesfeed, carousel, reelnoallnono
clicksnofeed (read_insights)nonono
viewsallfeed, reel (read_insights)allall (threads_manage_insights)all
engaged_viewsnonononoall (where YouTube gives it)
repliesstorynononono
repostsall (where Meta gives it)nonoall (threads_manage_insights)no
quotesnononoall (threads_manage_insights)no
navigationstorynononono
taps_forwardstory (where Meta gives it)nononono
taps_backstory (where Meta gives it)nononono
exitsstory (where Meta gives it)nononono
swipes_forwardstory (where Meta gives it)nononono
followsfeed, carousel, story (where Meta gives it)reel (read_insights, where Meta gives it)all (video.insights)noall
profile_visitsfeed, carousel, story (where Meta gives it)noall (video.insights)nono
avg_watch_timereelreel (read_insights)all (video.insights)noall
watch_timereelreel (read_insights)all (video.insights)noall

Metrics a network no longer gives stay in the old numbers Rizamo read, never mixed with the new ones:

NetworkIts old nameMetricLast givenIts name now
Instagramimpressionsimpressions2025-04-21none
Instagramplaysviews2025-04-21views
Instagramig_reels_aggregated_all_plays_countviews2025-04-21views
Instagramvideo_viewsviews2025-04-21views
Facebookpost_impressionsimpressions2025-11-15none
Facebookpost_impressions_uniquereach2025-11-15post_total_media_view_unique

Each network's own names

What Rizamo reads, by the network's name for it.

Instagram

MetricInstagram's nameFormatsNote
reachreachall
likeslikesfeed, carousel, reel
commentscommentsfeed, carousel, reel
sharessharesall
savessavedfeed, carousel, reel
engagementstotal_interactionsall
viewsviewsall
repliesrepliesstory
navigationnavigationstory
followsfollowsfeed, carousel, storyWhere Meta gives it
profile_visitsprofile_visitsfeed, carousel, storyWhere Meta gives it
repostsrepostsallWhere Meta gives it
avg_watch_timeig_reels_avg_watch_timereel
watch_timeig_reels_video_view_total_timereel
taps_forwardnavigation by tap_forwardstoryWhere Meta gives it
taps_backnavigation by tap_backstoryWhere Meta gives it
exitsnavigation by tap_exitstoryWhere Meta gives it
swipes_forwardnavigation by swipe_forwardstoryWhere Meta gives it
viewsplaysNot given since 2025-04-21
viewsig_reels_aggregated_all_plays_countNot given since 2025-04-21
viewsvideo_viewsNot given since 2025-04-21
impressionsimpressionsNot given since 2025-04-21

Facebook

MetricFacebook's nameFormatsNote
viewspost_media_viewfeedNeeds read_insights
viewsfb_reels_total_playsreelNeeds read_insights
reachpost_total_media_view_uniquefeedNeeds read_insights
reachpost_total_media_view_uniquereelNeeds read_insights. Where Meta gives it
clickspost_clicksfeedNeeds read_insights
avg_watch_timepost_video_avg_time_watchedreelNeeds read_insights
watch_timepost_video_view_timereelNeeds read_insights
followspost_video_followersreelNeeds read_insights. Where Meta gives it
sharespost_video_social_actionsreelWhere Meta gives it
sharessharesfeed
likespost_video_likes_by_reaction_typereelWhere Meta gives it
likesreactionsfeed
likeslikesreel
commentscommentsfeed, reel
engagementsRizamo adds up likes, comments and sharesfeed, reel
reachpost_impressions_uniqueNot given since 2025-11-15
impressionspost_impressionsNot given since 2025-11-15

TikTok

MetricTikTok's nameFormatsNote
viewsvideo_viewsall
reachreachall
likeslikesall
commentscommentsall
sharessharesall
savesfavoritesall
watch_timetotal_time_watchedallNeeds video.insights
avg_watch_timeaverage_time_watchedallNeeds video.insights
followsnew_followersallNeeds video.insights
profile_visitsprofile_viewsallNeeds video.insights
engagementsRizamo adds up likes, comments, shares and savesall

Threads

MetricThreads' nameFormatsNote
viewsviewsallNeeds threads_manage_insights
likeslikesallNeeds threads_manage_insights
commentsrepliesallNeeds threads_manage_insights
repostsrepostsallNeeds threads_manage_insights
quotesquotesallNeeds threads_manage_insights
sharessharesallNeeds threads_manage_insights
engagementsRizamo adds up likes, comments, reposts, quotes and sharesallNeeds threads_manage_insights

YouTube

MetricYouTube's nameFormatsNote
viewsviewCountall
engaged_viewsengagedViewsallWhere YouTube gives it
likeslikeCountall
commentscommentCountall
watch_timeestimatedMinutesWatchedall
avg_watch_timeaverageViewDurationall
sharessharesall
followssubscribersGainedall

Details

What a network says about a post that is not a count: rates in percent, where its views came from, who watched and how long they kept watching. A post's details hold the latest read only, with no history: each part is the last one a read brought, and detailsAt says when each was read, so one older than metricsAt is from an earlier read. A retention curve has at most 100 of the network's own points. They come with the post in GET /v1/network-posts, GET /v1/analytics/posts and MCP's get_network_post; MCP's lists leave out the retention curve and the viewers, which get_network_post has.

DetailMeaningGiven by
skip_rateThe share of views skipped in the first 3 seconds, in percent. On Instagram, Meta estimates it, and marks it as in development.Instagram (reel)
completion_rateThe share of viewers who watched the whole video, in percent.TikTok (video)
avg_view_percentageHow much of the video a view watched on average, in percent. On YouTube, replays count, so a Short can pass 100.YouTube (all)
traffic_sourcesWhere its views came from, as the network gives it: each source's share of the views in percent (percent), or its views (views), never one worked out from the other.TikTok (all), YouTube (all)
viewer_typesNew and returning viewers, followers and non-followers: each type's share of the viewers in percent (percent), or its views (views), as the network gives it.TikTok (all)
retentionHow many viewers were still watching at each point of the video, in percent of those who started: by the second (unit second) or by the share of the video's length from 0 to 1 (unit fraction; YouTube's first point is at 0.01, its last at 1, Facebook's first at 0, where the reel starts). On YouTube, replays count, so a point can pass 100. On Facebook, at is where each equal part of the reel starts, and its value that part's plays as a share of all the reel's plays: a later part can pass an earlier one.Facebook (reel), TikTok (video), YouTube (all)
viewer_demographicsWho watched it, by age, gender, country and city: the groups the network gives, largest first, each as a share in percent (percent, its count 0) or as views (count), as the network gives it, never one worked out from the other. On Facebook, views by age and gender and by country, on reels, given only with data for 100 or more people.Facebook (reel), TikTok (all)

Shares are the network's own, in percent from 0 to 100. Where a network gives counts instead, a list has its views: Rizamo never works a share out of counts, or counts out of a share.

Engagements

  • Instagram: its own total, total_interactions.
  • Facebook: Rizamo adds up likes, comments and shares.
  • TikTok: Rizamo adds up likes, comments, shares and saves.
  • Threads: Rizamo adds up likes, comments, reposts, quotes and shares.
  • YouTube: none.

The engagement rate is engagements per 100 people reached, as each post's own: in a report, of the posts published in the period with their numbers so far, over those whose reach is above 0, whichever attribution. Posts with no reach are left out rather than measured against their views, which count replays: Threads posts and YouTube posts.

Account metrics

What happened on an account each day, as its network counts it. The overview adds the period's days up in accountMetrics. reach and accounts_engaged are each day's people added up, so someone reached on two days counts twice, and they are missing where no account gives them. Each day's are in series[].accountReach and series[].accountsEngaged, and each network's in byNetwork[].accountReach and byNetwork[].accountsEngaged.

MetricMeaningAdds up as
reachPeople who saw the account's content that day, each once. Summed across days, one person counts once per day. On Facebook, Meta's Viewers: people the Page's content was played or shown to, paid and organic together, which Business Suite shows as Viewers. On Instagram, Meta's estimated reach, ads included, which Business Suite no longer shows: its Viewers are counted another way and can differ.Sum
reach_followersPeople reached that day who follow the account, each once.Sum
reach_non_followersPeople reached that day who do not follow the account, each once.Sum
viewsTimes the account's content was played or shown that day, replays included. On TikTok, paid views included: TikTok counts organic and paid activity together. On Threads, Meta's reference calls it the times the profile was viewed; it is Threads Insights' Views, the times the posts were shown.Sum
views_followersViews that day by people who follow the account. On YouTube, by viewers subscribed to the channel when they watched.Sum
views_non_followersViews that day by people who do not follow the account. On YouTube, by viewers not subscribed to the channel when they watched.Sum
views_paidViews that day from ads.Sum
views_organicViews that day not from ads.Sum
views_feedViews that day of feed posts: photos and videos, carousels apart.Sum
views_carouselViews that day of carousels.Sum
views_reelViews that day of reels.Sum
views_storyViews that day of stories.Sum
views_shortViews that day of Shorts.Sum
views_videoViews that day of regular videos: not Shorts, live streams or stories.Sum
views_liveViews that day of live streams.Sum
engagementsInteractions with the account's content that day: the network's own total, or its likes, comments and other interactions added up.Sum
accounts_engagedAccounts that interacted with the content that day, each once.Sum
likesLikes that day; on Facebook, every reaction.Sum
commentsComments that day; on Threads, replies to the profile's posts.Sum
sharesShares and sends that day.Sum
savesTimes the content was saved that day.Sum
repliesReplies to stories that day.Sum
repostsTimes other accounts reposted the content that day.Sum
quotesTimes other profiles quoted the profile's posts that day.Sum
clicksClicks that day on links the profile shared.Sum
profile_visitsViews of the profile or Page that day.Sum
profile_actionsTaps on the profile's buttons that day: address, call, email and text on Instagram; contact details and the call to action on Facebook.Sum
followsAccounts that started following that day. On YouTube, subscribers gained.Sum
unfollowsAccounts that stopped following that day. On YouTube, subscribers lost.Sum
video_viewsVideo plays of 3 seconds or more that day.Sum
watch_timeTime people watched the account's videos that day.Sum, in milliseconds
MetricInstagramFacebookTikTokThreadsYouTube
reachreachpage_total_media_view_uniqueunique_video_viewsnono
reach_followersreach by follow_type (FOLLOWER), where Meta gives itnononono
reach_non_followersreach by follow_type (NON_FOLLOWER), where Meta gives itnononono
viewsviewspage_media_viewvideo_viewsviewsviews
views_followersviews by follow_type or follower_type (FOLLOWER), where Meta gives itpage_media_view by is_from_followers (1), where Meta gives itnonoviews by subscribedStatus (SUBSCRIBED), for some accounts only, where YouTube gives it
views_non_followersviews by follow_type or follower_type (NON_FOLLOWER), where Meta gives itpage_media_view by is_from_followers (0), where Meta gives itnonoviews by subscribedStatus (UNSUBSCRIBED), for some accounts only, where YouTube gives it
views_paidviews by media_product_type (AD), where Meta gives itpage_media_view by is_from_ads (1), where Meta gives itnonono
views_organicnopage_media_view by is_from_ads (0), where Meta gives itnonono
views_feedviews by media_product_type (POST), where Meta gives itnononono
views_carouselviews by media_product_type (CAROUSEL_CONTAINER), where Meta gives itnononono
views_reelviews by media_product_type (REEL), where Meta gives itnononono
views_storyviews by media_product_type (STORY), where Meta gives itnononono
views_shortnonononoviews by creatorContentType (SHORTS), where YouTube gives it
views_videononononoviews by creatorContentType (VIDEO_ON_DEMAND), where YouTube gives it
views_livenonononoviews by creatorContentType (LIVE_STREAM), where YouTube gives it
engagementstotal_interactionspage_post_engagementsnolikes, comments, reposts and quotes added upno
accounts_engagedaccounts_engagednoengaged_audiencenono
likeslikespage_actions_post_reactions_totallikeslikeslikes
commentscommentsnocommentsrepliescomments
sharessharesnosharesnoshares
savessavesnononono
repliesrepliesnononono
repostsrepostsnonorepostsno
quotesnononoquotesno
clicksnononoclicksno
profile_visitsnopage_views_totalprofile_viewsnono
profile_actionsprofile_links_tapspage_total_actionsnonono
followsfollows_and_unfollows by FOLLOWERpage_daily_follows_uniquedaily_new_followersnosubscribersGained
unfollowsfollows_and_unfollows by NON_FOLLOWERpage_daily_unfollows_uniquedaily_lost_followersnosubscribersLost
video_viewsnopage_video_viewsnonono
watch_timenopage_video_view_timenonoestimatedMinutesWatched

Followers are not a metric but each account's count at the end of its day: the overview gives the count on the period's last day and its change.

Views in a report

The overview's views (kpis.views, series and byNetwork) are each account's own views of each day, as its network counts them on its own screen: Business Suite, TikTok Studio and YouTube Studio show the same numbers. They count every post, reel, story and video of any age, and a new account's days go back as far as Rizamo reads them when it is connected, so its chart starts full. An account whose own days give no views, or are not collected yet, counts what its posts gained instead, by the day Rizamo read it. With fields (a campaign) or attribution: publish, views are the posts' own.

A day not in yet has no views: Meta's days are read from 10:00 UTC, TikTok's come 2 days late and YouTube's 3. As many days at the end of the period before are left out of previous, so the period is compared like with like, and notes says which.

Audience

Who follows an account, and who engaged with it this month, by age, gender, country and city, as last read.

NetworkFollowersEngaged this monthOnly for accounts with
Instagramyesyes100 followers or more
Facebooknono
TikTokyesno100 followers or more
Threadsyesno100 followers or more
YouTubenoyes

When the followers are active: activeHours, the account's followers by the hour (0 to 23, in UTC) on the newest day the network gave, the best times to post as data. Given by TikTok (audience_activity, accounts with advanced access or a verified business account, and 100 followers or more); the others have none, and activeHoursGap says why.

When numbers are read

  • Posts: an hour after a post goes out, again at 6 hours, then daily (each midnight UTC) to day 90, then every 30 days.
  • TikTok: its numbers come up to 48 hours late, so its posts are first read at the first midnight UTC at least a day after they go out (24 to 48 hours), then daily.
  • YouTube: its views, likes and comments are read at 1 and 6 hours like any network's; its other numbers come up to 72 hours late, from the read a day after a post goes out.
  • TikTok: stops updating a post's numbers a year after it goes out. Rizamo reads them once more then, and stops.
  • YouTube: after day 90, every 28 days, so a read held back a day or two still checks each post within 30.
  • Stories (Instagram): every 2 hours while live, the last time 23 hours after they go up. Their numbers are final then: metricsFinal says so. Instagram accounts connected through a Facebook Page also get the final numbers Instagram sends after the story ends.
  • Not read: Facebook stories. The network gives no numbers for them.
  • Accounts: daily at 10:00 UTC, reading the newest 3 days again, since networks revise recent days; the audience weekly.
  • New posts (Instagram, Facebook, TikTok and Threads): the newest are listed every hour, and the whole window daily to notice deleted posts. An account with an active comment automation is listed more often.
  • New posts (YouTube): the newest are listed every 12 hours, and the whole window weekly to notice deleted posts. An account with an active comment automation is listed more often.

Each number has the time it was read (metricsAt). A read that fails for a passing reason is tried again, waiting longer each time.

How far back

When an account is connected, Rizamo reads back:

  • Posts (Instagram, Facebook, TikTok and Threads): the posts of the last 12 months, up to 500 from each list (Facebook lists posts and reels apart).
  • Posts (YouTube): the posts of the last 12 months, up to 200 from each list (Facebook lists posts and reels apart).
  • Account days (Instagram, Facebook, Threads and YouTube): the last 365 days.
  • Account days (TikTok): the last 59 days, all the network keeps.

From then on, the new posts and days as above. A post published before its account was connected has one total for the time before Rizamo first read it.

Days and time zones

An account's days are its network's own, and a report matches them to its days by date, whatever its timeZone:

  • Instagram, Facebook, Threads and YouTube: Pacific time (America/Los_Angeles)
  • TikTok: UTC

A period of days ends yesterday, the last complete day in the report's time zone: today is not over, so it is left out. With from and no to, the period ends yesterday too.

A post's numbers go on the day they arrived, in the report's time zone (attribution: received, the default), or on the day the post went out (publish). A TikTok or YouTube post's first numbers, read a day or two after it went out, go on the day it went out. What a post gathered before its account was connected is on no day: it is in the post's totals and in publish, never in what arrived.

The period before is compared with only where Rizamo has all of it: a post's numbers when every account that gives them was connected before it began, an account's own numbers when its days reach back to it, and posts published when Rizamo's lists reached back that far (12 months from when an account was connected, less for an account with more posts than its first list holds). Otherwise previous is missing and notes says why.

Missing and hidden numbers

  • A number a network does not give is missing from the answer, never 0. The overview's notes say why one is missing or partial.
  • Meta hides a number under 5: it is null, listed in masked, and counts as nothing in totals.
  • Where the login did not allow the network's insights, a post has only its public counts:
NetworkPosts needForAccount days need
Facebookread_insightsviews, reach, clicks, avg_watch_time, watch_time and followsread_insights
TikTokvideo.insightswatch_time, avg_watch_time, follows and profile_visitsuser.insights
Threadsthreads_manage_insightsviews, likes, comments, reposts, quotes, shares and engagementsthreads_manage_insights

What each network does not give

  • Instagram: No clicks on its posts and no impressions (since 2025-04-21).
  • Facebook: No saves on its posts, no impressions (since 2025-11-15), no numbers for stories and no audience (Meta's current API gives none for Pages).
  • TikTok: No clicks on its posts. A post's profile visits, and the account's reach, accounts engaged, follows and unfollows, come only for accounts with TikTok's advanced access or verified business accounts: otherwise they are missing, with a note.
  • Threads: No reach, saves or clicks on its posts.
  • YouTube: No reach, engagements, saves or clicks on its posts.

On this page