Skip to main content
Publishing

Analytics and reports

Per-post reach and engagement, follower growth, best times to post and white-label PDF reports for clients.

What you get

The Analytics page has four tabs: Overview (publishing activity plus engagement totals), Posts (a sortable table with views, likes, comments, shares, saves and clicks per post and platform), Platforms (engagement by platform and by account) and Followers (a daily follower count per account). The post page shows the same numbers for that post under "Reach & engagement". Analytics need the View analytics permission (owner, admin, content manager and analyst roles).

How the numbers are collected

  • In the background Sociquza asks each platform for the numbers of posts published in the last 30 days: about 1 hour, 6 hours and 24 hours after publishing, then once a day. Requests are spaced per account and back off when a platform is busy. This never delays or blocks publishing.
  • Follower or subscriber counts are recorded once a day per account, so the Followers chart starts the day after an account is connected.
  • Numbers come from the platform itself and can lag a few hours. Use Refresh on a post to ask for new numbers now (at most once every 10 minutes per post).
  • Engagement is likes + comments + shares/reposts + saves. The engagement rate divides it by impressions, reach or views, whichever the platform reports.

Which platforms report metrics

PlatformPost numbersFollowersNotes
XImpressions, likes, replies, reposts + quotes, bookmarksYesUses the permissions already granted when connecting.
InstagramViews, reach, likes, comments, shares, savesYesAccounts connected with Facebook Login need the instagram_manage_insights permission for views, reach and saves; likes and comments work without it.
Facebook PagesReactions, comments, sharesYesViews and reach need the read_insights permission.
ThreadsViews, likes, replies, reposts, quotesNoNeeds the threads_manage_insights permission (Meta app review); reconnect the account after adding it.
YouTubeViews, likes, commentsSubscribersSubscriber counts can be hidden by the channel.
BlueskyLikes, replies, reposts + quotesYesBluesky has no view counts.
MastodonFavourites, replies, boostsYesMastodon has no view counts.
RedditScore, commentsNoNeeds the read scope; accounts connected earlier may need to be reconnected.
PinterestImpressions, saves, clicksYesPinterest only provides analytics for some pin types.
LinkedIn, TikTok and all othersNot availableNoThese platforms do not offer the data through the permissions Sociquza uses, so the app shows "Not available for this platform".

Best time to post

Open an account's posting times (Accounts, "Posting times") and press Suggest times. Sociquza looks at your own posts from the last six months, groups them by weekday and hour (IST) and ranks the slots by average engagement. It needs at least 10 posts with numbers; a slot must have at least 2 posts to count. Press a suggestion to add it, then save.

With less data, the suggestions are general guidance for the platform, clearly labelled "General guidance". They are rules of thumb and are not measured on your audience. The composer shows the same suggestions under the schedule picker; pressing one fills the date and time.

PDF client reports (white label)

Pick one workspace on the Analytics page and press Export report (owners, admins and content managers). The PDF contains the date range, summary numbers, top posts, a platform breakdown and follower growth. The range follows the date range selector (7, 30 or 90 days).

  • Report name: shown instead of the workspace name.
  • Logo: a PNG or JPEG from the media library of that workspace.
  • Accent colour: header bar, cards and chart. Text stays dark, so any colour is readable.
  • Footer text on every page, for example your agency name and contact details.
  • Hide the Sociquza name removes "Generated with Sociquza" from the footer.

Branding is saved per workspace. Text in scripts the PDF fonts cannot show (for example Hindi) is left out of the post list.

API
GET https://plotpostapi.kriva.studio/api/reports/analytics.pdf?application_id=<workspace id>&range=30d
GET/PUT https://plotpostapi.kriva.studio/api/applications/<workspace id>/report-branding

API and MCP

  • GET /api/posts/:id/metrics, POST /api/posts/:id/metrics/refresh
  • GET /api/analytics/posts, /top-posts, /engagement?group=platform|account, /followers, /capabilities (filters: range=7d|30d|90d, application_id, platform, account_id)
  • GET /api/accounts/:id/best-times
  • MCP tools get_post_metrics and get_best_posting_times.

v0.1.2

Analytics and reports | Documentation | Sociquza