For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instagram Insights

Instagram Insights gives you detailed performance data about your Instagram account, posts, stories, and followers. With Coupler.io, you can automatically export this data to Google Sheets, Excel, BigQuery, Looker Studio, or even AI destinations like Claude and ChatGPT — on any schedule you choose.

Why connect to Coupler.io?

  • Automated reporting — Set up once, then let data flow automatically to your spreadsheet or warehouse on a daily, weekly, or monthly schedule.

  • Multiple report types — Access post performance, account overview, follower demographics, story insights, and more without manual exports.

  • No code required — Connect via Instagram's native sign-in and choose your report in seconds.

  • AI-ready — Send Instagram data directly to Claude, ChatGPT, Cursor, Gemini, or Perplexity for analysis and insights.

Prerequisites

  • An Instagram Business or Creator account (not a personal account)

  • Admin or editor access to the Instagram account

  • Permission to manage the account's insights

Quick start

How to connect

1

Sign in to Instagram. Click "Connect" and choose the Instagram account you want to analyze. You'll be taken through Instagram's OAuth flow to authorize Coupler.io to access your account's insights.

2

Select your profile. If your Instagram account has multiple business profiles or sub-accounts, choose which one to analyze.

3

Choose a report type. Pick from 17 different report types — for example, "Post: performance totals" shows all your posts' engagement metrics, while "Profile: followers daily breakdown (last 30 days)" tracks new followers over time.

4

Set date filters (if needed). Some reports require a start and end date. Use the date pickers to define your reporting window. Other reports, like account overview, don't need dates.

5

Choose your destination. Pick where your data goes — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like Claude or ChatGPT.

6

Run the data flow. Click "Run" to pull your Instagram data for the first time. Once this completes successfully, you can schedule the data flow to run automatically.

Available report types

Report
Best for
Requires dates?

Post: performance totals

Analyzing engagement on individual posts

Optional

Profile: account overview

Quick snapshot of followers, reach, impressions

No

Profile: performance insights

Detailed account metrics over a period

Yes

Profile: followers daily breakdown (last 30 days)

Tracking new follower trends

No

Profile: followers demography insights

Understanding your audience by age, gender, location

No

Post: comment details review

Reviewing comments on your posts

Optional

Post: profile interactions breakdown

Seeing how followers interact with your posts

Optional

Story: performance totals (last 24 hours)

Analyzing story engagement

No

Story: navigation by action type (last 24 hours)

Understanding how viewers interact with story links

No

Story: profile interactions breakdown (last 24 hours)

Tracking profile visits from stories

No

Profile: daily reach

Monitoring daily reach trends

Yes

Profile: performance by media type

Comparing posts vs. reels vs. carousels

Yes

Profile: performance by follow type

Seeing metrics for followers vs. non-followers

Yes

Profile: links taps by contact button type

Tracking clicks on email, phone, website buttons

Yes

Profile: reach by media product type and follow type

Advanced breakdown of reach by content and audience type

Yes

Profile: new audience demography insights

Understanding demographics of new followers

No

Instagram Insights data overview

Instagram Insights data is organized by report type, each with its own set of metrics and dimensions. Understanding what each report contains helps you choose the right one for your analysis.

Report types and use cases

Each report type exports different data based on what you're analyzing. Some reports focus on account-level metrics, others on individual posts or stories. The report type you choose determines which columns appear in your export.

Report Type
What it measures
Typical columns

Post: performance totals

Engagement on individual posts

Post ID, caption, publish date, impressions, reaches, likes, comments, shares, saves

Profile: account overview

Current account status snapshot

Followers, following, biography, reach, impressions, profile visits

Profile: performance insights

Account metrics over time

Date, impressions, reach, profile visits, follower growth

Profile: followers daily breakdown

New followers per day (30 days)

Date, new followers, new follower growth percentage

Profile: followers demography

Audience breakdown by location/age/gender

Age group, gender, city, country, audience count

Post: comment details review

Individual comments and metadata

Post ID, comment ID, comment text, commenter, date, sentiment (if available)

Story: performance totals

Story engagement (last 24 hours)

Story ID, publish date, impressions, reaches, replies, profile visits

Story: navigation by action type

How viewers interact with story links

Action type (profile visit, etc.), count

Profile: daily reach

