Returns aggregated analytics for a folder across every video inside it. By default the numbers cumulate through subfolders (matching the analytics dashboard's folder view); pass include_subfolders=false to limit the rollup to uploads filed directly in this folder. Response includes per-platform breakdown, per-video breakdown (one row per upload with its own summed metrics), and folder-level totals. Use list_folders to look up a folder_id.
Numbers come from the locally-cached analytics (post_analytics), not a live platform fetch.
Dashboard parity note: same caveat as get_workspace_analytics. Instagram, Facebook, and YouTube slices sum cached per-post metrics and may under-report vs. the ShortSync dashboard, which fetches account-level insights live for those three platforms. TikTok match the dashboard exactly. That's why folder totals can differ from the dashboard's own folder view for Instagram, Facebook, and YouTube.
`by_platform` only contains platforms the analytics pipeline actually fetches; other platforms have no metrics, not zero engagement.
`hidden_platforms_no_analytics` lists the unsupported platforms that do have posts in the folder (Telegram, Discord) with the post count, which are excluded from the breakdown. X and Google Business Profile rows show 0 when X has no API key added or for Google Business posts (Google has no per-post stats).
Analytics coverage: per-post analytics exist for YouTube, TikTok, Instagram, Facebook, LinkedIn (Company Pages), Threads, Bluesky, Pinterest (business accounts), Snapchat, Mastodon, Pixelfed, Reddit and Tumblr (Pixelfed, Reddit, Tumblr, Bluesky and Mastodon report no view counts). X has analytics only when the workspace has added its own X API key in Settings > Integrations (X bills each post read to the user's X developer account); without one, X posts come back unavailable with that reason. Google Business Profile has profile-level stats only (no per-post numbers). Telegram and Discord have no analytics at all.
`by_video` still includes every published post regardless of platform. Low numbers on a fetched platform can come from a connection that needs reconnecting; list_platform_connections shows that state.
Freshness: if the workspace's analytics were last synced over an hour ago (or never), this call also starts a background sync and reports it in the response's `sync` field (status `started` or `in_progress`, plus `last_synced_at`). The numbers in that response are from the previous sync; call again in a few minutes for fresh ones. `sync.status` of `free_plan_limit` or `daily_limit` means no sync could run, so the numbers may not be current.