Connect Instagram
In the client’s workspace, open Sources, add Instagram and choose the account to sync. If you don’t have access to the account, send the client a connect link where the platform supports one.
Organic social integration
Turn Instagram reach, engagement, and follower growth into governed reporting you can put right next to paid and every other channel.
What you can do with Instagram in Maven
Maven connects Instagram Insights and models organic account and content performance into governed social metrics. Track reach, impressions, profile views, likes, comments, saves, shares, website clicks, accounts engaged, follower count, and net new followers, break results down by account and content type, and watch follower-growth and engagement-rate trends over time. Report Instagram organic beside your Meta and TikTok ad spend so earned and paid social live in one governed view — no screenshots from the app.
What you can measure
Maven keeps Instagram numbers consistent across dashboards, reports, and answers so the team is not debating which spreadsheet is right.
Distinct accounts that engaged.
Additive card clicks when supplied by the platform (currently YouTube).
Comments from connected social account daily metrics
Additive end-screen element clicks when supplied by the platform (currently YouTube).
Follower level at observation time.
Engagement actions from connected social account daily metrics
Likes from connected social account daily metrics
Day-over-day change in follower level at the account grain.
Profile views from connected social account daily metrics
Reach from connected social account daily metrics
Responses/replies on content.
Content saves/bookmarks.
Shares from connected social account daily metrics
Content views from connected social account daily metrics
Additive watch time in minutes when supplied by the platform (currently YouTube).
Clicks through to the website from the profile.
View-weighted average video view duration in seconds from additive watch time and video views
YouTube card clicks; zero for platforms that do not expose this component.
Additive post clicks; for YouTube this is card clicks plus end-screen element clicks
Comments from connected social post performance rows
Published social posts represented in the agent-serving post OBT
Post clicks divided by impressions; for YouTube the conformed impressions field currently uses video views as a proxy rather than native thumbnail impressions
YouTube end-screen element clicks; zero for platforms that do not expose this component.
Post interactions divided by impressions
New followers attributed by the source network to the post.
Impressions from connected social post performance rows
Engagement actions from connected social post performance rows
Likes from connected social post performance rows
Cross-network reaction count, including native likes where the source normalizes them as reactions.
Quoted-post actions reported by the source network.
Unique reach from connected social post performance rows
Reposts, retweets, or reblogs reported by the source network.
Cross-network response or reply count.
Post saves/bookmarks; YouTube maps playlist additions to saves.
Shares from connected social post performance rows
Additive total video watch time in seconds from connected post performance rows
Video views from connected social post performance rows
Unique viewers reported for video-style posts.
Network-reported post views kept distinct from impressions and video views.
Questions you can ask
Maven’s agent answers in plain language with the right metric definitions applied automatically. These are real, verified questions it can run today.
What was total social reach and interactions by platform in the last 30 days?
Show social comments by platform
Show social profile views by platform
Show social website clicks by platform
Show social saves and responses by platform
Show social accounts engaged by platform
How many social followers do we have by platform?
YouTube Shorts and Long Form performance
Connection and sync
You connect Instagram by signing in to it and approving access, so nobody shares a password.
Post-level lifetime metrics for Instagram media (posts, reels, carousels). One row per (account_id, media_id). All engagement metrics are lifetime totals from /{media_id}/insights — the authoritative source after Meta v25 dropped metric_type=time_series for the account-level equivalents.
Fields: media type, caption, permalink, likes, comments, shares, saves, reach, views, total interactions, and 4 more
Daily account-level Instagram metrics. One row per (account_id, date) — account_id added for multi-account workspaces.
Fields: impressions, reach, profile views, followers count, follows, unfollows, email contacts, phone call clicks, website clicks, username, and 13 more
Account-grain weekly metrics with API-deduped reach.
Fields: username, week start date, week end date, reach, views, profile views, website clicks, accounts engaged, total interactions, likes, and 7 more
Flat per-media lifetime metrics. One row per (workspace_id, media_id), overwritten each run with current lifetime totals. No snapshot_date — use this table for current stats.
Fields: created time, media type, caption, permalink, media URL, thumbnail URL, lifetime reach, lifetime views, lifetime likes, lifetime comments, and 3 more
Daily Instagram follower/account snapshots.
Fields: account name, followers count, media count, snapshot date, username
How it works
No SQL or warehouse setup. Connect the source, then build the client’s report by asking Claude or ChatGPT.
In the client’s workspace, open Sources, add Instagram and choose the account to sync. If you don’t have access to the account, send the client a connect link where the platform supports one.
Maven pulls the client’s Instagram data (5 objects) and models it into documented tables. No SQL, warehouse or pipeline setup.
Build the client’s report or deck by asking Claude or ChatGPT through the MCP, set alerts on what matters, and publish to the client’s portal once you approve it.
Works well with
FAQ
Maven exposes 39 governed Instagram metrics, including Social Accounts Engaged, Social Card Clicks, Social Comments, Social End Screen Clicks, Social Followers and Social Interactions — each defined once so it means the same thing in every report.
You can break Instagram metrics down by Account, Metric Date, Metric As Of Date, Metric Scope, Title, Permalink Url, Published Date and Content type, and more.
Yes. Instagram sits in the same client workspace as sources like Facebook Ads, TikTok Ads, Google Analytics 4, Shopify and Klaviyo, so one report or question can use them together.
Maven syncs Instagram automatically: a fast first source pull after connecting, then scheduled refreshes that keep reports current. The last successful sync time is always visible, so you know the source data is fresh before it feeds a trusted reporting workflow.
Yes. Instagram Insights lands in the same governed layer as your Facebook and TikTok ad spend, so you can compare organic reach and engagement against paid results and report earned and paid social side by side in a single dashboard.
Yes. Maven connects to Instagram over its official OAuth flow — no password sharing — stores access tokens encrypted, and pulls read-only reporting data into a governed warehouse you control.
Set up your first client, build their report by asking Claude or ChatGPT, and publish it to their portal.
Nothing is charged unless you subscribe.