Reach trends over time

Date, reach, reach by followers, reach by non-followers

Common metrics explained

Account metrics

  • Impressions — Total number of times any of your content was on screen (counted once per session).

  • Reach — Total number of unique accounts that saw your content.

  • Profile visits — Number of times someone viewed your profile.

  • Followers — Total count of followers at the time of report.

  • Follower growth — Net change in followers over a period.

Post and story engagement

  • Likes — Total likes on a post or story.

  • Comments — Total comments on a post.

  • Shares — Number of times a post was shared (reposted).

  • Saves — Number of times a post was saved.

  • Replies — Direct replies to stories.

Demographic metrics

  • Age group — Follower age bracket (e.g., 18–24, 25–34).

  • Gender — Follower gender distribution.

  • City/Country — Top geographic locations of your audience.

  • Engaged audience demographics — Breakdown of people who interacted with your content.

  • Reached audience demographics — Breakdown of all people who saw your content.

Use cases by role

Track post and story performance daily to understand what content resonates with your audience. Use "Post: performance totals" to identify top-performing posts, then compare metrics across different content types (reels vs. static posts) with "Profile: performance by media type."

Monitor follower growth trends using "Profile: followers daily breakdown" and understand your audience composition with "Profile: followers demography insights" to refine your content strategy.

Use Append to combine post performance data from multiple accounts into a single sheet for centralized reporting.

Focus on post and story engagement to understand what drives audience interaction. Run "Post: performance totals" weekly to see which posts got the most engagement, then drill into comments with "Post: comment details review" to understand audience sentiment.

Track story performance in real-time with "Story: performance totals (last 24 hours)" to see if current content is working and adjust strategy immediately.

Monitor your follower demographics to better tailor content to your core audience.

Use "Profile: account overview" for monthly brand health snapshots and "Profile: performance insights" to track campaign impact over specific date ranges.

Compare performance across different content types ("Profile: performance by media type") and audience segments ("Profile: performance by follow type") to optimize ad spend and organic strategy.

