Instagram Insights connector for Google Data Studio
Put your community and content in context. Bring available Instagram statistics into your reports: profile, account, posts and audience, from the official API.
Private pilot
Choose your fields
Explore a selection of the connector’s dimensions and metrics.
TextEvery dimension and metric, in one place.
Browse the complete field catalogue implemented in this connector. Availability depends on the account and the combination of fields.
Combine fields within the supported reporting level, permissions, attribution settings, thresholds and content format. This catalogue reflects the implemented code; not every case has been validated with real accounts. Units and aggregation follow each field’s definition. Missing data is not replaced with zeros.
Scroll horizontally to see every column.
| Field | Field category | Type | Levels and datasets | Definition and conditions |
|---|---|---|---|---|
Instagram Account IDaccount_id | Dimension | Text | ProfileAccount insightsPostsReelsStoriesLive broadcastsAudience | Definition and conditionsInstagram Account ID |
Instagram Usernameusername | Dimension | Text | ProfileAccount insightsPostsReelsStoriesLive broadcastsAudience | Definition and conditionsInstagram Username |
Instagram Account Nameaccount_name | Dimension | Text | ProfileAccount insightsPostsReelsStoriesLive broadcastsAudience | Definition and conditionsInstagram Account Name |
Observed At · UTCobserved_at | Dimension | Text | ProfileAccount insightsPostsReelsStoriesLive broadcastsAudience | Definition and conditionsObserved At · UTC |
Date · requested UTC intervaldate | Dimension | Date | Account insights | Definition and conditionsDate · requested UTC interval |
Period Start · UTCperiod_start | Dimension | Text | Account insights | Definition and conditionsPeriod Start · UTC |
Period End · UTCperiod_end | Dimension | Text | Account insights | Definition and conditionsPeriod End · UTC |
Biographybiography | Dimension | Text | Profile | Definition and conditionsBiography |
Websitewebsite | Dimension | Text | Profile | Definition and conditionsWebsite |
Profile Picture URLprofile_picture_url | Dimension | Text | Profile | Definition and conditionsProfile Picture URL |
Followers · current snapshotfollowers_count | Metric | NumberSummation allowed: No | Profile | Definition and conditionsCurrent profile counter, not historical followers. API field: |
Following · current snapshotfollows_count | Metric | NumberSummation allowed: No | Profile | Definition and conditionsCurrent profile counter. API field: |
Media Count · current snapshotmedia_count | Metric | NumberSummation allowed: No | Profile | Definition and conditionsCurrent profile counter. API field: |
viewsviews | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
reachreach | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
accounts engagedaccounts_engaged | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: |
total interactionstotal_interactions | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
likeslikes | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
commentscomments | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
sharesshares | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
savessaves | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
repliesreplies | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: |
repostsreposts | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: |
follows and unfollowsfollows_and_unfollows | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
profile links tapsprofile_links_taps | Metric | NumberSummation allowed: No | Account insights | Definition and conditionsNative account total for the exact requested interval. Unique reach and engaged accounts must not be summed across dates. API field: Breakdown: |
Breakdown Valuebreakdown_value | DimensionConditional | Text | Account insightsPostsReelsStoriesAudience | Definition and conditionsBreakdown Value Requires configuration: |
Breakdown Typebreakdown_type | DimensionConditional | Text | Account insightsPostsReelsStoriesAudience | Definition and conditionsBreakdown Type Requires configuration: |
ageage | DimensionConditional | Text | Audience | Definition and conditionsage Requires configuration: |
gendergender | DimensionConditional | Text | Audience | Definition and conditionsgender Requires configuration: |
citycity | DimensionConditional | Text | Audience | Definition and conditionscity Requires configuration: |
countrycountry | DimensionConditional | Text | Audience | Definition and conditionscountry Requires configuration: |
follow typefollow_type | DimensionConditional | Text | Account insights | Definition and conditionsfollow type Requires configuration: |
contact button typecontact_button_type | DimensionConditional | Text | Account insights | Definition and conditionscontact button type Requires configuration: |
Profile Action Typeaction_type | DimensionConditional | Text | PostsStories | Definition and conditionsProfile Action Type Requires configuration: |
Story Navigation Action Typestory_navigation_action_type | DimensionConditional | Text | Stories | Definition and conditionsStory Navigation Action Type Requires configuration: |
Audience Metricaudience_metric | Dimension | Text | Audience | Definition and conditionsAudience Metric |
Audience Timeframeaudience_timeframe | Dimension | Text | Audience | Definition and conditionsAudience Timeframe |
Audience Count · top reported segmentsaudience_count | Metric | NumberSummation allowed: No | Audience | Definition and conditionsNative demographic segment count. Top 45 only; not a complete census. Privacy thresholds apply. API field: |
media idmedia_id | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsmedia id API field: |
media typemedia_type | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsmedia type API field: |
media product typemedia_product_type | DimensionConditional | Text | PostsReelsStoriesLive broadcastsAccount insights | Definition and conditionsmedia product type API field: Requires configuration: |
captioncaption | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionscaption API field: |
permalinkpermalink | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionspermalink API field: |
media urlmedia_url | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsmedia url API field: |
thumbnail urlthumbnail_url | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsthumbnail url API field: |
timestamptimestamp | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionstimestamp API field: |
shortcodeshortcode | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsshortcode API field: |
Published Date · UTCpublished_date | Dimension | Date | PostsReelsStoriesLive broadcasts | Definition and conditionsPublished Date · UTC |
alt textalt_text | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
video titlevideo_title | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
audio idaudio_id | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
media audio typemedia_audio_type | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
is shared to feedis_shared_to_feed | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
is comment enabledis_comment_enabled | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
is ai generatedis_ai_generated | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
has pollhas_poll | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
has sliderhas_slider | Dimension | Text | PostsReelsStoriesLive broadcasts | Definition and conditionsNative media metadata when available. Boolean metadata is represented as text true/false; absent values remain null. API field: |
Current Live Viewers · snapshotcurrent_live_viewer_count | Metric | NumberSummation allowed: No | Live broadcasts | Definition and conditionsNative current viewers, readable only during a live broadcast. No historic reconstruction. API field: |
comments · media lifetimemedia_comments | Metric | NumberSummation allowed: No | PostsReels | Definition and conditionsNative lifetime media insight; total_* includes eligible promoted/cross-platform interactions. Not a daily value. API field: |
likes · media lifetimemedia_likes | Metric | NumberSummation allowed: No | PostsReels | Definition and conditionsNative lifetime media insight; total_* includes eligible promoted/cross-platform interactions. Not a daily value. API field: |
saved · media lifetimemedia_saved | Metric | NumberSummation allowed: No | PostsReels | Definition and conditionsNative lifetime media insight; total_* includes eligible promoted/cross-platform interactions. Not a daily value. API field: |
total comments · media lifetimemedia_total_comments | Metric | NumberSummation allowed: No | PostsReels | Definition and conditionsNative lifetime media insight; total_* includes eligible promoted/cross-platform interactions. Not a daily value. API field: |
total likes · media lifetimemedia_total_likes | Metric | NumberSummation allowed: No | PostsReels | Definition and conditionsNative lifetime media insight; total_* includes eligible promoted/cross-platform interactions. Not a daily value. API field: |
views · media lifetimemedia_views | Metric | NumberSummation allowed: No | PostsReelsStories | Definition and conditionsNative lifetime insight. Organic vs promoted/cross-platform scope follows the Meta definition. Reach is unique per media, not account reach. API field: |
reach · media lifetimemedia_reach | Metric | NumberSummation allowed: No | PostsReelsStories | Definition and conditionsNative lifetime insight. Organic vs promoted/cross-platform scope follows the Meta definition. Reach is unique per media, not account reach. API field: |
facebook views · media lifetimemedia_facebook_views | Metric | NumberSummation allowed: No | PostsReelsStories | Definition and conditionsNative lifetime insight. Organic vs promoted/cross-platform scope follows the Meta definition. Reach is unique per media, not account reach. API field: |
reposts · media lifetimemedia_reposts | Metric | NumberSummation allowed: No | PostsReelsStories | Definition and conditionsNative lifetime insight. Organic vs promoted/cross-platform scope follows the Meta definition. Reach is unique per media, not account reach. API field: |
shares · media lifetimemedia_shares | Metric | NumberSummation allowed: No | PostsReelsStories | Definition and conditionsNative lifetime insight. Organic vs promoted/cross-platform scope follows the Meta definition. Reach is unique per media, not account reach. API field: |
total interactions · media lifetimemedia_total_interactions | Metric | NumberSummation allowed: No | PostsReelsStories | Definition and conditionsNative lifetime insight. Organic vs promoted/cross-platform scope follows the Meta definition. Reach is unique per media, not account reach. API field: |
total views · media lifetimemedia_total_views | Metric | NumberSummation allowed: No | PostsReelsStories | Definition and conditionsNative lifetime insight. Organic vs promoted/cross-platform scope follows the Meta definition. Reach is unique per media, not account reach. API field: |
follows · media lifetimemedia_follows | Metric | NumberSummation allowed: No | PostsStories | Definition and conditionsNative lifetime insight attributed by Instagram to this media. API field: |
profile visits · media lifetimemedia_profile_visits | Metric | NumberSummation allowed: No | PostsStories | Definition and conditionsNative lifetime insight attributed by Instagram to this media. API field: |
profile activity · media lifetimemedia_profile_activity | Metric | NumberSummation allowed: No | PostsStories | Definition and conditionsNative lifetime insight attributed by Instagram to this media. API field: Breakdown: |
crossposted views · native valuecrossposted_views | Metric | NumberSummation allowed: No | Reels | Definition and conditionsNative Reels lifetime insight. Watch times preserve native API units; skip rate preserves native API units, pending real reconciliation. API field: |
ig reels avg watch time · native time unitsig_reels_avg_watch_time | Metric | NumberSummation allowed: No | Reels | Definition and conditionsNative Reels lifetime insight. Watch times preserve native API units; skip rate preserves native API units, pending real reconciliation. API field: |
ig reels video view total time · native time unitsig_reels_video_view_total_time | Metric | NumberSummation allowed: No | Reels | Definition and conditionsNative Reels lifetime insight. Watch times preserve native API units; skip rate preserves native API units, pending real reconciliation. API field: |
reels skip rate · native valuereels_skip_rate | Metric | NumberSummation allowed: No | Reels | Definition and conditionsNative Reels lifetime insight. Watch times preserve native API units; skip rate preserves native API units, pending real reconciliation. API field: |
link clicks · story lifetimestory_link_clicks | Metric | NumberSummation allowed: No | Stories | Definition and conditionsStory insight available for 24 hours. Replies exclude certain regions including Europe/Japan. Privacy thresholds apply. API field: |
navigation · story lifetimestory_navigation | Metric | NumberSummation allowed: No | Stories | Definition and conditionsStory insight available for 24 hours. Replies exclude certain regions including Europe/Japan. Privacy thresholds apply. API field: Breakdown: |
replies · story lifetimestory_replies | Metric | NumberSummation allowed: No | Stories | Definition and conditionsStory insight available for 24 hours. Replies exclude certain regions including Europe/Japan. Privacy thresholds apply. API field: |
Technical definitions reproduce the original schema wording.
No card needed. No charge to request access.
Understand what connects.
Both connectors use official APIs and keep Meta credentials in our backend. Select compatible fields and build your own tables and charts in Google Data Studio.
| What you analyse | Metrics and fields | Context and limits |
|---|---|---|
| Professional profile | Followers, following and media count | Current counters; they do not reconstruct follower history. |
| Account | Views, reach, interactions and profile links | Daily or period totals. Up to 31 days per query within the latest 90 days. |
| Feed posts | Available reach, views and interactions | Lifetime metrics. Dates select content publication, in UTC. |
| Reels | Available views, interactions and playback metrics | Lifetime metrics; availability depends on the media. |
| Stories | Available reach, views and navigation | A 24-hour window and provider restrictions apply. |
| Live | Current viewers of an active live broadcast | A current reading, not a history of finished broadcasts or a real-time guarantee. |
| Audience | Available age, gender, city and country segments | Top segments, provider-specific windows and privacy thresholds. |
Real profile, account and post reads have been verified in the pilot. Reels and Stories returned empty responses for the tested account; not every metric has been validated in every scenario.
The right connection starts here.
Check the requirements before requesting access. We never ask for your Meta password in our form.
- An Instagram Business or Creator professional account.
- A linked Facebook Page that your user can authorise.
- Read access to the profile, insights and linked Pages.
Google has approved our app’s OAuth verification. Commercial access still requires Meta approvals and final validation for external customers; this is not a listing in Google’s official connector gallery.
What to know about Instagram Insights
More frequently asked questionsCan I connect a personal Instagram account?
No. This connector uses professional Instagram access through Facebook Login. A Business or Creator account linked to a Facebook Page accessible to your user is required.
Does it include Instagram advertising?
This connector reads the professional profile and organic content. Choose Meta Ads for advertising campaigns and spend. The subscriptions are independent.
Do all date fields mean the same thing?
No. Account insights cover a day or period. Post and Reel dates select when content was published, while their metrics are cumulative. Profile and live data are current snapshots. Audience data uses the provider’s supported windows.
Why might data be missing?
Availability varies by format, permissions, region, age and privacy rules. An empty response or null metric does not mean zero. The connector preserves this distinction.
€5/month per connector and account.
Prices exclude VAT. Base: €6.05/month including 21% VAT. Each additional account: €5 + VAT (€6.05 including VAT).
Open up another perspective.
Tell us what you need to analyse. We will review your request for access to the private pilot.
Real data reads verified in the pilot. Commercial launch is being prepared; external approvals are still required. Requesting access does not create a subscription or charge.