> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/social-media/instagram-insights.md).

# Instagram Insights

Export Instagram Insights account, post, and story metrics to Google Sheets, BigQuery, or Claude via Coupler.io with automated scheduling.

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

{% hint style="success" %}
Start with the **Profile: account overview** report to see your Instagram account's basic metrics. It requires no date filters and gives you a quick snapshot of followers, reach, and impressions.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**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.
{% endstep %}

{% step %}
**Select your profile.** If your Instagram account has multiple business profiles or sub-accounts, choose which one to analyze.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**Choose your destination.** Pick where your data goes — Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like Claude or ChatGPT.
{% endstep %}

{% step %}
**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.
{% endstep %}
{% endstepper %}

## 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

{% tabs %}
{% tab title="Social Media Managers" %}
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.
{% endtab %}

{% tab title="Content Creators" %}
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.
{% endtab %}

{% tab title="Brand Marketers" %}
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.
{% endtab %}

{% tab title="E-commerce Owners" %}
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.
{% endtab %}
{% endtabs %}

## 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

<details>

<summary>"Failure to add Instagram source" or connection error during OAuth</summary>

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.

</details>

<details>

<summary>Instagram authorization keeps failing or asking for permission repeatedly</summary>

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.

</details>

### Missing data

<details>

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

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.

</details>

<details>

<summary>Empty columns or null values in specific metrics</summary>

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.

</details>

<details>

<summary>Data not showing in sheet after successful run</summary>

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.

</details>

<details>

<summary>"Request to API has failed" during data flow run</summary>

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).

</details>

### Permission errors

<details>

<summary>"Insufficient permissions" or "Access denied" error</summary>

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.

</details>

<details>

<summary>Can't see all business accounts when selecting a profile</summary>

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.

:information\_source: [Review detailed guide.](https://docs.coupler.io/sources/category/social-media/facebook-page-insights/fix-missing-facebook-pages-or-instagram-profiles.md)

</details>

### Data discrepancies

<details>

<summary>Numbers in Coupler don't match Instagram app numbers</summary>

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.

</details>

<details>

<summary>Follower counts or reach numbers seem too high or too low</summary>

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.

</details>

<details>

<summary>Post performance metrics vary between reports</summary>

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.

</details>

### Rate limits

<details>

<summary>"Rate limit exceeded" error or throttling during large imports</summary>

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.

</details>

<details>

<summary>Data flow gets stuck or times out</summary>

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.

</details>

## Instagram Insights FAQ

<details>

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

"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.

</details>

<details>

<summary>Do I need both "Profile: followers daily breakdown" and "Profile: followers demography insights"?</summary>

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.

</details>

<details>

<summary>Why do some columns show empty values for reel posts?</summary>

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.

</details>

<details>

<summary>Can I combine data from multiple Instagram accounts in one sheet?</summary>

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.

</details>

<details>

<summary>What does "ms" stand for in metric names?</summary>

"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.

</details>

<details>

<summary>How far back can I pull Instagram Insights data?</summary>

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.

</details>

<details>

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

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.

</details>

<details>

<summary>Can I export Instagram Insights directly to an AI tool like Claude or ChatGPT?</summary>

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.

</details>

<details>

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

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.

</details>

<details>

<summary>How do I use the "Timeframe" option for follower demographics?</summary>

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.

</details>

{% hint style="info" %}
For more details on available metrics and dimensions, see the [Data Overview](#instagram-insights-data-overview) section. If you're troubleshooting a specific error, check [Common Issues](#instagram-insights-common-issues).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coupler.io/sources/category/social-media/instagram-insights.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