Join Instagram Insights with Facebook Ads data (if you're running ads) to correlate paid campaigns with organic performance.

Track profile visits ("Profile: account overview") as a proxy for traffic potential, and monitor "Profile: links taps by contact button type" to see how many people are clicking to shop, call, or message you.

Analyze post performance to identify which products or collections generate the most engagement, then prioritize similar content.

Use "Profile: followers demography insights" to understand your customer base and refine your product strategy.

Platform-specific notes

  • Impressions on reels: Instagram's API does not support impressions data for reels in some report types. If a column shows empty values for reel posts, this is a known limitation.

  • Historical data: The Instagram Insights API has some time range restrictions:

    • Stories only include data from the last 24 hours. Older story data is not available.

    • Historical Insights data can be retrieved for up to 2 years back. Data older than 2 years is not available via the API.

    • You can request a maximum of 30 days of data per source in a single import.

  • Follower demographics: "Profile: followers demography insights" only shows aggregate percentages, not individual follower breakdowns.

  • Promoted posts: If you're running ads on your posts, use the "Show promoted posts ad ids in separate rows" option to split organic and paid performance into separate rows.

  • Monthly splits: When splitting data by month in "Profile: performance insights," the 31st day is excluded (only months with 30 or fewer days are split).

  • Data freshness: Most Instagram Insights data updates within 24–48 hours of activity.

Instagram Insights common issues

Connection issues

"Failure to add Instagram source" or connection error during OAuth

This typically happens if:

  • Your account is personal, not a business account. Instagram Insights only works with Business or Creator accounts. Convert your personal account to a Business account in Instagram settings.

  • You don't have admin/editor permissions. If you're trying to connect a business account you don't manage, ask the account owner to grant you admin access or connect using the account owner's credentials.

  • The OAuth flow timed out. Try connecting again. If it keeps timing out, clear your browser cache and try in an incognito/private window.

Instagram authorization keeps failing or asking for permission repeatedly

If Instagram is repeatedly asking for permission or the connection is stuck:

  • Revoke and reconnect: Go to Instagram Settings > Apps and Websites > Active Apps and remove Coupler.io, then reconnect in Coupler.

  • Two-factor authentication: If your Instagram account uses two-factor authentication, you may need to complete the 2FA step during the OAuth flow.

  • Browser cookies: Clear cookies for instagram.com and try again in a fresh browser window.

Missing data

"Profile Insights by day: skipping first date of month" or missing data on the 1st of the month

When using the "Profile: daily reach" or "Profile: performance insights" reports with a date range spanning multiple months, the first day of each month (except the starting month) may be skipped. This is an API limitation.

Workaround: If you need continuous daily data, run separate data flows for each month, or request support to investigate if recent API changes have fixed this.

Empty columns or null values in specific metrics

If columns like "impressions" or "reach" are empty for certain posts:

  • Reels without impressions data: Instagram's API does not provide impressions metrics for reels in all report types. This is a known platform limitation.

  • New posts: Posts published within the last 24 hours may not have complete metrics yet.

  • Low engagement posts: Posts with very few interactions may not populate all metrics.

  • Archived or deleted posts: Data for removed posts is not available.

Check your data preview and compare expected vs. actual column counts.

Data not showing in sheet after successful run

If the data flow runs successfully but no data appears in your destination:

  • Empty date range: You may have selected a date range with no posts, stories, or account activity. Try using a broader date range.

  • Wrong report type: Some report types (like "Story: performance totals") only show data if you posted stories in the specified period. Verify you have content for the report type.

  • Profile with no recent activity: Accounts with no posts or stories in the selected period will return zero rows.

  • Destination mapping issue: In Coupler, check that your destination sheet/table is correctly mapped. For Google Sheets, ensure the sheet name matches and is not protected.

"Request to API has failed" during data flow run

This error can occur for several reasons:

  • Temporary API outage: Wait 5–10 minutes and try again. Check Instagram's status page for platform incidents.

  • Account permissions changed: If someone revoked admin access from the account, reconnect the source by authorizing again.

  • Token expired: Long-running data flows may time out if the request takes too long. Try a shorter date range or different report type.

  • Rate limit hit: See the Rate limits section below.

If the error persists, try running the data flow again with slightly different parameters (e.g., a shorter date range).

Permission errors

"Insufficient permissions" or "Access denied" error

You don't have the required access level to this Instagram account or report type:

  • Verify account type: Only Business and Creator accounts provide Insights. Personal accounts don't have access to this data.

  • Check admin status: You must be an admin or editor of the Instagram business account. Ask the account owner to check your role in Settings > Users and Permissions.

  • Insights eligibility: Some account types or regions may not have access to all report types. If a specific report fails but others work, that report may not be available for your account.

Can't see all business accounts when selecting a profile

Only accounts where you have admin or editor access will appear in the profile selector. If a business account is missing:

  • Check your role: Ask the account owner to verify you're listed as an admin or editor.

  • Multiple business accounts: If you manage many accounts, the list may be paginated. Scroll down or search for the account name.

  • Recently added accounts: It can take a few minutes for a newly added account to appear. Refresh the connection and try again.

Data discrepancies

Numbers in Coupler don't match Instagram app numbers

Small discrepancies between Coupler and the Instagram app are normal due to:

  • Data refresh lag: Instagram's API updates insights within 24–48 hours, while the Instagram app may show real-time or near-real-time data.

  • Timezone differences: Ensure your Coupler data flow and Instagram account are using the same timezone.

  • API limitations: Some metrics (like impressions on reels) are not available via API and will be missing in Coupler.

  • Rounding: The API may round large numbers differently than the app.

For financial or campaign-critical decisions, always verify larger metrics directly in Instagram's native Insights.

Follower counts or reach numbers seem too high or too low

Check the following:

  • Duplicate rows: If you're using "Show promoted posts ad ids in separate rows," paid posts will appear as separate rows. If you're summing, you might double-count.

  • Date range: "Followers daily breakdown" only includes the last 30 days. If you're looking for older data, it's not available.

  • Demographic metrics: Demographic breakdowns (by age, gender, location) are estimates and won't always sum exactly to the total audience.

  • Timezone misalignment: Ensure your date range in Coupler matches the timezone Instagram is using for your account.

Post performance metrics vary between reports

The same post may show different engagement numbers if you use different report types (e.g., "Post: performance totals" vs. "Post: profile interactions breakdown"). This is because:

  • Different reports measure different interactions (engagement vs. profile visits).

  • Some reports include older data, others are recent-only.

  • Profile interactions include profile clicks, while engagement includes likes/comments.

Choose the report type that matches what you're trying to measure.

Rate limits

"Rate limit exceeded" error or throttling during large imports

Instagram's API enforces rate limits. If you're pulling a large amount of data or running many data flows in parallel:

  • Space out your runs: Schedule data flows at different times. Instead of running all at once, stagger them by 15–30 minutes.

  • Use smaller date ranges: Instead of pulling 12 months at once, pull 3–6 months and combine them.

  • Reduce frequency: If you're updating hourly, try daily or every 6 hours instead.

  • Batch accounts: If you have multiple Instagram accounts, don't update all of them simultaneously.

Rate limits typically reset after 1 hour. If an error occurs, wait before retrying.

Data flow gets stuck or times out

Large data exports may exceed Instagram's timeout threshold:

  • Narrow your scope: Reduce the date range, choose a more specific report type, or filter to fewer posts.

  • Split into multiple flows: Instead of one large export covering 12 months, create separate data flows for each quarter.

  • Check destination limits: Very large sheets in Google Sheets (>100k rows) can slow imports. Compress your data range or use BigQuery instead.

Instagram Insights FAQ

What's the difference between "Post: performance totals" and "Post: profile interactions breakdown"?

"Post: performance totals" shows overall engagement (likes, comments, shares, saves, reach, impressions). "Post: profile interactions breakdown" focuses specifically on how many people visited your profile from each post. Use performance totals for general post analysis and profile interactions breakdown if you want to understand which posts drive profile clicks.

Do I need both "Profile: followers daily breakdown" and "Profile: followers demography insights"?

No, they serve different purposes. "Followers daily breakdown (last 30 days)" shows how many new followers you gained each day over the past month (great for trend spotting). "Followers demography insights" shows the age, gender, and location breakdown of your entire follower base (great for understanding audience composition). Use one or both depending on whether you care about trends or demographics.

Why do some columns show empty values for reel posts?

Instagram's API doesn't provide impressions data for reels in certain report types. This is a platform limitation, not an error. If you need reel impressions, check the Instagram app directly or wait for API support to expand.

Can I combine data from multiple Instagram accounts in one sheet?

Yes. Create a separate data flow for each account, export to a different sheet or table, then use Append in Coupler to combine them into a single master sheet. Add a column for account name to identify which account each row comes from.

What does "ms" stand for in metric names?

"ms" typically stands for "milliseconds" in technical contexts, but in Instagram Insights reports, it may refer to a metric abbreviation specific to Instagram's API. Check the Help Center or your data preview to clarify what the column represents.

How far back can I pull Instagram Insights data?

Most Instagram Insights metrics are available for the past 2 years. However, some reports have limitations:

  • Stories only include data from the last 24 hours.

  • Follower daily breakdowns only cover the last 30 days.

  • Some newly released report types may have shorter histories.

For historical data beyond these limits, you'll need to rely on archived exports from the Instagram app.

If I schedule a monthly data flow, will it capture months with fewer than 31 days?

If you schedule on the 31st of each month, months with fewer than 31 days (like February or April) will be skipped. To avoid this, schedule on the 28th or use a date macro that adjusts for month length. Alternatively, run monthly flows manually to ensure every month is captured.

Can I export Instagram Insights directly to an AI tool like Claude or ChatGPT?

Yes. Select Claude, ChatGPT, Cursor, Gemini, Perplexity, or OpenClaw as your destination. Coupler will send your Instagram data directly to the AI, allowing you to ask questions about your performance, generate summaries, or request analysis without manual copy-paste.

Why does my "Split by: Monthly" report skip the 31st of some months?

When splitting profile performance insights by month, the 31st day is excluded to keep month boundaries clean. Only full months with 30 or fewer days are split. If you need the 31st included, disable the split option and manually filter the data in your sheet.

How do I use the "Timeframe" option for follower demographics?

The Timeframe option for "Profile: followers demography insights" lets you choose whether to view demographics for "This month" or "This week." This controls the lookback period for which follower demographics are calculated. Select the option that matches your analysis window.

For more details on available metrics and dimensions, see the Data Overview section. If you're troubleshooting a specific error, check Common Issues.

Last updated

Was this helpful?